gitops-workflow

Overview

What is gitops-workflow?

gitops-workflow is a practical skill for implementing GitOps workflows using ArgoCD and Flux, enabling automated, declarative Kubernetes deployments with continuous reconciliation. It is designed for teams and operators who want to manage Kubernetes infrastructure and application delivery through Git-based workflows, following OpenGitOps principles.

Who Should Use This Skill?

• Platform engineers and DevOps teams managing Kubernetes clusters
• Organizations adopting GitOps for infrastructure as code
• Anyone seeking to automate application deployments, manage multi-cluster environments, or enforce declarative infrastructure management

Problems Solved

• Automates Kubernetes deployments directly from Git repositories
• Ensures your cluster state matches your version-controlled desired state
• Supports progressive delivery, multi-cluster management, and secret handling
• Reduces manual intervention and configuration drift

How to Use

Installation Steps

1. Install the skill using the Skills CLI:

   npx skills add https://github.com/wshobson/agents --skill gitops-workflow
   

2. Review the main documentation in SKILL.md for a high-level guide.

3. Explore supporting files:

   • references/argocd-setup.md for detailed ArgoCD installation and configuration
   • references/sync-policies.md for configuring sync policies in ArgoCD and Flux

Setting Up ArgoCD or Flux

• ArgoCD:
  • Create the argocd namespace and apply the official manifests as described in references/argocd-setup.md.
  • Access the ArgoCD UI and configure your Git repositories for deployment automation.
• Flux:
  • Define Kustomization and GitRepository resources to automate sync and deployment intervals.

Repository Structure and Best Practices

• Organize your GitOps repository with clear directories for apps, environments, and policies.
• Store all Kubernetes manifests and configuration as code, using Git for versioning and auditability.
• Use sync policies to automate reconciliation and handle deployment windows or retries.
• Reference the references/sync-policies.md file for YAML examples and advanced configuration.

Adapting to Your Environment

• Customize the provided templates and policies to fit your cluster topology, security requirements, and deployment workflows.
• Integrate with your existing CI/CD pipelines as needed.

FAQ

What does gitops-workflow actually automate?

gitops-workflow automates the deployment and reconciliation of Kubernetes resources by syncing your cluster state with your Git repository using ArgoCD or Flux. It handles continuous delivery, rollback, and drift correction.

Can I use gitops-workflow with both ArgoCD and Flux?

Yes. The skill provides guidance and configuration examples for both ArgoCD and Flux, allowing you to choose the tool that best fits your environment.

Where do I find setup instructions?

Detailed setup steps for ArgoCD are in references/argocd-setup.md. Sync policy examples for both ArgoCD and Flux are in references/sync-policies.md.

Is this skill suitable for production environments?

Yes, gitops-workflow is designed for production use, supporting high availability, secure secret management, and advanced sync policies. Always review and adapt the configurations to your organization's security and operational standards.

How do I troubleshoot issues?

Check the logs of your ArgoCD or Flux controllers, review the sync status in their respective UIs, and consult the provided references for troubleshooting tips. The skill's file tree includes scripts and references to help diagnose common problems.

Where can I see all available files and scripts?

Open the Files tab in your Agent Skills Finder interface to browse the full file tree, including nested references and helper scripts.