argocd-commenter

README

argocd-commenter

This is a Kubernetes Controller to add a comment to pull request when Argo CD performs sync operations.

Getting Started

Prerequisite

Argo CD is running in your Kubernetes cluster.

Setup

To deploy the manifest:

kubectl apply -f https://github.com/int128/argocd-commenter/releases/download/v0.3.0/argocd-commenter.yaml

You need to create either Personal Access Token or GitHub App.

• Personal Access Token
  • Belong to a user
  • Share the rate limit in a user
• GitHub App
  • Belong to a user or organization
  • Have each rate limit for an installation

Option 1: Personal Access Token

1. Open https://github.com/settings/tokens
2. Generate a new token
3. Create a secret as follows:

   kubectl -n argocd-commenter-system create secret generic controller-manager \
     --from-literal="GITHUB_TOKEN=$YOUR_PERSONAL_ACCESS_TOKEN"
   

Option 2: GitHub App

1. Create your GitHub App from either link:
   • For a user: https://github.com/settings/apps/new?name=argocd-commenter&url=https://github.com/int128/argocd-commenter&webhook_active=false&contents=read&pull_requests=write
   • For an organization: https://github.com/organizations/:org/settings/apps/new?name=argocd-commenter&url=https://github.com/int128/argocd-commenter&webhook_active=false&contents=read&pull_requests=write (replace :org with your organization)
2. Get the App ID from the setting page
3. Download a private key of the GitHub App
4. Set a custom badge for the GitHub App
   • Logo of Argo CD is available in CNCF Branding
5. Install your GitHub App on your repository or organization
6. Get the Installation ID from the URL, like https://github.com/settings/installations/ID
7. Create a secret as follows:

   kubectl -n argocd-commenter-system create secret generic controller-manager \
     --from-literal="GITHUB_APP_ID=$YOUR_GITHUB_APP_ID" \
     --from-literal="GITHUB_APP_INSTALLATION_ID=$YOUR_GITHUB_APP_INSTALLATION_ID" \
     --from-file="GITHUB_APP_PRIVATE_KEY=/path/to/private-key.pem"
   

Verify setup

Make sure the controller is running.

kubectl -n argocd-commenter-system rollout status deployment argocd-commenter-controller-manager

Contribution

This is an open source software. Feel free to contribute to it.