> **azure-kubernetes-app-deploy** — chapter 20 of 41 in [microsoft/azure-skills](https://skillsdocs.com/microsoft/azure-skills).
>
> Book (all chapters, one file): https://skillsdocs.com/microsoft/azure-skills.md
> Machine manifest: https://skillsdocs.com/microsoft/azure-skills/.well-known/agent-skills/index.json
> Install the book: `npx skills add microsoft/azure-skills`
> Upstream: https://github.com/microsoft/azure-skills/blob/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/SKILL.md @ `main`
> Raw bytes, no header: https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/SKILL.md
> Base for relative paths: https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/
> Licence: MIT — https://spdx.org/licenses/MIT.html
>
> Bundled files (41), referenced from this skill's directory:
>   - `knowledge-packs/frameworks/aspnet-core.md` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/knowledge-packs/frameworks/aspnet-core.md
>   - `knowledge-packs/frameworks/django.md` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/knowledge-packs/frameworks/django.md
>   - `knowledge-packs/frameworks/express.md` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/knowledge-packs/frameworks/express.md
>   - `knowledge-packs/frameworks/fastapi.md` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/knowledge-packs/frameworks/fastapi.md
>   - `knowledge-packs/frameworks/flask.md` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/knowledge-packs/frameworks/flask.md
>   - `knowledge-packs/frameworks/go.md` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/knowledge-packs/frameworks/go.md
>   - `knowledge-packs/frameworks/nestjs.md` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/knowledge-packs/frameworks/nestjs.md
>   - `knowledge-packs/frameworks/nextjs.md` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/knowledge-packs/frameworks/nextjs.md
>   - `knowledge-packs/frameworks/spring-boot.md` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/knowledge-packs/frameworks/spring-boot.md
>   - `phases/quick-deploy.md` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/phases/quick-deploy.md
>   - `references/base-images.md` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/references/base-images.md
>   - `references/detection.md` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/references/detection.md
>   - `references/rollback.md` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/references/rollback.md
>   - `references/safeguards.md` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/references/safeguards.md
>   - `references/workload-identity.md` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/references/workload-identity.md
>   - `templates/dockerfiles/dotnet.Dockerfile` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/templates/dockerfiles/dotnet.Dockerfile
>   - `templates/dockerfiles/dotnet.dockerignore` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/templates/dockerfiles/dotnet.dockerignore
>   - `templates/dockerfiles/go.Dockerfile` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/templates/dockerfiles/go.Dockerfile
>   - `templates/dockerfiles/go.dockerignore` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/templates/dockerfiles/go.dockerignore
>   - `templates/dockerfiles/java.Dockerfile` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/templates/dockerfiles/java.Dockerfile
>   - `templates/dockerfiles/java.dockerignore` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/templates/dockerfiles/java.dockerignore
>   - `templates/dockerfiles/node.Dockerfile` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/templates/dockerfiles/node.Dockerfile
>   - `templates/dockerfiles/node.dockerignore` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/templates/dockerfiles/node.dockerignore
>   - `templates/dockerfiles/python.Dockerfile` — https://raw.githubusercontent.com/microsoft/azure-skills/main/skills/azure-kubernetes/azure-kubernetes-app-deploy/templates/dockerfiles/python.Dockerfile
>   - …and 17 more, listed in https://skillsdocs.com/api/v1/books/microsoft/azure-skills/skills/azure-kubernetes-app-deploy
>
> Content © its authors, served unmodified. Takedown: https://github.com/kyleledbetter/skillsdocs/issues/new?labels=takedown&title=Takedown+request

<!-- Verbatim upstream SKILL.md follows, YAML frontmatter included. -->

---
name: azure-kubernetes-app-deploy
license: MIT
metadata:
  author: Microsoft
  version: "1.0.0"
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."
---

# 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/).