This tutorial takes you from a fresh checkout to a running Talos Kubernetes cluster with full observability. Estimated time: 20 minutes (including cloud provisioning).
Install these tools before proceeding:
| Tool | Version | Purpose | Install |
|---|---|---|---|
| OpenTofu | >= 1.9 | Infrastructure as Code | brew install opentofu |
| podman | >= 4.0 | Local KMS bootstrap (OpenBao) | brew install podman |
| kubectl | >= 1.35 | Kubernetes CLI | brew install kubectl |
| jq | any | JSON parsing in scripts | brew install jq |
| Helm | >= 3.0 | Helm chart templating | brew install helm |
For Scaleway deployments, you also need:
- A Scaleway account with Organization admin access
scwCLI configured (brew install scw)
For local deployments:
- libvirt/KVM (
brew install libvirton Linux, not available on macOS) - At least 16 GB RAM and 8 CPU cores
git clone git@github.com:Destynova2/st4ck.git
cd st4ckThe platform pod is a local podman pod containing: bootstrap OpenBao KMS (single-node Raft), vault-backend, Gitea, Woodpecker, and a tofu-setup sidecar. It generates:
- Root CA + intermediate CAs
- Static seal key for in-cluster OpenBao
- vault-backend AppRole credentials for Terraform state storage
make bootstrap
make bootstrap-export # Copy tokens + certs to kms-output/Expected output:
=========================================
Platform starting
=========================================
OpenBao: http://127.0.0.1:8200
State: http://127.0.0.1:8080
=========================================
Verify it is running:
curl -s http://localhost:8200/v1/sys/health | jq .
curl -s http://localhost:8080/state/test # Should return empty or 404The kms-output/ directory now contains certificates and tokens. This directory is gitignored and must not be committed.
Create the IAM secret file:
cat > envs/scaleway/iam/secret.tfvars << 'EOF'
scw_access_key = "your-admin-access-key"
scw_secret_key = "your-admin-secret-key"
scw_organization_id = "your-org-id"
EOFBootstrap IAM (creates scoped API keys for image builder, cluster, and CI):
make scaleway-iam-init
make scaleway-iam-applymake scaleway-image-apply REGION=fr-par
make scaleway-bootstrap-vm ENV=dev INSTANCE=shared REGION=fr-par
make scaleway-up ENV=dev INSTANCE=mgmt REGION=fr-parThis runs the full pipeline:
scaleway-apply-- Creates VMs, load balancer, private networkscaleway-wait-- Waits for Kubernetes API server (up to 5 minutes)scaleway-kubeconfig-- Writes kubeconfig to the context path (~/.kube/st4ck-dev-mgmt-fr-parin this example)k8s-up-- Deploys all 7 day-1 stacks sequentially (duration depends on image pulls and PKI readiness)
make local-upCheck that all pods are running:
export KUBECONFIG=~/.kube/st4ck-dev-mgmt-fr-par # or the path printed by make local-up
kubectl get pods -A | grep -v Running | grep -v CompletedAll stacks should be healthy:
# Cilium
kubectl -n kube-system get pods -l app.kubernetes.io/name=cilium-agent
# Monitoring
kubectl -n monitoring get pods
# PKI
kubectl -n secrets get pods
# Security
kubectl -n security get pods
# Storage
kubectl -n garage get pods
kubectl -n storage get pods# Headlamp (Kubernetes UI) -- token copied to clipboard
make scaleway-headlamp
# Grafana (metrics and logs)
make scaleway-grafana
# Harbor (container registry) -- password copied to clipboard
make scaleway-harborAt this point, your cluster has:
| Stack | Components | Namespace |
|---|---|---|
| CNI | Cilium (eBPF, replaces kube-proxy), local-path StorageClass | kube-system, local-path-storage |
| Monitoring | VictoriaMetrics, VictoriaLogs, Grafana, Headlamp | monitoring |
| PKI | OpenBao x2, cert-manager, Root/Intermediate CA | secrets |
| Identity | Kratos, Hydra, Pomerium (OIDC/SSO) | identity |
| Security | Trivy, Tetragon, Kyverno, Cosign policy | security |
| Storage | Garage S3, Velero, Harbor | garage, storage |
| GitOps | Flux v2 (day-2 reconciliation) | flux-system |
- How to deploy to other environments
- How to troubleshoot common issues
- Architecture explanation
- Command reference
When you are done:
make scaleway-down # Destroy k8s stacks + cluster
make kms-stop # Stop local KMS podTo destroy everything including IAM and images:
make scaleway-nuke # Requires confirmation prompt