Skip to content

ArgoCD and GitOps

ArgoCD provides a GitOps workflow and is a declarative continuous delivery tool for Kubernetes/OKD/OpenShift. With everything in git you keep full control of your applications and can roll back deployments easily when mistakes occur. Having your objects in git is also how we expect you to handle restores, see Before you start.

We advise starting out with the console and the command line, and moving to ArgoCD once you are familiar with OKD.

Setting up an application

This is a very basic "getting started with ArgoCD", for more depth, see upstream documentation

For customers with a dedicated ArgoCD instance, you need to create the following resources in your ArgoCD GUI:

  1. Create your own ArgoCD project if desirable. If not, the "default" one will be used.

    Settings → Projects → +NEW PROJECT

  2. Create an ArgoCD application. It is advised to start with a "Manual" sync policy and change it to "Automatic" when you are comfortable with your app/setup.

    Applications → +NEW APP

    Example:

    path: "/metadata/name"
    value: "customer-app"
    
    path: "/spec/project"
    value: "<relevant ArgoCD-project>"
    
    path: "/spec/source/repoURL"
    value: "https://gitrepoURL/backend.git"
    
  3. Add your remote git repository with a token of your remote gitRepo (read_repository and read_registry permissions on your token should suffice)

    Settings → Repositories → +CONNECT REPO → VIA HTTP/HTTPS

    Fill in Project and Repository URL, leave Username empty, and enter Git token into Password. Click Connect.