
AI Runway AKS Setup
OfficialFreeStreamline AI Runway deployment on Azure Kubernetes Service.
Free · Opens the source repo
What AI Runway AKS Setup does
The AI Runway AKS Setup skill provides a structured approach for deploying AI models on an existing Azure Kubernetes Service (AKS) cluster. It guides users through the entire setup process, starting from verifying the cluster's health to deploying their first AI model. Each step is clearly defined, ensuring that users can follow along without missing critical configurations or checks. The skill is particularly useful for developers and data scientists looking to leverage GPU resources for AI inference, as it includes GPU assessment and provider setup for optimal performance.
The skill consists of six sequential steps: cluster verification, controller installation, GPU assessment, provider setup, model deployment, and a summary of the setup process. Users can execute each step in order, or they have the option to skip to a specific step if they have already completed previous ones. This flexibility allows for efficient onboarding and troubleshooting, catering to both novice and experienced users.
In addition to the step-by-step instructions, the skill includes references for each phase, making it easy for users to access detailed information as needed. Error handling guidelines are also provided to assist users in diagnosing and resolving common issues that may arise during setup, such as configuration errors or resource allocation problems. This comprehensive approach ensures that users can successfully deploy AI models on AKS while being mindful of the associated costs, particularly when utilizing GPU resources.
Overall, the AI Runway AKS Setup skill is an essential tool for those looking to implement AI solutions on Azure, providing a clear path from setup to deployment while minimizing potential roadblocks along the way.
When to use it
Use this skill when you need to onboard an existing AKS cluster for AI Runway, including controller installation and model deployment.
When not to use it
This skill is not suitable if you do not have an existing AKS cluster, as it assumes prior cluster setup is complete.
What you can build with it
Setting Up AI Runway
You want to deploy AI Runway on an existing AKS cluster and need a structured setup process.
Assessing GPU Compatibility
You need to verify the GPU capabilities of your AKS cluster before deploying AI models.
Deploying Your First AI Model
You are ready to deploy an AI model on AKS and want to ensure all configurations are correct.
How to install AI Runway AKS Setup
View source1. Install with the skills CLI
npx skills add microsoft/azure-skills/airunway-aks-setup --agent claude-code2. Or install it manually
Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.
Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs
Inside SKILL.md
Written by microsoftAI Runway AKS Setup
This skill walks users from a bare Kubernetes cluster to a running AI model deployment. Follow each step in sequence unless the user provides skip-to-step N to resume from a specific phase.
Cost awareness: GPU node pools incur significant compute charges (A100-80GB can cost $3–5+/hr). Confirm the user understands cost implications before provisioning GPU resources.
Prerequisites
This skill assumes an AKS cluster already exists. If the user does not have a cluster, hand off to the azure-kubernetes skill first to provision one (with a GPU node pool unless CPU-only inference is acceptable), then return here.
Quick Reference
| Property | Value |
|---|---|
| Best for | End-to-end AI Runway onboarding on AKS |
| CLI tools | kubectl, make, curl |
| MCP tools | None |
| Related skills | azure-kubernetes (cluster setup), azure-diagnostics (troubleshooting) |
When to Use This Skill
Use this skill when the user wants to:
- Set up AI Runway on an existing AKS cluster from scratch
- Install the AI Runway controller and CRDs
- Assess GPU hardware compatibility for model deployment
- Choose and install an inference provider (KAITO, Dynamo, KubeRay)
- Deploy their first AI model to AKS via AI Runway
- Resume a partially-complete AI Runway setup from a specific step
MCP Tools
This skill uses no MCP tools. All cluster operations are performed directly via kubectl and make.
Rules
- Execute steps in sequence — load the reference for each step as you reach it
- Report cluster state at each step: ✓ healthy, ✗ missing/failed
- Ask for user confirmation before any install or deployment action
- If a step is already complete, report status and skip to the next step
- If the user provides
skip-to-step N, start at step N; assume prior steps are complete
Steps
| # | Step | Reference |
|---|---|---|
| 1 | Cluster Verification — context check, node inventory, GPU detection | step-1-verify.md |
| 2 | Controller Installation — CRD + controller deployment | step-2-controller.md |
| 3 | GPU Assessment — detect GPU models, flag dtype/attention constraints | step-3-gpu.md |
| 4 | Provider Setup — recommend and install inference provider | step-4-provider.md |
| 5 | First Deployment — pick a model, deploy, verify Ready | step-5-deploy.md |
| 6 | Summary — recap, smoke test, next steps | step-6-summary.md |
Error Handling
| Error / Symptom | Likely Cause | Remediation |
|---|---|---|
| No kubeconfig context | Not connected to a cluster | Run az aks get-credentials or equivalent |
| 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 logs <pod-name> -n <namespace> for the provider pod |
| ModelDeployment stuck in Pending | GPU scheduling failure or provider not ready | kubectl describe modeldeployment <name> -n <namespace> events |
bfloat16 errors at inference | T4 or V100 lacks bfloat16 support | Add --dtype float16 to serving args |
For full error handling and rollback procedures, see troubleshooting.md.
Frequently asked questions about AI Runway AKS Setup
Similar skills
Turborepo
Optimized build system for JavaScript/TypeScript monorepos.
Azure Pipelines Validation
Streamline your Azure DevOps pipeline changes locally.
Azure Developer CLI
Streamline your Azure project workflows with best practices.
Azure Container Registry CLI
Manage Azure Container Registry resources with ease.
Aspire
Build and orchestrate polyglot distributed applications seamlessly.
Vercel CLI
Manage and deploy Vercel projects from the command line.
