All skills
microsoft avatar

/airunway-aks-setup

@b3c238e
by microsoftmicrosoft/skills3.1k stars
351

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/skills/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 alerts15d3 checks · Risk SAFE
  • Gen Agent Trust Hub15d

    This skill provides a structured walkthrough for setting up AI Runway on Azure Kubernetes Service (AKS). It includes cluster verification, controller installation, hardware assessment, and model deployment using standard tools like kubectl and make. The skill follows secure practices for handling HuggingFace tokens and manages infrastructure transparently within the user's provided Kubernetes context.

  • Socket15d

    No alerts

  • Snyk15d

    Risk: LOW · No issues

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

Last checked against GitHub yesterday.

Activeupdated 2 months ago
metadata
{
  "author": "Microsoft",
  "version": "1.1.1"
}
argument-hint
[skip-to-step N]

README badge

README badge for microsoft/skills/airunway-aks-setup