https://github.com/argoproj-labs/gitops-promoter
GitOps Environment Promotion tool that lets you focus on the "what," not the "how"
https://github.com/argoproj-labs/gitops-promoter
cd continuous-delivery deployment environment gitops hacktoberfest kubernetes progressive-delivery promotions
Last synced: 27 days ago
JSON representation
GitOps Environment Promotion tool that lets you focus on the "what," not the "how"
- Host: GitHub
- URL: https://github.com/argoproj-labs/gitops-promoter
- Owner: argoproj-labs
- License: apache-2.0
- Created: 2024-04-09T14:10:53.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2026-04-10T12:54:51.000Z (about 1 month ago)
- Last Synced: 2026-04-10T14:30:59.765Z (about 1 month ago)
- Topics: cd, continuous-delivery, deployment, environment, gitops, hacktoberfest, kubernetes, progressive-delivery, promotions
- Language: Go
- Homepage: https://gitops-promoter.readthedocs.io
- Size: 45 MB
- Stars: 435
- Watchers: 11
- Forks: 45
- Open Issues: 87
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Maintainers: MAINTAINERS.md
Awesome Lists containing this project
- awesome-kubernetes-configuration-management - GitOps Promoter
README
---
GitOps Promoter facilitates environment promotion for config managed via GitOps.
[](https://artifacthub.io/packages/helm/gitops-promoter/gitops-promoter)
[](https://codecov.io/gh/argoproj-labs/gitops-promoter)
[](https://scorecard.dev/viewer/?uri=github.com/argoproj-labs/gitops-promoter)
[](https://www.bestpractices.dev/projects/11911)
## Key Features
* Drift-free promotion process
* Robust promotion gating system
* Complete integration with git and SCM tooling
* No fragile automated changes to user-facing files
The main ideas behind the project are explained in ["Space Age GitOps: The Rise of the Humble Pull Request"](https://www.youtube.com/watch?v=p5EPKY3vM-E).
A live demo is presented in ["Space Age GitOps: Lifting off with Argo Promotions"](https://www.youtube.com/watch?v=2JmLCqM1nTM).
The promotion gating system is detailed in ["No More Pipelines: Reconciling Environment Promotion Via Commit Statuses"](https://www.youtube.com/watch?v=Usi38ly1pe0).
## Example
```yaml
apiVersion: promoter.argoproj.io/v1alpha1
kind: PromotionStrategy
metadata:
name: example-promotion-strategy
spec:
gitRepositoryRef:
name: example-git-repo
activeCommitStatuses:
- key: argocd-app-health
proposedCommitStatuses:
- key: security-scan
environments:
- branch: environment/dev
- branch: environment/test
- branch: environment/prod
autoMerge: false
activeCommitStatuses:
- key: performance-test
proposedCommitStatuses:
- key: deployment-freeze
```
## Getting Started
The project is currently experimental, please use with caution. See the
[docs site](https://gitops-promoter.readthedocs.io/en/latest/getting-started/) for setup instructions.
## Contributing
See the **[Contributing](https://gitops-promoter.readthedocs.io/en/latest/contributing/)** page in the documentation.
## Roadmap
Planned features include:
* Support for additional SCMs (such as Bitbucket Server)
* Advanced promotion strategies (such as full DAG support)
* Deployment window commit status support
* Multiple instances per cluster for horizontal scaling, reduced blast radius, etc.
## Users
If you're using GitOps Promoter, please add yourself to [USERS.md](USERS.md)!
If you're evaluating GitOps Promoter, we'd love to hear from you — please [open a discussion](https://github.com/argoproj-labs/gitops-promoter/discussions) to share your feedback.