Go Apache-2.0

gitops-promoter

GitOps Environment Promotion tool that lets you focus on the "what," not the "how"

A

argoproj-labs

Dernière activité 29 sept. 2026
argoproj-labs/gitops-promoter

764

étoiles

66

forks

150

issues ouvertes

cdcontinuous-deliverydeploymentenvironmentgitopshacktoberfestkubernetesprogressive-deliverypromotions

Ce README est souvent en anglais.

GitOps Promoter

GitOps Promoter facilitates environment promotion for config managed via GitOps.

Artifact Hub codecov OpenSSF Scorecard OpenSSF Best Practices

Animation of the GitOps Promoter dashboard: a change with its deployment and code commits is promoted through development, staging, and production, then the history view shows the promotion timeline and the referenced code commit

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".

A live demo is presented in "Space Age GitOps: Lifting off with Argo Promotions".

The promotion gating system is detailed in "No More Pipelines: Reconciling Environment Promotion Via Commit Statuses".

Example

apiVersion: promoter.argoproj.io/v1alpha1
kind: PromotionStrategy
metadata:
  name: example-promotion-strategy
spec:
  gitRepositoryRef:
    name: example-git-repo
  orderCommitStatusRef:
    group: promoter.argoproj.io
    kind: DependentsSuccessfulCommitStatus
    name: example-promotion-strategy
  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
---
apiVersion: promoter.argoproj.io/v1alpha1
kind: DependentsSuccessfulCommitStatus
metadata:
  name: example-promotion-strategy
spec:
  key: dependents-successful
  promotionStrategyRef:
    name: example-promotion-strategy

Getting Started

The project is currently experimental, please use with caution. See the docs site for setup instructions.

Contributing

See the Contributing page in the documentation.

Roadmap

See the Roadmap in the documentation for planned features.

Users

If you're using GitOps Promoter, please add yourself to USERS.md!

If you're evaluating GitOps Promoter, we'd love to hear from you — please open a discussion to share your feedback.

Projets similaires

Declarative Continuous Deployment for Kubernetes

Goargoargo-cdcd
Aargoproj
24,3 k étoiles7,9 k

Application lifecycle orchestration

Goargocdcddelivery
Aakuity
3,7 k étoiles442

Progressive Delivery for Kubernetes

Goargo-rolloutsargoprojbluegreen
Aargoproj
3,6 k étoiles1,2 k