Version Management with ArgoCD

Argo CD is an open-source GitOps Continuous Deployment tool developed for Kubernetes environments. It has an architecture based on the Single Source of Truth model, which is the cornerstone of GitOps, and monitors applications deployed to Kubernetes at certain intervals and compares them with yaml files in the git repository. When it detects any change, it automatically synchronizes.

ArgoCD Installation

Follow the steps below to install ArgoCD on the Kubernetes Cluster.

1. Creating namespace

   Create a namespace for ArgoCD:

   kubectl create namespace argocd
   
2. ArgoCD installation

   Apply ArgoCD manifest files from GitHub repository:

   kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml
   
3. Monitoring pod status

   Monitor the startup of pods:

   watch kubectl get pods -n argocd
   

   
4. Configuring service type

   Configure the service type as NodePort to access the ArgoCD interface:

   kubectl patch svc argocd-server -n argocd -p '{"spec": {"type": "NodePort"}}'
   kubectl get svc argocd-server -n argocd
   

   
5. Accessing interface

   Access the ArgoCD interface using the port address your service exposes externally:

   http://<KUBERNETES_WORKER_IP_ADDRESS>:<PORT>
   

   
6. Getting password

   Decode and display the password encoded in Base64 format:

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

   The default username is admin. You can log in to the ArgoCD interface using this information.

Git Installation and Repository Configuration

Perform Git installation and configure the repository to push deployment files to GitHub.

1. Git installation

   Install the Git package:

   sudo apt update
   sudo apt install git
   git --version
   

   Git may ask you for user information. Configure using the following commands:

   git config --global user.email "[e-mail]"
   git config --global user.name "Your Name"
   
2. Creating GitHub repository

   Create a repository on GitHub to store your deployment files.

3. Configuring remote address

   Add it to the git system as a remote address to be able to add files to the GitHub repository.

   Authentication Error Solution

   If you get an “Authentication failed” error when using git, follow these steps:

   1. Log in to your GitHub account
   2. Click your profile picture in the top right corner and select “Settings”
   3. Go to “Personal access tokens” under “Developer settings” from the left menu
   4. Click “Generate new token” after “Token”
   5. Give necessary permissions
   6. Go to the bottom of the page and click “Generate token”
   7. Copy the token value and save it to a safe place. You cannot view this value again.

   Configure the remote address with the token:

   git remote set-url origin https://<USERNAME>:<ACCESS_TOKEN>@<REPO_ADDRESS>
   

   Example: https://test:[e-mail]/test/test.git

4. Pushing deployment files

   Add the Apinizer Manager deployment yaml file to the git version system and push it to the remote repository:

   git init
   git add apinizer-api-manager-deployment.yaml
   git commit -m "manager add"
   git remote add origin <GITHUB_REPO_ADDRESS>
   git push -u origin master
   

Adding Git Repository to ArgoCD

After adding YAML files to the GitHub repository, you need to add this repository address from the ArgoCD interface.

There are many connection methods. For the HTTPS method, you need to fill in the following fields.

Important

If HTTPS is selected as the connection method, write the token value you created in the previous step in the password section.

Creating ArgoCD Application

You can automate your deployment processes by creating an application on ArgoCD.

1. Determining application name

   Give a name for the application.

2. Sync Policy configuration

   If you want ArgoCD to automatically check for updates in the repository, set the SYNC POLICY option to Automatic.

   When Automatic sync policy is active, ArgoCD checks every 3 minutes on your behalf.

   
3. Automatic namespace creation

   When you need a namespace that has not been created before in your Kubernetes Cluster, ArgoCD creates a namespace in your Kubernetes cluster with the AUTO-CREATE NAMESPACE option.

   

Application Management

ArgoCD visually shows you deployments, replica sets, and pods. You can view real-time log data of pods.

Manual Synchronization: You can manually synchronize a change made in your YAML file by pressing the SYNC button.

Automatic Synchronization: ArgoCD, which automatically detects every change made in YAML files, automates your deploy processes by updating your pods. This way, while your deploy processes occur more efficiently and quickly, you can prevent manual interventions and errors.