All skills
microsoft avatar

/airunway-aks-setup

@d0c21c0 official

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".

Use this Skill: https://skilld.dev/gh/microsoft/github-copilot-for-azure/airunway-aks-setup

This session only. Nothing lands on disk.

referencesstepsstep-4-provider.md

≈515 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Step 4 — Provider Recommendation & Installation

Goal: Select and install the right inference provider for the detected hardware.

# Check if providers are already registered
kubectl get inferenceproviderconfigs --all-namespaces 2>/dev/null || kubectl get inferenceproviderconfigs

See powershell-notes.md for the PowerShell equivalent.

If providers already registered: Show name and status, skip installation.

Provider recommendation logic:

Hardware Use Case Recommended Provider
CPU-only Any KAITO (llama.cpp)
GPUs Standard inference (most users start here) KAITO
GPUs High-throughput serving with separate prefill/decode phases Dynamo
GPUs Already using Ray for ML workloads KubeRay

Default to KAITO unless the user has a specific reason to choose otherwise. KAITO is the simplest to set up and handles most use cases. Dynamo is for teams that need to independently scale the prefill and decode stages of inference for high throughput. KubeRay is for teams already invested in the Ray ecosystem.

Present recommendation with reasoning. Ask user to confirm before installing.

Installation — from the repository root:

First, check the provider's Makefile or README for the default image:

# List available providers and their default images
ls providers/
cat providers/<provider>/Makefile | grep -E 'IMG\s*\?='

See powershell-notes.md for the PowerShell equivalent.

Then deploy:

cd providers/<provider>
make deploy IMG=<image>

Tip: If the Makefile defines a default IMG, you can omit the IMG= argument and just run make deploy.

Verify registration:

kubectl get inferenceproviderconfigs <provider> -o yaml

Check status.ready: true. If not ready within 2 minutes, inspect provider pod logs with kubectl logs <pod-name> and optionally use kubectl describe pod <pod-name> to review events and pod status.

Source: SKILL.md on GitHub

No alerts5mo3 checks · Risk SAFE
  • Gen Agent Trust Hub5mo

    This skill facilitates the setup of AI Runway on Azure Kubernetes Service (AKS) using standard administrative tools. It incorporates security best practices, particularly regarding the handling of sensitive HuggingFace tokens during deployment. No security considerations were identified.

  • Socket5mo

    No alerts

  • Snyk5mo

    Risk: LOW · No issues

Signed by skilld at d0c21c0. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 18 hours ago.

Activeupdated 5 months ago
metadata
{
  "author": "Microsoft",
  "version": "0.0.0-placeholder"
}
argument-hint
[skip-to-step N]
  • kubernetes
  • aks
  • azure
  • llm
  • model-serving
  • gpu
  • inference
  • kaito
  • vllm
  • mlops

README badge

README badge for microsoft/github-copilot-for-azure/airunway-aks-setup

Installs and configures AI Runway on an existing AKS cluster, walking through controller setup, GPU assessment, inference provider selection, and model deployment. Targets users deploying large language models or other GPU-accelerated workloads to Kubernetes via KAITO, Dynamo, or KubeRay.

Generated from the current SKILL.md.

Do I need an existing AKS cluster to use this skill?
Yes. This skill assumes you already have an AKS cluster. If you don't, the skill will hand off to the azure-kubernetes skill to provision one first, then return here.
What inference providers does this skill support?
The skill covers KAITO, Dynamo, and KubeRay as inference provider options. Step 4 recommends and installs the appropriate provider for your setup.
Does this skill work with CPU-only clusters?
Yes, CPU-only inference is acceptable, though the skill includes GPU assessment and provider setup primarily designed for GPU workloads. A bare cluster without GPU resources is still supported.
What happens if I already have part of AI Runway set up?
You can use the `skip-to-step N` argument to resume from a specific phase. The skill will report the current state and skip already-completed steps.
What are the cost implications of using this skill?
GPU node pools incur significant charges — A100-80GB can cost $3–5+/hr. The skill will confirm you understand these costs before provisioning GPU resources.

Generated from the current SKILL.md. These answers refresh after source changes.