Welcome to RZware! This guide will help you get set up and productive.
-
Clone key repositories:
git clone https://github.com/cklinker/emf.git
git clone https://github.com/cklinker/homelab-argo.git
-
Install prerequisites:
- Go (latest stable)
- Docker
- kubectl
- Helm
- ArgoCD CLI
-
Configure kubectl:
Obtain your kubeconfig from the infrastructure admin and set it up:
export KUBECONFIG=~/.kube/config
kubectl cluster-info
¶ Day 2: Understanding the Stack
- Company Overview — who we are and what we build
- Architecture Overview — how our systems are structured
- EMF Features — what EMF does
- GitOps: All infrastructure changes go through Git → ArgoCD. Never apply manifests directly with
kubectl apply.
- Shared PostgreSQL: Multiple services share the PostgreSQL instance at 192.168.0.6. Coordinate database changes.
- TLS Everywhere: All external services use Let's Encrypt certificates via cert-manager.
- Create a feature branch
- Make changes and test locally
- Open a pull request
- ArgoCD syncs approved changes automatically
¶ Useful Commands
# Check cluster health
kubectl get nodes
kubectl get pods --all-namespaces
# Check ArgoCD applications
argocd app list
argocd app get <app-name>
# View logs for a service
kubectl logs -n <namespace> -l app=<service-name> -f
- Check this wiki first
- Review the Runbooks for operational procedures
- Ask in Paperclip if you're stuck