Setting Up ArgoCD with GitHub Integration

Title: Setting Up ArgoCD with GitHub Integration

Introduction

ArgoCD is a powerful GitOps tool for managing Kubernetes resources directly from your version control system. Integrating ArgoCD with GitHub enables automated synchronization of your cluster’s state with your Git repositories. In this guide, I’ll walk you through setting up ArgoCD CLI, logging into the ArgoCD server, and adding a GitHub repository with authentication.

Step 1: Install the ArgoCD CLI

To interact with your ArgoCD installation, you’ll need the ArgoCD CLI tool. Follow these steps to install it:

Download the ArgoCD CLI for your platform:

curl -sSL -o /usr/local/bin/argocd https://github.com/argoproj/argo-cd/releases/latest/download/argocd-linux-amd64

Make the CLI executable:

chmod +x /usr/local/bin/argocd

Verify the installation:

argocd version

You should see the installed version of the ArgoCD CLI, confirming a successful installation.

Step 2: Log in to the ArgoCD Server

Before adding a GitHub repository, you need to log into the ArgoCD server using the CLI.

• Replace <RETRIEVED_PASSWORD> with the decoded password.
• Use --insecure if you don’t have a valid TLS certificate (not recommended for production).

Find the URL of your ArgoCD server. This could be the external URL configured via Ingress or a NodePort. For example:

Verify login:

https://argocd.prod.example.com

Retrieve the ArgoCD admin password:

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

Log in to the ArgoCD server:

argocd login argocd.prod.example.com --username admin --password <RETRIEVED_PASSWORD> --insecure

Verify login:

bashCopyEdit

argocd account get-user-info

Step 3: Add a GitHub Repository

To enable ArgoCD to sync with your GitHub repository, add the repository to ArgoCD with authentication:

• Replace https://github.com/YourUsername/your-repo-name with the URL of your GitHub repository.
• Replace YourUsername with your GitHub username.
• Replace ghp_your_generated_token with a GitHub personal access token (PAT) that has repo scope.

Add the GitHub repository:

argocd repo add https://github.com/YourUsername/your-repo-name \
    --username YourUsername \
    --password ghp_your_generated_token

Verify the repository is added:

argocd repo list

You should see the repository listed, confirming successful integration.

Step 4: Generate a GitHub Personal Access Token

If you haven’t already generated a GitHub PAT, follow these steps:

1. Go to GitHub Personal Access Tokens.
2. Click Generate new token.
3. Select the necessary scopes:
   • repo: Full control of private repositories (required for private repos).
4. Click Generate token and copy the generated token.

以上資訊GPT整理