Setup¶

1. Clone the repo¶

git clone https://github.com/leffen/agentic-cloud-ops.git
cd agentic-cloud-ops

2. Install dependencies¶

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

3. Add your API key¶

cp .env.example .env
$EDITOR .env

.env

ANTHROPIC_API_KEY=sk-ant-...

Never in Git

.env is git-ignored. Don't commit keys, don't paste them into chat, and use a key you can rotate after the workshop.

4. Start the cluster¶

make cluster-up
kubectl config current-context
kubectl get nodes

Expect one server and one agent node reaching Ready. Give it about 30 seconds after creation — nodes report NotReady at first, which is normal.

Use a throwaway cluster

The agents in this workshop get write access. Point them only at the local cluster. Never at production, and never at a kubeconfig that shares credentials with production.

5. Check the agent responds¶

make agent-check

Expected output: the agent lists the nodes in the cluster and exits.

6. Cleanup (after the workshop)¶

make cluster-down