Cloud Native Gauntlet

Cloud-native reference project running on K3s/Multipass. Refer to Project description for details about the project.

Quick links

• Project status: see docs/PROJECT_STATUS.md
• Apps overview and manual deploy steps: see apps/README.md
• GitOps and infra manifests: see gitops/infra/README.md
• Deploy script entry point: scripts/deploy.sh

---

Project Overview

This project sets up a complete cloud-native environment with:

• Infrastructure: Multipass VMs running K3s Kubernetes cluster
• Authentication: Keycloak identity and access management
• Applications: Production-ready Task API with PostgreSQL database
• Monitoring: Prometheus and Grafana for observability (templates provided)
• Automation: Terraform and Ansible for infrastructure management
• GitOps: ArgoCD for continuous deployment

Prerequisites

• Multipass installed
• Terraform installed
• Ansible installed
• kubectl installed
• SSH key pair generated (~/.ssh/id_rsa and ~/.ssh/id_rsa.pub)

Note: Pre-requisites are automatically installed by scripts/setup.sh

Quick Start

1. Clone the repository:

   git clone <repository-url>
   cd cloud-native-gauntlet

2. Run the automated setup script:

   chmod +x scripts/setup.sh
   ./scripts/setup.sh

3. Verify the cluster:

   kubectl get nodes
   kubectl get pods --all-namespaces

4. Install GitOps with ArgoCD (optional):

   chmod +x gitops/scripts/install-argocd.sh
   ./gitops/scripts/install-argocd.sh

5. Deploy applications (optional):

   chmod +x scripts/deploy.sh
   ./scripts/deploy.sh

4. Cleanup

# Destroy infrastructure
cd infra/terraform
terraform destroy -auto-approve

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request