GitOps in practice, deploy Kubernetes applications with ArgoCD

GitOps in practice, deploy Kubernetes applications with ArgoCD

GitOps is a established of practices to deploy apps applying Git. Application definitions, configurations, and connectivity are to be stored in a version management software package these types of as Git. Git then serves as the single supply of fact for the declarative infrastructure and its hosted purposes.

Working with GitOps means that any change to the deployment must be resolved in a git dedicate. A continuous supply operator then diffs the commit and synchronizes the point out amongst the repository and the qualified environment.

The key gain of GitOps is how every change is versioned and verifiable. Versionning can make it easy to roll again to a previous point out in scenario of problems. Disaster recovery is also simplified. The source of real truth continues to be unchanged and you only need to switch the qualified surroundings.

The report existing how we use ArgoCD to synchronize the state of our Kubernetes clusters. It covers its set up and usages applying a easy instance software hosted on GitHub.

Due to the fact Kubernetes manifests are declarative, it suits correctly the CI/CD sample and most GitOps applications concentrate on Kubernetes.

In exercise

It is a superior follow to isolate your software source code from your deployment state definitions among 2 distinct Git repositories. YAML documents are made use of to describe the Kubernetes cluster, like Deployments, ConfigMap, Secrets, …

The deployment state repository is structured with the structure:

├── foundation
│   ├── deployment.yaml
│   ├── kustomization.yaml
│   └── provider.yaml
├── dev
│   ├── deployment-patch.yaml
│   └── kustomization.yaml
└── prod
    ├── deployment-patch.yaml
    └── kustomization.yaml

Right here we are making use of kustomize for our declarative configuration customization. dev and prod directory defines the condition of our application and shares a prevalent foundation. Dev and Prod can be deployed in the same or diverse Kubernetes clusters according to our requirements.

The normal workflow for a new function in an software making use of GitOPs is as observe:

  1. The code is pushed to the code repository.
  2. The code is built and tested in the CI system.
  3. The code is shipped: a docker picture is designed and pushed to a registry.
  4. The CI pipeline commits and pushes a new edition into to the deployment repository.
  5. This push triggers a synchronization: the new code is routinely deployed to the target infrastructure.

Typical worfklow

Users are free of charge to dedicate to the deployment repository by on their own, for instance they can established the quantity of ReplicaSet of a deployment.


ArgoCD is a GitOps operator that synchronizes the state explained in a Git repository with a deployment in one particular or numerous Kubernetes clusters.

ArgoCD supports multiple format for the declarative definitions (Kustomize, Helm, Ksonnet or basic-YAML).

It is implementend as a Kubernetes controller that screens the Git repository and the live deployment. If for some rationale the are living status deviates from the target (ready for user enter, deployment failed, handbook rollback…), the software is considered OutOfSync.

ArgoCD Set up

A easy ArgoCD set up is simple:

kubectl create namespace argocd
kubectl implement -n argocd -f in.yaml

kubectl -n argocd get secret argocd-original-admin-solution -o jsonpath=".knowledge.password" | foundation64 -d && echo

kubectl patch svc argocd-server -n argocd -p '"spec": "style": "LoadBalancer"'

kubectl port-forward svc/argocd-server -n argocd 8080:443

The next step is to install the argocd-cli command adhering to the formal ArgoCD CLI set up.

Much more documentation on the installation (User Administration, Substantial Availability, Observability …) are available below.

ArgoCD Utilization

Now let us make an ArgoCD app making use of the CLI. It can be performed simply via the World-wide-web UI.

argocd login $myargocd:8443
argocd app generate demo-application-dev --repo --path dev --dest-server https://kubernetes.default.svc --dest-namespace dev

argocd app get demo-app-dev
Name:               demo-application-dev
Task:            default
Server:             https://kubernetes.default.svc
Namespace:          dev
Focus on:             
Path:               dev
SyncWindow:         Sync Permitted
Sync Policy:        Automated
Sync Position:        Synced to  (babc0df)
Health Status:      Nutritious

$ argocd application established demo-app --sync-coverage automobile

Navigating the Web UI, we can see all the objects managed by ArgoCD as very well as their present-day condition:

ArgoCD Web UI


If you are making use of Kubernetes for your deployment and wrestle to be aware of what is deployed on your environments, GitOps is for you. Applying it is no rocket science and can only profit your DevOps compliance.

ArgoCD is a fantastic products. It solves a authentic issue though currently being convenient and straightforward to use.

Leave a Reply