azure-kubernetes-app-deploy
microsoft/azure-skills
Deploy web apps and APIs to Azure Kubernetes Service with automatic framework detection and safeguard validation.
What is azure-kubernetes-app-deploy?
Deploys existing web applications and APIs to running AKS clusters by detecting the framework, generating Dockerfiles and Kubernetes manifests, validating against AKS Deployment Safeguards, and verifying the deployment. Use this when you have an app ready to containerize and deploy to an existing AKS cluster.
- Detects application framework (Spring Boot, Express, Next.js, FastAPI, Django, NestJS, ASP.NET Core, Go, Flask)
- Generates Dockerfile and Kubernetes manifests automatically
- Validates deployment against AKS Deployment Safeguards (DS001–DS013)
- Deploys to AKS with verification and health checks
- Provides rollback procedures for failed deployments
- Supports Workload Identity setup for secure authentication
How to install azure-kubernetes-app-deploy
npx skills add https://github.com/microsoft/azure-skills --skill azure-kubernetes- Existing AKS cluster already running
- Azure CLI (`az`) installed and authenticated with `az login`
- kubectl configured to access the target AKS cluster
How to use azure-kubernetes-app-deploy
- 1.Ensure your AKS cluster is running and kubectl is configured
- 2.Run the skill to detect your application framework
- 3.Review the generated Dockerfile and Kubernetes manifests
- 4.Validate against AKS Deployment Safeguards (DS001–DS013)
- 5.Deploy to AKS using the generated deployment configuration
- 6.Verify the deployment and health checks complete successfully
- 7.If deployment fails, consult rollback.md for recovery procedures
Use cases
- Containerize and deploy a Django or Express app to an existing AKS cluster
- Generate Kubernetes manifests for a Spring Boot microservice
- Diagnose and fix AKS Deployment Safeguard validation failures
- Set up CI/CD pipelines for automated AKS deployments
- Deploy a Next.js or FastAPI application with health checks
- DevOps engineers deploying apps to AKS
- Backend developers containerizing applications for Kubernetes
- Platform teams managing AKS deployments
- Teams implementing CI/CD for Azure Kubernetes Service
azure-kubernetes-app-deploy FAQ
Spring Boot, Express, Next.js, FastAPI, Django, NestJS, ASP.NET Core, Go, and Flask. The skill auto-detects your framework and loads the appropriate knowledge pack.
No. This skill deploys to an existing AKS cluster. Use the `azure-kubernetes` skill to provision a new cluster.
Safeguards DS001–DS013 are validation checks for secure and reliable AKS deployments. The skill validates your configuration against these checks and reports failures.
Consult the rollback.md reference guide included in the skill for recovery procedures and troubleshooting steps.
The skill includes workload-identity.md guidance for setting up Workload Identity for secure authentication, but you may need to configure it based on your security requirements.
Full instructions (SKILL.md)
Source of truth, from microsoft/azure-skills.
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 — framework/port/health detection
- safeguards.md — DS001-DS013 checklist
- workload-identity.md — Workload Identity setup
- rollback.md — recovery procedures
- 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/).
Related skills
More from microsoft/azure-skills and the wider catalog.
