# Azure Kubernetes App Deploy

Use when deploying an existing web application or API to an already-running Azure...

- Repository: https://github.com/microsoft/azure-skills (1609 stars)
- Category: DevOps
- License: MIT
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add microsoft/azure-skills --skill azure-kubernetes-app-deploy -g -a claude-code -y`
Codex: `npx skills add microsoft/azure-skills --skill azure-kubernetes-app-deploy -g -a codex -y`
Cursor: `npx skills add microsoft/azure-skills --skill azure-kubernetes-app-deploy -g -a cursor -y`
Gemini CLI: `npx skills add microsoft/azure-skills --skill azure-kubernetes-app-deploy -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add microsoft/azure-skills`

## Description

Use when deploying an existing web application or API to an already-running Azure Kubernetes Service cluster. Detects the framework, generates a Dockerfile and Kubernetes manifests, validates against AKS Deployment Safeguards, and deploys with verification. WHEN: deploy app to AKS, deploy to existing AKS cluster, containerize app for Kubernetes, generate K8s manifests for Azure, set up CI/CD for AKS, my AKS deployment is failing safeguard checks, I have a Django/Express/Spring Boot app to run on AKS. DO NOT USE FOR: creating or provisioning an AKS cluster (use azure-kubernetes), assessing migration to AKS Automatic (use azure-kubernetes-automatic-readiness), or deploying to non-AKS targets like Web Apps, Container Apps, or Functions.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Deploy to AKS

**Use when:** deploying a web app/API to AKS; containerizing for Kubernetes; generating manifests; AKS CI/CD; DS001, DS013 failures.

**Not for:** provisioning clusters (`azure-kubernetes`), AKS Automatic readiness (`azure-kubernetes-automatic-readiness`), non-AKS targets.

## Workflow

Requires: existing AKS cluster, `az login`, `kubectl` configured. Follow `phases/quick-deploy.md`. On failure: `references/rollback.md`.

## References

- [detection.md](./references/detection.md), framework/port/health detection
- [safeguards.md](./references/safeguards.md), DS001-DS013 checklist
- [workload-identity.md](./references/workload-identity.md), Workload Identity setup
- [rollback.md](./references/rollback.md), recovery procedures
- [base-images.md](./references/base-images.md), base image policy and `<LATEST_STABLE_*>` resolution

## Knowledge Packs

Load `knowledge-packs/frameworks/<framework>.md` per detected framework. Available: `spring-boot`, `express`, `nextjs`, `fastapi`, `django`, `nestjs`, `aspnet-core`, `go`, `flask`

## Templates

`templates/` (dockerfiles/, k8s/, github-actions/, mermaid/).