Bootstrap Deployment Walkthrough
Tool: platformctl provision
Target: Ubuntu 22.04+ with k3s
Images: ghcr.io/mpratyush54/platform-api + platform-portal (built on GitHub Actions)
Overview
curl -fsSL https://github.com/Mpratyush54/SERVER-automation/releases/latest/download/install.sh | bash
sudo platformctl provision
Idempotent via /etc/platform/.bootstrap_state. No git clone and no on-server image build.
Full command list: platformctl CLI.
High-level phases
- Apt prerequisites
- Docker CE
- k3s (
--disable traefik) + CoreDNS patch - Helm repos
- Namespaces
- ingress-nginx, cert-manager
- Postgres / Mongo / Redis (
databases) - MinIO (
storage) - ArgoCD, monitoring, oauth2-proxy, Portainer
- Pull GHCR images → deploy Cairn API + Portal
- Seed admin (
ADMIN_PASSWORDrequired — printed at end / saved in/etc/platform/.env)
Resume after failure
sudo platformctl provision --auto
# or clear one step:
sudo sed -i '/^platform=/d' /etc/platform/.bootstrap_state
sudo platformctl install platform
Image updates
See rebuild-and-deploy.md — retag/pull from GHCR; do not docker build on the server.