Local Docker Desktop K8s Setup Guide¶

# Check Docker Desktop K8s is running
kubectl cluster-info

# Expected output:
# Kubernetes control plane is running at https://kubernetes.docker.internal:6443
# CoreDNS is running at https://kubernetes.docker.internal:6443/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy

# Create argocd namespace
kubectl create namespace argocd

# Install ArgoCD
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

# Wait for all pods to be ready (takes 2-3 minutes)
kubectl wait --for=condition=Ready pods --all -n argocd --timeout=300s

kubectl get pods -n argocd

# Expected: All pods should be Running
# NAME                                  READY   STATUS
# argocd-server-xxxxx                   1/1     Running
# argocd-repo-server-xxxxx              1/1     Running
# argocd-application-controller-xxxxx   1/1     Running
# argocd-dex-server-xxxxx               1/1     Running
# argocd-redis-xxxxx                    1/1     Running

# Port forward ArgoCD server to localhost
kubectl port-forward svc/argocd-server -n argocd 8080:443

# Access UI at: https://localhost:8080
# (Accept self-signed certificate warning)

# Patch service to NodePort
kubectl patch svc argocd-server -n argocd -p '{"spec":{"type":"NodePort"}}'

# Get the NodePort
kubectl get svc argocd-server -n argocd

# Access at: https://localhost:<NodePort>

# Get initial admin password
ARGOCD_PASSWORD=$(kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d)

echo "ArgoCD Admin Password: $ARGOCD_PASSWORD"

# Download ArgoCD CLI for Linux
version="v2.11.2"
curl -sSL -o /tmp/argocd "https://github.com/argoproj/argo-cd/releases/download/${version}/argocd-linux-amd64"
sudo install -m 555 /tmp/argocd /usr/local/bin/argocd
rm /tmp/argocd

argocd login localhost:8080 --username admin --password $ARGOCD_PASSWORD --insecure

# Apply the ArgoCD application manifest
kubectl apply -f infra/argocd/application.yaml

# Verify applications created
kubectl get applications -n argocd

# Expected output:
# NAME        SYNC STATUS   HEALTH STATUS
# dex-dev     OutOfSync     Missing
# dex         OutOfSync     Missing

# Sync dev environment
argocd app sync dex-dev

# Watch sync progress
argocd app wait dex-dev --health

# Check application status
argocd app get dex-dev

# Check dev namespace pods
kubectl get pods -n dex-dev

# Expected:
# NAME                   READY   STATUS    RESTARTS   AGE
# dex-xxxxxxxxxx-xxxxx   1/1     Running   0          30s

# Check service
kubectl get svc -n dex-dev

# Check deployment
kubectl describe deployment dex -n dex-dev

# Port forward DEX service
kubectl port-forward -n dex-dev svc/dex 8000:8000

# Access application at: http://localhost:8000

# Update dev kustomization.yaml
newTag="sha-test1234"
sed -i "s|newTag:.*|newTag: ${newTag}|g" infra/argocd/overlays/dev/kustomization.yaml

# Commit and push (dev branch tracks dev environment)
git add infra/argocd/overlays/dev/kustomization.yaml
git commit -m "test: update dev image to $newTag"
git push origin dev

# ArgoCD polls git every 3 minutes by default
# Force refresh immediately:
argocd app refresh dex-dev

# Watch sync
argocd app wait dex-dev --sync

# Check pod events
kubectl describe pod <pod-name> -n argocd

# Check pod logs
kubectl logs <pod-name> -n argocd

# Common fix: Increase Docker Desktop resources
# Settings → Resources → Memory: 4GB+, CPU: 2+

# Check sync status
argocd app get dex-dev

# Force sync with prune
argocd app sync dex-dev --prune

# Check for errors
kubectl get events -n dex-dev --sort-by='.lastTimestamp'

# If using ghcr.io, images must be public or you need imagePullSecrets
# For local testing, build image locally:
docker build -t thedataenginex/dex:latest .

# Tag for local registry
docker tag thedataenginex/dex:latest localhost:5000/dex:latest

# Or use Docker Desktop's built-in registry

# Check port forward is running
ps -ef | grep kubectl

# Restart port forward
kubectl port-forward svc/argocd-server -n argocd 8080:443

# Check deployment status
kubectl rollout status deployment/dex -n dex-dev

# Check pod logs
kubectl logs -f deployment/dex -n dex-dev

# Check resource constraints
kubectl top pods -n dex-dev

# Delete application (keeps namespace)
argocd app delete dex-dev

# Or via kubectl
kubectl delete application dex-dev -n argocd

# Delete namespace
kubectl delete namespace dex-dev

# Delete all ArgoCD resources
kubectl delete -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

# Delete namespace
kubectl delete namespace argocd