Skip to main content
AI
  • Get started with AI

    • Red Hat AI

      Accelerate the development and deployment of enterprise AI solutions.

    • AI learning hub

      Explore learning materials and tools, organized by task.

    • AI interactive demos

      Click through scenarios with Red Hat AI, including training LLMs and more.

    • AI/ML learning paths

      Expand your Red Hat OpenShift AI knowledge using these learning resources.

    • AI quickstarts

      Focused AI use cases designed for fast deployment on Red Hat AI platforms.

    • No-cost AI training

      Foundational Red Hat AI training.

  • Featured resources

    • Red Hat OpenShift AI
    • Open source AI for developers
    • AI product application development
    • Open source-powered AI/ML for hybrid cloud
    • AI and Node.js cheat sheet

Red Hat AI Factory with NVIDIA

Red Hat AI Factory with NVIDIA is a co-engineered, enterprise-grade AI solution for building, deploying, and managing AI at scale across hybrid cloud environments.

Learn
  • Self-guided

    • Documentation

      Find answers, get step-by-step guidance, and learn how to use Red Hat products.

    • Learning paths

      Explore curated walkthroughs for common development tasks.

    • Guided learning

      Receive custom learning paths powered by our AI assistant.

    • See all learning
  • Hands-on

    • Developer Sandbox

      Spin up Red Hat's products and technologies without setup or configuration.

    • Interactive labs

      Learn by doing in these hands-on, browser-based experiences.

    • Interactive demos

      Click through product features in these guided tours.

  • Browse by topic

    • AI/ML
    • Automation
    • Java
    • Kubernetes
    • Linux
    • See all topics
  • Training & certifications

    • Courses and exams
    • Certifications
    • Skills assessments
    • Red Hat Academy
    • Learning subscription
    • Explore training
Build
  • Get started

    • Red Hat build of Podman Desktop

      A downloadable, local development hub to experiment with our products and builds.

    • Developer Sandbox

      Spin up Red Hat's products and technologies without setup or configuration.

  • Download products

    • Red Hat Enterprise Linux
    • Red Hat AI
    • Red Hat OpenShift
    • Red Hat Ansible Automation Platform
    • See all products
  • Featured

    • Red Hat build of OpenJDK
    • Red Hat JBoss Enterprise Application Platform
    • Red Hat OpenShift Dev Spaces
    • Red Hat Developer Toolset
  • References

    • E-books
    • Documentation
    • Cheat sheets
    • Architecture center
Community
  • Get involved

    • Events
    • Live AI events
    • Red Hat Summit
    • Red Hat Accelerators
    • Community discussions
  • Follow along

    • Articles & blogs
    • Developer newsletter
    • Videos
    • Github
  • Get help

    • Customer service
    • Customer support
    • Regional contacts
    • Find a partner

Join the Red Hat Developer program

Download Red Hat products and project builds, access support documentation, learning content, and more.

ConsoleDocsSupport Search
New For you

Recommended

We'll recommend resources you may like as you browse. Try these suggestions for now.

  • Product downloads
  • Cheat sheets
  • Red Hat Developer learning portal
  • Developer blog
  • E-books
  • Developer Sandbox
Log in

Get more with a Red Hat Developer account

  • Product downloads
  • Console access
  • Event registration
  • Training & trials
Explore more account benefitsLog in or register

A subscription may be required for some services.

Contact us

GitOps Promoter: Declare, deploy, deliver

Technology Preview features to help manage GitOps promotions with Red Hat OpenShift GitOps

November 17, 2026
Sho Weimer Gerald Nunn
Related topics:
GitOps
Related products:
Red Hat OpenShift

    GitOps Promoter enables you to effectively manage the promotion of your GitOps manifests between environments. Organizations often relied on continuous integration (CI) tools to manage promotions imperatively, GitOps Promoter simplifies the promotion process by enabling a declarative process.

    Red Hat OpenShift GitOps 1.22 introduces GitOps Promoter and Source Hydrator as Technology Preview features.

    GitOps Promoter overview

    The GitOps Promoter, in cooperation with the Source Hydrator, manages the promotion of environments from a don't-repeat-yourself (DRY) branch to preview branches, <env>-next, to finally the deployed branches <env>.

    The DRY branch contains the manifests you want to deploy and typically uses a YAML management tool like Kustomize or Helm to avoid duplication (hence the DRY moniker). Anytime a commit is made in the DRY branch the Argo CD Source Hydrator automatically hydrates the change simultaneously to the preview branches <env>-next.

    At this point, GitOps Promoter takes over to promote the change from the <env>-next branches to the <env> branches by creating and managing pull requests in the Git repository. Any proposed gating defined in the promotion strategy is applied to each environment and must pass before it moves on to the next environment.

    Figure 1, a diagram from upstream architecture documentation, shows the complete end-to-end process.

    The main branch processes updates through the hydrator to populate the proposed environment branches, which then advance through the promotion pull requests and checks before reaching the live environment branches.
    Figure 1: The main branch processes updates through the hydrator to populate the proposed environment branches, which then advance through the promotion pull requests and checks before reaching the live environment branches.

    Getting started with the GitOps Promoter

    To start using GitOps Promoter, access to the desired source control management (SCM) must be configured, which varies depending on the desired SCM. For example, in GitHub this is done by creating a GitHub App (see upstream documentation on configuring various SCM providers).

    To enable GitOps Promoter in Red Hat OpenShift GitOps, configure the Promoter in the Argo CD Custom Resource (CR). In the Technology Preview of GitOps Promoter, the operator does not create the required certificates automatically. You can use the command below to have Red Hat OpenShift generate a certificate, and this example uses such a certificate:

    apiVersion: argoproj.io/v1beta1
    kind: ArgoCD
    metadata:
      name: openshift-gitops
      namespace: openshift-gitops
    spec:
      ...
      promoter:
        apiserver:
          enabled: true
          tls:
            caSecretKey: tls.key
            caSecretName: argocd-promoter-apiserver-tls
            certSecretName: argocd-promoter-apiserver-tls
        argoCDUIExtensionEnabled: true
        enabled: true
        webhook:
          enabled: true

    Add an annotation with oc:

    oc annotate service argocd-promoter-apiserver service.beta.openshift.io/serving-cert-secret-name=argocd-promoter-apiserver-tls
    

    This example enables the GitOps Promoter extension using argoCDUIExtensionEnabled, which provides a UI in Argo CD. Figure 2 shows the UI during an active promotion:

    The user interface displays environment cards illustrating the promotion flow across development, stage, and production, detailing the health statuses and proposed changes for each deployment.
    Figure 2: The user interface displays environment cards illustrating the promotion flow across development, stage, and production, detailing the health statuses and proposed changes for each deployment.

    The UI also includes a history of promotions showing the last 5 promotions that have occurred, as shown in figure 3:

    The interface displays the promotion history for the project, detailing the commit history and the deployment status across the development, stage, and production environments.
    Figure 3: The interface displays the promotion history for the project, detailing the commit history and the deployment status across the development, stage, and production environments.

    Promotion strategy

    GitOps Promoter uses a PromotionStrategy CR to declaratively define the environments in order of promotion.

    apiVersion: promoter.argoproj.io/v1alpha1
    kind: PromotionStrategy
    metadata:  
      name: petclinic
      namespace: petclinic-argocd
    spec:
      activeCommitStatuses:
      - key: argocd-health-petclinic
      environments:
      - autoMerge: true
        branch: environment/dev
      - autoMerge: true
        branch: environment/stage
      - autoMerge: true
        branch: environment/prod
      gitRepositoryRef:
        name: petclinic

    In this example, there are 3 environments defined (dev, stage and prod) with automatic merging enabled. When automatic merging is enabled the GitOps Promoter automatically merges the pull request once all gating has passed. When a human-in-the-loop is required for change control purposes, disable automatic merging on the required environments.

    Gating

    Gating is an important feature for any promotion system as it ensures that a new release passes all required checks before a promotion occurs. GitOps Promoter supports gating through 2 types of CommitStatus CRs:

    • Proposed: Commit statuses that must be passed before the release is promoted in an environment. Examples of these include linting and validating manifests, image vulnerabilities, and so on.
    • Active: Commit statuses that can only be executed after the release has been deployed in an environment (for example, passing integration testing and health checks in an Argo CD application pass).

    Only a proposed gate directly blocks promotion. An active gate blocks indirectly, because each environment after the first has an automatic proposed promoter-previous-environment gate.

    GitOps Promoter includes a number of commit statuses by default.

    Conclusion

    GitOps Promoter is an important new feature that enables organizations to manage promotions declaratively in an efficient and effective manner. Feedback on this feature during the Tech Preview period would be greatly appreciated, and can help us deliver a robust promotion capability in Red Hat OpenShift GitOps.

    Related Posts

    • Federated multi-cluster Ansible Automation Platform with GitOps

    • What's New in OpenShift GitOps 1.22

    • Declarative clusters: GitOps deployment of hosted control planes on Red Hat OpenShift Virtualization

    • Scaling GitOps: The "pull" architecture for global fleets

    • How to set up your GitOps directory structure

    • GitOps Cookbook: Kubernetes automation in practice

    Recent Posts

    • GitOps Promoter: Declare, deploy, deliver

    • Securing third-party AI agents on Red Hat AI with OpenShell

    • Red Hat Enterprise Linux GitHub hosted runner images now generally available

    • Streamlining Red Hat OpenShift support with the new support log gather operator

    • A day in the life of an NVIDIA H100 on Red Hat OpenShift 5

    What’s up next?

    Getting gitops cover art

    Getting GitOps: A practical platform with OpenShift, Argo CD, and Tekton

    Wanja Pernath
    Red Hat Developers logo

    Platforms

    • Red Hat AI
    • Red Hat Enterprise Linux
    • Red Hat OpenShift
    • Red Hat Ansible Automation Platform
    • See all products

    Build

    • Developer Sandbox
    • Developer tools
    • Interactive tutorials
    • API catalog

    Quicklinks

    • Learning resources
    • E-books
    • Cheat sheets
    • Blog
    • Events
    • Newsletter

    Communicate

    • About us
    • Contact sales
    • Find a partner
    • Report a website issue
    • Site status dashboard
    • Report a security problem

    Red Hat Developer

    Build here. Go anywhere.

    We serve the builders. The problem solvers who create careers with code.

    Join us if you’re a developer, software engineer, web designer, front-end designer, UX designer, computer scientist, architect, tester, product manager, project manager or team lead.

    Sign me up

    Red Hat legal and privacy links

    • About Red Hat
    • Jobs
    • Events
    • Locations
    • Contact Red Hat
    • Red Hat Blog
    • Inclusion at Red Hat
    • Cool Stuff Store
    • Red Hat Summit
    © 2026 Red Hat

    Red Hat legal and privacy links

    • Privacy statement
    • Terms of use
    • All policies and guidelines
    • Digital accessibility
    Ask AI