{"id":41363497,"url":"https://github.com/platform9/decco","last_synced_at":"2026-01-23T08:10:27.016Z","repository":{"id":24281454,"uuid":"101099442","full_name":"platform9/decco","owner":"platform9","description":"Deployment cluster configuration and operations for Kubernetes","archived":false,"fork":false,"pushed_at":"2024-07-22T14:05:05.000Z","size":41327,"stargazers_count":34,"open_issues_count":6,"forks_count":5,"subscribers_count":41,"default_branch":"master","last_synced_at":"2025-08-15T08:22:53.524Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/platform9.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"support/operator/Dockerfile","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-08-22T19:24:01.000Z","updated_at":"2025-07-19T18:05:42.000Z","dependencies_parsed_at":"2024-06-19T00:22:07.031Z","dependency_job_id":"5fdcb35c-4e8c-44a6-a160-37b3a99b3bf7","html_url":"https://github.com/platform9/decco","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/platform9/decco","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/platform9%2Fdecco","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/platform9%2Fdecco/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/platform9%2Fdecco/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/platform9%2Fdecco/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/platform9","download_url":"https://codeload.github.com/platform9/decco/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/platform9%2Fdecco/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28684014,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-23T05:48:07.525Z","status":"ssl_error","status_checked_at":"2026-01-23T05:48:07.129Z","response_time":59,"last_error":"SSL_read: 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":"2026-01-23T08:10:26.455Z","updated_at":"2026-01-23T08:10:27.010Z","avatar_url":"https://github.com/platform9.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Decco\n\nDeployment cluster configuration and operations for Kubernetes.\n\n## Overview\n\nDecco is a lightweight framework that simplifies the deployment,\n network configuration, and security hardening of Internet-facing\n applications in a highly multi-tenant environment.\n \nThe documentation is under construction, but in the meantime,\nthis Kubecon Austin 2017 presentation gives a good overview and\ndemonstration:\n\nhttps://www.youtube.com/watch?v=tFdcrncaxD4\u0026list=PLj6h78yzYM2P-3-xqvmWaZbbI1sW-ulZb\u0026index=32\n\nDecco solves and automates the following problems:\n- Confining applications to well-defined boundaries which could be based on customer or geographical region\n- Exposing applications on the Internet via automatic DNS and LoadBalancer configuration\n- Securing communications using end-to-end TLS and Kubernetes Network Policies.\n- Routing network requests to the correct application endpoints\n- Collecting and aggregating log files\n\n## Developing\nLittering print statements throughout your code in order to debug complicated \nreconcilation loops can become difficult to reason about. With that said, this \nrepo offers at least 1 opinionated way of setting break points for iterative \ndevelopment.\n\n1. Create a file named `kubeconfig` at the root of this repo (same place as the Makefile)\n2. Have [vscode](https://code.visualstudio.com/) installed\n3. Go to the controller you would like to debug and set a breakpoint  \nEx: `pkg/controllers/app_controller.go` --\u003e click to the left of a line number to place a red dot\n4. Run `make operator-debug` to build the operator binary  \n**NOTE:** if you get errors relating to controller-gen, try running `hack/setup_kubebuilder.sh`\n\n5. Click on vscode's Debug tab and click the green button near the top-left  \nThis repo includes a launch.json configured to work with the above steps. \n\n### Go toolchain configuration\n\nBy default, kplane downloads a complete Go toolchain to `./build` and uses \nthis within the Makefile. To ensure that you and the IDE are using, you will \nneed to set the following manually:\n\n```bash\nexport GOROOT=$(pwd)/build/go\nexport PATH=${GOROOT}/bin:$(PATH)\n```\n\nIf you are using an IDE, also update the Go toolchain there too. In Goland, \nupdate the GOROOT in the project settings (`Go \u003e GOROOT`).\n\nAlternatively, you can also disable the use of the Go toolchain in ./build; \njust export an empty GO_TOOLCHAIN:\n\n```bash\nexport GO_TOOLCHAIN=\"\"\n```\n\n## Release Workflow\n\nDecco uses semantic versioning. To release a new version of Decco. \n\n1. (a) If you are releasing a **major** or **minor** version, such as v1.0.0 or \n   v1.3.0, you create a new branch, named `release-x.y`, where `x` and `y` are \n   the major and minor version respectively. Or,\n   (b) if you are releasing a **patch**, such as 1.3.5, you check out the existing \n   branch with the appropriate major and minor version. For example, for 1.3.5\n   check out `release-1.3`.\n\n2. On the release branch, create and push a commit that bumps \n   [VERSION](./VERSION) to your desired version. Do not push this commit to the \n   master branch.\n\n3. If needed, thoroughly test the release branch.\n\n4. Then, run the (Platform9 internal) `decco-release` TeamCity build. This will\n   effectively run the release script: [./hack/ci-release.sh](./hack/ci-release.sh).\n   Alternatively, in a preconfigured environment you could run `make release` \n   instead.   \n\n5. If everything succeeds, the version commit will be tagged, Github release \n   will be created and Docker images will be published for the given version.\n   \nIn case you need to revert a release, you will need to manually delete the git \ntag, the github release, and delete the created Docker images. You will also \nneed to re-tag the previous images to `latest`.   ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplatform9%2Fdecco","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fplatform9%2Fdecco","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplatform9%2Fdecco/lists"}