AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

airunway-aks-setup

Set up AI Runway on AKS — from bare cluster to running model. Covers cluster verification, controller install, GPU assessment, provider setup, and first deployment. WHEN: "setup AI Runway", "onboard AKS cluster", "install AI Runway", "airunway setup", "deploy model to AKS", "GPU inference on AKS", "KAITO setup on AKS", "run LLM on AKS", "vLLM on AKS", "set up model serving on AKS", "AI Runway controller".

Original source
microsoft
License
MIT
Pinned revision
3f5b461b2314e01c400564051e92469114c5b68f

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

Ask your assistant

Use Agentic Memory skills to read microsoft--airunway-aks-setup at revision 3f5b461b2314e01c400564051e92469114c5b68f, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 12

references/troubleshooting.md

Troubleshooting & Rollback

Error Handling

| Error / Symptom | Likely Cause | Remediation | |-----------------|--------------|-------------| | No kubeconfig context | Not connected to a cluster | Run az aks get-credentials or equivalent | | make: *** No rule to make target | Not in AI Runway repo root | cd to repo root and retry | | Controller in CrashLoopBackOff | Config or RBAC issue | kubectl logs -n airunway-system -l control-plane=controller-manager --previous | | Provider not ready | Image pull or RBAC issue | kubectl describe pod for the provider pod | | ModelDeployment stuck in Pending | GPU scheduling failure or provider not ready | kubectl describe modeldeployment events | | Pod shows ImagePullBackOff | Wrong image reference or missing pull secret | kubectl describe pod for the model pod | | 401 from HuggingFace at model load | Gated model, token secret not wired into CR | Ensure huggingFaceTokenSecretRef is set in the CR | | bfloat16 errors at inference | T4 or V100 lacks bfloat16 support | Add --dtype float16 to serving args |

Rollback

If a step fails and you need to undo a partial setup, work backwards through the steps:

| What to undo | Command | |--------------|---------| | Model deployment | kubectl delete modeldeployment <model-name> -n <namespace> | | HuggingFace token secret | kubectl delete secret hf-token -n <namespace> | | Provider | cd providers/<provider> && make undeploy (from repo root) | | Controller | make controller-undeploy && make controller-uninstall (from repo root) |