make-argocd-fly

✈️ make-argocd-fly

A powerful tool for generating ArgoCD Applications and their rendered Kubernetes resources from Helm, Kustomize, and Jinja2 — across multiple environments, at scale.

🔧 What It Does

make-argocd-fly lets you:

• Render Helm charts and Kustomize overlays into plain Kubernetes manifests, so you know exactly what will be deployed
• Add Jinja2-based templating for reusable parametrization
• Automatically generate ArgoCD Application resources
• Organize applications into a well-defined directory structure
• Define multiple environments and control what gets deployed where

Think of it as a static GitOps generator for Kubernetes — rendering, organizing, and wiring your apps for ArgoCD.

💡 Key Features

• ✅ Helm rendering Render Helm charts into raw manifests.

• ✅ Kustomize overlays Render Kustomize overlays into fully resolved Kubernetes manifests. See the full, flattened configuration before deployment.

• ✅ Jinja2 templating Use variables, logic, and partials to build composable app definitions.

• ✅ Multi-environment support Define once and deploy to multiple environments (e.g. dev, staging, prod) with clean separation of concerns.

• ✅ ArgoCD Application generation Automatically generate Application CRs based on your configuration and environment layout.

• ✅ Repeatable & Git-friendly Fully GitOps-compatible. Output is deterministic and fits naturally into pull request workflows.

📦 Installation

pip install make-argocd-fly

📁 Project Structure (Example)

config/
  ├── my_vars.yml              # Config file
  └── my_apps.yml              # Config file
source/
  ├── my_awesome_app/          # Application source resources
  └── monitoring/
        ├── prometheus/        # Application source resources
        └── grafana/           # Application source resources
output/
  └── my_env/                  # Environment name
        ├── my_awesome_app/    # Application YAML resources
        └── monitoring/
            ├── prometheus/    # Application YAML resources
            └── grafana/       # Application YAML resources

🔄 Example Workflow

make-argocd-fly

What it does:

• Applies Jinja2 templates with the right variables
• Renders Helm and Kustomize into raw manifests
• Generates Application manifests for ArgoCD
• Organizes everything under ./output/

📘 Documentation

• Getting Started
• Configuration
• Argocd Application Generation
• Kustomize & Helm Integration
• Using Jinja2 Templates
• CLI Reference
• Caveats & Limitations
• EXAMPLES: Monitoring Stack

📣 Community & Feedback

• Found a bug or have a feature request? Open an issue
• Want to contribute? Check out CONTRIBUTING.md

🛡 License

MIT License – see LICENSE for full text.