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: 3 months 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 (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-07-22T17:59:18.000Z (3 months ago)
• Last Synced: 2025-07-22T19:29:24.663Z (3 months ago)
• Topics: cd, continuous-delivery, deployment, environment, gitops, hacktoberfest, kubernetes, progressive-delivery, promotions
• Language: Go
• Homepage: https://argo-gitops-promoter.readthedocs.io
• Size: 1.88 MB
• Stars: 244
• Watchers: 10
• Forks: 22
• Open Issues: 44
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-repositories - argoproj-labs/gitops-promoter - GitOps Environment Promotion tool that lets you focus on the "what," not the "how" (Go)

README

          
[![codecov](https://codecov.io/gh/argoproj-labs/gitops-promoter/graph/badge.svg?token=Nbye3NDioO)](https://codecov.io/gh/argoproj-labs/gitops-promoter)

# GitOps Promoter

GitOps Promoter facilitates environment promotion for config managed via GitOps.

## 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://argo-gitops-promoter.readthedocs.io/en/latest/getting-started/) for setup instructions.