building-gitops-workflows

# Gitops Workflow Builder This skill provides automated assistance for gitops workflow builder tasks. ## Prerequisites Before using this skill, ensure: - Kubernetes cluster is accessible and kubectl is configured - Git repository is available for GitOps source - ArgoCD or Flux is installed on the cluster (or ready to install) - Appropriate RBAC permissions for GitOps operator - Network connectivity between cluster and Git repository ## Instructions 1. **Select GitOps Tool**: Determine whether to use ArgoCD or Flux based on requirements 2. **Define Application Structure**: Establish repository layout with environment separation (dev/staging/prod) 3. **Generate Manifests**: Create Application/Kustomization files pointing to Git sources 4. **Configure Sync Policy**: Set automated or manual sync with self-heal and prune options 5. **Implement RBAC**: Define service accounts and role bindings for GitOps operator 6. **Set Up Monitoring**: Configure notifications and health checks for deployments 7. **Validate Configuration**: Test sync behavior and verify reconciliation loops ## Output Generates GitOps workflow configurations including: **ArgoCD Application Manifest:** ```yaml apiVersion: argoproj.io/v1alpha1 kind: Application metadata: name: app-name namespace: argocd spec: project: default source: repoURL: https://github.com/org/repo path: manifests/prod targetRevision: main destination: server: https://kubernetes.default.svc namespace: production syncPolicy: automated: prune: true selfHeal: true ``` **Flux Kustomization:** ```yaml apiVersion: kustomize.toolkit.fluxcd.io/v1 kind: Kustomization metadata: name: app-name namespace: flux-system spec: interval: 5m path: ./manifests/prod prune: true sourceRef: kind: GitRepository name: app-repo ``` ## Error Handling Common issues and solutions: **Sync Failures** - Error: "ComparisonError: Failed to load target state" - Solution: Verify Git repository URL, credentials, and target path exist **RBAC Permissions** - Error: "User cannot create resource in API group" - Solution: Grant GitOps service account appropriate cluster roles **Out of Sync State** - Warning: "Application is OutOfSync" - Solution: Enable automated sync or manually sync via UI/CLI **Git Authentication** - Error: "Authentication failed for repository" - Solution: Configure SSH keys or access tokens in {baseDir}/.git/config **Resource Conflicts** - Error: "Resource already exists and is not managed by GitOps" - Solution: Import existing resources or remove conflicting manual deployments ## Resources - ArgoCD documentation: https://argo-cd.readthedocs.io/ - Flux documentation: https://fluxcd.io/docs/ - GitOps principles and patterns guide - Kubernetes manifest best practices - Repository structure templates in {baseDir}/gitops-examples/ ## Overview This skill provides automated assistance for the described functionality. ## Examples Example usage patterns will be demonstrated in context.