ark-devspace

# Ark DevSpace Run Ark from a cloned repository using devspace for development/PR testing. ## CRITICAL: Failure Behavior **If devspace fails, you MUST STOP and report the error. Do NOT try alternative approaches like ark-cli or npm install. DevSpace failures must be diagnosed and fixed.** ## When to use - Testing Ark pull requests - Running Ark from source code ## Prerequisites - Ark repo cloned (e.g., `/workspace/ark` or `/workspace/agents-at-scale-ark`) - Kind cluster running (use kind-setup skill if needed) - Verify cluster: `kubectl cluster-info` ## Steps 1. **Navigate to ark repo** ```bash cd /workspace/ark # or /workspace/agents-at-scale-ark ``` 2. **Deploy with devspace (non-interactive)** ```bash devspace deploy ``` This deploys all components and exits. Check the exit code - if non-zero, STOP and troubleshoot. 3. **Verify deployment succeeded** ```bash kubectl get pods -n ark-system kubectl get pods -n cert-manager ``` 4. **Wait for pods to be ready** ```bash kubectl wait --for=condition=Ready pods --all -n ark-system --timeout=300s ``` 5. **Check services** ```bash kubectl get svc -n ark-system ``` ## Troubleshooting ### Check devspace logs ```bash ls -la .devspace/logs/ cat .devspace/logs/default.log ``` ### Common failures 1. **"namespace not found"** - Set namespace first ```bash devspace use namespace ark-system ``` 2. **"image pull error"** - Build images locally ```bash devspace build ``` 3. **Cert-manager not ready** - Wait for it ```bash kubectl wait --for=condition=Available deployment --all -n cert-manager --timeout=120s ``` 4. **Cluster connectivity** - Re-export kubeconfig ```bash kind export kubeconfig --name ark-cluster --internal ``` ### If devspace exits with error 1. Check the exit code and error message 2. Check `.devspace/logs/` for detailed logs 3. Check pod status: `kubectl get pods -A` 4. Check events: `kubectl get events -A --sort-by='.lastTimestamp'` 5. **STOP and report the specific error - do not try workarounds** ## Cleanup ```bash devspace purge kubectl delete ns ark-system --ignore-not-found ```