Skip to content

Latest commit

 

History

History
44 lines (30 loc) · 1.74 KB

File metadata and controls

44 lines (30 loc) · 1.74 KB

Kubecodex Documentation

A GitOps repository structure standard using ArgoCD.

Overview

Kubecodex provides a standardized structure for managing GitOps repositories with ArgoCD. This documentation covers the directory structure, configuration options, and usage patterns.

Directory Structure

  • 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

Project Management Approaches

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.

Quick Start

  1. Set up projects using either CLI or Helm chart approach
  2. Configure applications in the apps/ directory
  3. Add essential applications that should be deployed to all clusters
  4. Manage cluster resources for cluster-wide configurations

Configuration

Learn about config.yaml usage and how to customize application deployments.

Table of Contents