Getting started with ArgoCD


3 min read

Getting started with ArgoCD

What Is Argo CD?

  • Argo CD is a declarative, GitOps continuous delivery tool for Kubernetes.

  • It follows gitOps principles to deploy your application.

  • It works like an agent installed on your Kubernetes cluster.

  • It works on the pull deployment model.

Push Deployment vs Pull Deployment

  • Push deployment is what you do in your CI/CD pipelines that you define using Jenkins/Github Actions/Gitlab CICD/Circle CI.

  • When you define your CICD pipeline using push deployment what you do is, you add steps to build, test your application and deploy it to Kubernetes.

  • You add your CD steps also in your CICD pipeline and you need to configure secrets and credentials for your k8s cluster, aws/GCP in your pipeline.

  • But if you use pull deployment, you don't need to add your CD steps in your pipeline instead you can use ArgoCD.

  • You just need to install argocd on your kubernetes cluster and create an application using argocd and map it to your github repository(Where you have your kubernetes configuration files).

  • ArgoCD works like an agent installed on your k8s cluster that works on pull deployment, checks your configuration files from your git repo and always match your desired state with actual state.

  • If it finds any difference, it makes changes required to match your desired state with actual state.

  • It provides an amazing UI where you can create, monitor your k8s deployments and configurations.

Why ArgoCD?

Application definitions, configurations, and environments should be declarative and version controlled. Application deployment and lifecycle management should be automated, auditable, and easy to understand.

Steps to get started with ArgoCD

1. Install argocd on your kubernetes cluster.

  • For cluster, you can use minikube cluster for getting started.

  •     kubectl create namespace argocd
        kubectl apply -n argocd -f
  • Now if you check services in argocd namespace, you will see a service (ClusterIP) named argocd-server.

  • To access argocd-server you port-forward your clusterIP service to 8080 port

  •     kubectl port-forward svc/argocd-server -n argocd 8080:443
  • Now you access your argocd server on localhost:8080

  • To login into your argocd server you can use credentials from your kubernetes namespace.

    • Username: admin

    • Password: You can get from a secret in your k8s cluster.

    •     kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d

2. Create application on argocd and map to Git repo

  • Create a application yaml file for argocd application

  •     apiVersion:
        kind: Application
          name: myapp-argo-application
          namespace: argocd
            server: https://kubernetes.default.svc
            namespace: myapp
            targetRevision: HEAD
            path: k8s
          project: default
              - CreateNamespace=true
              selfHeal: true
              prune: true
  • Apply the config file using kubectl

  •     kubectl apply -f application.yml

3. Check application deployment

  • Now just access your argocd server and you can see your application and deployments.

Did you find this article valuable?

Support KubeKode Blogs by becoming a sponsor. Any amount is appreciated!