Files
personal-site/k8s/README.md
T
Jesse EgbosionuandClaude Opus 5.5 0927b9d665 ci: build, push and deploy to personal cluster on push to master
- Gitea Actions workflow: build, push sha-tagged image, apply kustomize, wait for rollout with auto-rollback
- Deploy to personal-site namespace, served at jesseinit.dev with TLS
- Run container as non-root and bind to 0.0.0.0

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-24 21:19:22 +02:00

1.9 KiB

Kubernetes deployment

The site runs on the personal k3s cluster in the personal-site namespace and is served at https://jesseinit.dev (www. redirects to the apex). TLS comes from cert-manager (letsencrypt-prod).

How deploys work

.github/workflows/deploy.yml (run by Gitea Actions) on every push to master:

  1. Build site: npm ci && npm run build, and renders the kustomization to catch manifest errors.
  2. Build and push image: tea.jesseinit.dev/jesseinit/personal-site:sha-<commit> and :latest.
  3. Deploy: pins newTag in kustomization.yaml to sha-<commit>, runs kubectl apply -k k8s/, waits for the rollout, and rolls back automatically if it fails.

Pull requests run step 1 only. Old images are cleaned up by the nightly gitea-package-prune cronjob.

Required secrets (repo or production environment in Gitea)

Secret Value
REGISTRY_TOKEN Gitea token with write:package for jesseinit
KUBE_CONFIG base64-encoded kubeconfig for the personal cluster

Files

  • namespace.yaml: personal-site namespace
  • deployment.yaml: 2 replicas, zero-downtime rolling updates, non-root, health checks
  • service.yaml: ClusterIP on port 80 → container port 3000
  • ingress.yaml: nginx ingress + TLS for jesseinit.dev / www.jesseinit.dev
  • configmap.yaml: optional environment variables
  • kustomization.yaml: ties it together and sets the image

Manual operations

kubectl --context personal-cluster -n personal-site get pods,ingress,certificate
kubectl --context personal-cluster -n personal-site logs -l app=jesseinit-portfolio -f
kubectl --context personal-cluster -n personal-site rollout undo deployment/jesseinit-portfolio

# Deploy by hand (uses :latest)
kubectl --context personal-cluster apply -k k8s/