{"id":20103003,"url":"https://github.com/stackrox/acs-fleet-manager","last_synced_at":"2026-03-10T22:09:57.748Z","repository":{"id":37081900,"uuid":"478612567","full_name":"stackrox/acs-fleet-manager","owner":"stackrox","description":null,"archived":false,"fork":false,"pushed_at":"2026-03-03T12:13:47.000Z","size":8553,"stargazers_count":13,"open_issues_count":8,"forks_count":17,"subscribers_count":13,"default_branch":"main","last_synced_at":"2026-03-03T14:42:25.576Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stackrox.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-04-06T15:11:11.000Z","updated_at":"2026-03-03T11:48:48.000Z","dependencies_parsed_at":"2023-09-23T14:18:49.945Z","dependency_job_id":"af89063e-81fb-4281-bc62-6344389ea31e","html_url":"https://github.com/stackrox/acs-fleet-manager","commit_stats":{"total_commits":769,"total_committers":28,"mean_commits":"27.464285714285715","dds":0.834850455136541,"last_synced_commit":"cf2f690d95ea4993971dd9c8b77fa094efdd613c"},"previous_names":[],"tags_count":78,"template":false,"template_full_name":null,"purl":"pkg:github/stackrox/acs-fleet-manager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackrox%2Facs-fleet-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackrox%2Facs-fleet-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackrox%2Facs-fleet-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackrox%2Facs-fleet-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stackrox","download_url":"https://codeload.github.com/stackrox/acs-fleet-manager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackrox%2Facs-fleet-manager/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30357622,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T21:41:54.280Z","status":"ssl_error","status_checked_at":"2026-03-10T21:40:59.357Z","response_time":106,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-13T17:34:00.059Z","updated_at":"2026-03-10T22:09:57.742Z","avatar_url":"https://github.com/stackrox.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ACS Fleet Manager\n\nACS fleet-manager repository for the ACS managed service.\n\n\n## Quickstart\n\n### Overview\n\n```\n├── bin                 -- binary output directory  \n├── cmd                 -- cmd entry points\n├── config              -- various fleet-manager configurations\n├── dashboards          -- grafana dashboards\n├── deploy              -- helm charts for application deployment\n├── docs                -- documentation\n├── docker              -- docker images\n├── e2e                 -- e2e tests\n├── fleetshard          -- source code for fleetshard-synchronizer\n├── internal            -- internal source code\n├── openapi             -- openapi specification\n├── pkg                 -- pkg code\n├── scripts             -- development and test scripts\n├── secrets             -- secrets which are mounted to the fleet-manager\n├── templates           -- fleet-manager openshift deployment templates\n└── test                -- test mock servers\n```\n\n### Getting started\n\n#### Prerequisites\n\n* [Golang 1.25+](https://golang.org/dl/)\n* [Docker](https://docs.docker.com/get-docker/) - to create database\n* [ocm cli](https://github.com/openshift-online/ocm-cli/releases) - ocm command line tool\n* [Node.js v12.20+](https://nodejs.org/en/download/) and [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)\n* [Java](https://openjdk.org/) - for openAPI generation\n* IDE with [EditorConfig](https://editorconfig.org/) support enabled:\n  - there is a [plugin for GoLand](https://www.jetbrains.com/help/go/configuring-code-style.html#editorconfig)\n  - there is an [extension for VSCode](https://marketplace.visualstudio.com/items?itemName=EditorConfig.EditorConfig)\n* A running kubernetes cluster\n\n  Guide: [setup-test-environment.md](./docs/development/setup-test-environment.md#prepare-the-environment)\n* Setting up configurations described [here](./docs/development/populating-configuration.md#interacting-with-the-fleet-manager-api)\n\n#### Setup pre-commit\n```shell\n$ make setup/git/hooks\n```\n\n### Test local setup\n```shell\n# build binaries and generate openAPI\n$ make all\n```\n\n#### Supported cluster types:\n\n* Local: Minikube, **Colima** (recommended for macOS), **Kind** (recommended for linux), Rancher Desktop, CRC\n* Remote: Infra OpenShift flavors*, OpenShift CI\n\n\\* For 'OpenShift 4.x' flavor there's a couple of caveats to avoid tls certificate validation errors\n1. Set `trusted-certs-enabled` (\"Should trusted certificates be created\" in UI) parameter to `true` in order to generate trusted TLS certificates.\n2. Use `oc login` instead of the downloaded `KUBECONFIG` file. The issue is tracked in [ROX-25798](https://issues.redhat.com/browse/ROX-25798).\n\n#### Getting started\n\nTo run fleet-manager in different ways (i.e. on a test cluster) please refer to [running-fleet-manager.md](./docs/development/running-fleet-manager.md).\n\n```bash\n# Export the kubeconfig path the central instance should be deployed to\n$ export KUBECONFIG=/your/kubeconfig\n\n# Bootstrap the environment\n$ make deploy/bootstrap\n\n# Sets up database, starts fleet-manager and fleetshard-sync\n$ make deploy/dev\n\n# To create a central instance\n$ ./scripts/create-central.sh\n\n# To interact with the API use\n$ ./scripts/fmcurl\n\n# To build and re-deploy the fleet-manager and fleetshard-sync locally run:\n$ make deploy/dev-fast\n```\n\n#### Common make targets\n\n```shell\n# To generate code and compile binaries run\n$ make all\n\n# To only compile fleet-manager and fleetshard-synchronizer run\n$ make binary\n\n# Run API docs server\n$ make run/docs\n\n# Generate code such as openapi\n$ make generate\n\n# Prepare dev environment for deployment\n$ make deploy/bootstrap\n# Deploy changes to the test cluster [2]\n$ make deploy/dev\n\n# Testing related targets\n$ make test\n$ make test/e2e\n$ make test/integration\n\n# Fleet-manager database related make targets\n$ make db/teardown\n$ make db/setup\n$ make db/migrate\n```\n\n* [1] [git-hooks.md](./docs/development/git-hooks.md)\n* [2] [setup-test-environment.md](./docs/development/setup-test-environment.md)\n\n#### Background\n\nThis project was started from a fleet-manager template with an example \"Dinosaur\" application as a managed service.\n\nAnother fleet manager which was built from the same template [kas-fleet-manager](https://github.com/bf2fc6cc711aee1a0c2a/kas-fleet-manager).\nOriginal [fleet-manager template](https://github.com/bf2fc6cc711aee1a0c2a/ffm-fleet-manager-go-template).\n\nTo contact the people that created this template go to [zulip](https://bf2.zulipchat.com/).\n\n## Additional documentation\n\n- [Adding new endpoint](docs/development/adding-a-new-endpoint.md)\n- [Deploying fleet manager via Service Delivery](docs/legacy/onboarding-with-service-delivery.md)\n- [Data Plane Setup](docs/legacy/data-plane-osd-cluster-options.md)\n- [Access Control](docs/legacy/access-control.md)\n- [Quota Management](docs/quota/quota.md)\n- [Explanation of JWT token claims used across the fleet-manager](docs/auth/jwt-claims.md)\n- [Gitops: configure ACS Central and ACS Operator](docs/development/gitops-configure-central-and-operator.md)\n\n## Contributing\n\nSee the [contributing guide](CONTRIBUTING.md) for general guidelines on how to\ncontribute back to the template.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstackrox%2Facs-fleet-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstackrox%2Facs-fleet-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstackrox%2Facs-fleet-manager/lists"}