A GitOps repository structure standard using ArgoCD.
Kubecodex provides a standardized structure for managing GitOps repositories with ArgoCD. This documentation covers the directory structure, configuration options, and usage patterns.
- apps/ — Cluster and project-specific applications
- essentials/ — Essential applications deployed to all clusters
- projects/ — Argo CD AppProject definitions (CLI or Helm chart approach)
- bootstrap/ — Bootstrap manifests for Argo CD and ApplicationSet resources
- cluster-resources/ — Cluster-wide resources
Kubecodex supports two approaches for project management:
- CLI Approach: Direct YAML management with
./kubecodex project <name> - Helm Chart Approach: Centralized management through Helm values
See Projects Directory for detailed information about both approaches.
- Set up projects using either CLI or Helm chart approach
- Configure applications in the
apps/directory - Add essential applications that should be deployed to all clusters
- Manage cluster resources for cluster-wide configurations
Learn about config.yaml usage and how to customize application deployments.