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-6-summary.md

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

Step 6 — Summary & Smoke Test

Goal: Confirm everything is working and guide the user on next steps.

Report:

  • Cluster context and node inventory (Step 1)
  • Controller version and namespace (Step 2)
  • GPU types and constraints in effect (Step 3)
  • Provider installed and registration status (Step 4)
  • Model deployed and endpoint URL (Step 5)

Smoke Test

Retrieve the endpoint and test it (only after STATUS = Ready):

Replace <namespace> with the namespace used during deployment (default: default).

ENDPOINT=$(kubectl get modeldeployment <model-name> -n <namespace> -o jsonpath='{.status.endpoint}')

if [ -z "$ENDPOINT" ]; then
  echo "Endpoint not yet available — model may still be starting"
else
  curl -X POST "${ENDPOINT}/v1/chat/completions" \
    -H "Content-Type: application/json" \
    -d '{"model": "<model-id>", "messages": [{"role": "user", "content": "Hello!"}]}'
fi

If the endpoint is a cluster-internal URL (e.g., http://svc-name.namespace:port), set up port-forwarding first:

# Discover the service port (vLLM: 8000, llama.cpp: 8080)
SERVICE_PORT=$(kubectl get svc <service-name> -n <namespace> -o jsonpath='{.spec.ports[0].port}')

kubectl port-forward svc/<service-name> 8080:${SERVICE_PORT} -n <namespace> &
# Then use http://localhost:8080 as the endpoint

See powershell-notes.md for the PowerShell equivalent.

Expected output: A JSON response with a choices array containing the model's reply.

Suggest next steps:

  • Open the AI Runway Web UI to browse and deploy additional models
  • Configure an ingress gateway for external access
  • Review controller/config/samples/ for advanced ModelDeployment options

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.