Proxmox-GitOps

Proxmox GitOps is an advanced, self-configuring GitOps environment designed for seamless container automation within Proxmox VE. This project embraces an Infrastructure-as-Code (IaC) approach, enabling comprehensive management of the Linux Containers (LXC) lifecycle, including bootstrapping, deployment, configuration, and validation—all through version-controlled automation.

Key Architecture Features

The architecture features a multi-stage pipeline that recursively deploys and configures itself, ensuring a consistent and automated infrastructure experience. Initial bootstrapping occurs in a local Docker environment, followed by direct deployments to Proxmox VE. This methodology guarantees reliability and reproducibility for all infrastructure management tasks.

Getting Started

Setup involves configuring the necessary credentials and Proxmox API token in the local/.config.json file. Locally run the environment with local/run.sh, followed by accepting the pull request to initiate deployment on Proxmox VE.

Creating Containers

Reusable container definitions are conveniently organized in the libs folder. Users can utilize existing templates or create new container libraries from scratch following these steps:

• Define the container's environment in a config.env file, specifying parameters such as IP address, ID, hostname, resources, and disk allocation.
• Integrate a generic pipeline within the gitea/workflows directory to manage CI/CD executions.
• Implement application-level configuration through a cookbook, ensuring consistent service management and file manipulation.
• Deploy the configuration by pushing changes to the release branch or integrating into a Meta-/Mono-repository for comprehensive deployment.

Core Functionality

This repository is distinguished by its self-replicating capabilities, which leverage a Gitea instance within the container to push configuration changes and trigger the pipeline recursively. Notable features include:

• Self-Managed Infrastructure: The system autonomously provisions, configures, and verifies its own state.
• Container Provisioning: Handled efficiently via Ansible using the Proxmox API.
• Environment Management: System variables are derived from config.json and propagate within the GitOps framework.
• Modularity: Each component and reusable workflow is managed through Gitea, promoting easy extension and adaptation.

For more guidance and a detailed breakdown of requirements, visit the Wiki. Proxmox GitOps offers a robust framework for developers seeking to optimize container management and CI/CD processes.