argocd-bootstrap

Bootstrap ArgoCD deployments using the App-of-Apps pattern.

Updated Sep 23, 2025
One-click install
npx skills add https://github.com/Matchpoint-AI/matchpoint-github-runners-helm --skill argocd-bootstrap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: argocd-bootstrap
Source: https://github.com/Matchpoint-AI/matchpoint-github-runners-helm/tree/main/.claude/skills/argocd-bootstrap
Command: npx skills add https://github.com/Matchpoint-AI/matchpoint-github-runners-helm --skill argocd-bootstrap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up ArgoCD to manage a Kubernetes cluster and its applications declaratively can be complex, especially when dealing with multiple application instances and ensuring Git is the single source of truth. This Skill provides a robust "App-of-Apps" pattern for bootstrapping ArgoCD.

Core Features & Use Cases

  • App-of-Apps Pattern: Deploys a root ArgoCD Application that manages other ApplicationSets and Applications, enabling full GitOps.
  • ApplicationSet Generators: Dynamically creates multiple application instances (e.g., runner pools) from a single template.
  • Critical Configuration Alignment: Highlights and fixes the crucial releaseName vs runnerScaleSetName mismatch for GitHub Actions runners.
  • Automated Sync Policies: Configures prune and selfHeal to ensure Kubernetes cluster state always matches Git.
  • Use Case: When deploying a new Kubernetes cluster or expanding your CI/CD capabilities, use this Skill to set up ArgoCD to automatically deploy and manage all GitHub Actions runner pools and other cluster applications directly from your Git repository.

Quick Start

Use the argocd-bootstrap skill to explain how the applicationset-runners.yaml file dynamically creates multiple ArgoCD Applications for GitHub Actions runner pools. Detail the role of generators and templates.

Frequently Asked Questions about argocd-bootstrap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I bootstrap ArgoCD using the App-of-Apps pattern?

The App-of-Apps pattern deploys a root ArgoCD Application that manages other ApplicationSets and Applications, enabling full GitOps control. This approach lets you declare all cluster applications in Git and have ArgoCD automatically sync them, making Git your single source of truth for the entire cluster state.

What is an ApplicationSet and how do I use it to manage multiple application instances?

An ApplicationSet dynamically generates multiple ArgoCD Applications from a single template using generators. This Skill shows how to use ApplicationSets for GitHub Actions runner pools, where one template creates separate applications for each runner pool without manual duplication.

How do I set up automated synchronization and self-healing in ArgoCD?

Configure prune and selfHeal policies in ArgoCD Applications to automatically reconcile cluster state with Git. Prune removes resources deleted from Git, while selfHeal continuously enforces the desired state, ensuring your Kubernetes cluster always matches your repository.

Why does my ArgoCD runner configuration fail to sync correctly?

A critical alignment between releaseName and runnerScaleSetName is required for correct resource tracking. Mismatches cause ApplicationSets to create runner instances that don't track properly, breaking the sync between your Git repository and cluster resources.

Can I use Helm charts with ArgoCD in a GitOps workflow?

Yes, this Skill includes Helm chart installation as part of bootstrap, integrating Helm-based deployments into your GitOps workflow. Applications managed through Helm templates can be declared in Git and synchronized automatically by ArgoCD.

Do I need Terraform to bootstrap ArgoCD?

This Skill supports Terraform-based bootstrap for infrastructure automation, but Terraform is one approach among several. The core ArgoCD setup uses Kubernetes manifests and Helm; Terraform helps automate cluster provisioning and bootstrap orchestration.