Development

Development mode is a sandbox deployment that only requires Docker and make to deploy.

This is set up is recommended for testing out the project and using it as the development environment.

Prerequisites

Simply clone the repository

git clone https://github.com/locmai/humble

For getting started with the tools container run the following make commands:

make tools

OR with just the nix-shell:

nix develop

Then spin up the development environment:

make dev

By default, the domain for development would leverage nip.io for local DNS resolution. So we could start with accessing the argocd.172-28-0-3.nip.io.

Get the ArgoCD admin password with the script:

./tools/argocd-password

From there, you could have an overview of things those got deployed.

Grafana integrated with OIDC authentication is provided as well. Access Grafana at grafana.172-28-0-3.nip.io and sign in with Vault.

Get the Vault admin password with the script:

./tools/admin-password

Simply delete the cluster and remove the generated kubeconfig:

k3d cluster delete humble-dev
rm ./metal/kubeconfig.prod.yaml