# Azure App Onboard > Orquestador de punta a punta: de una idea o una app existente hasta un despliegue en Azure, con estimación de costes y aprobación previa. Analiza tu app y detecta los servicios adecuados. Fuente: https://skillsagentes.com/skills/microsoft/azure-skills/azure-app-onboard Markdown: https://skillsagentes.com/skills/microsoft/azure-skills/azure-app-onboard.md Repositorio: https://github.com/microsoft/azure-skills Autor: microsoft Licencia: MIT Actualizado: el mes pasado Coste de contexto: 224 tok instalada, 1.6k tok al activarse, 95.2k tok con todos los archivos del bundle Bundle: 68 archivos, 372 KB Permisos que pide: ninguno declarado ## Instalación Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina. ```bash # Claude Code npx -y skills add microsoft/azure-skills --skill azure-app-onboard --agent claude-code # Cursor npx -y skills add microsoft/azure-skills --skill azure-app-onboard --agent cursor # Codex npx -y skills add microsoft/azure-skills --skill azure-app-onboard --agent codex # Gemini CLI npx -y skills add microsoft/azure-skills --skill azure-app-onboard --agent gemini # Windsurf npx -y skills add microsoft/azure-skills --skill azure-app-onboard --agent windsurf # Cline npx -y skills add microsoft/azure-skills --skill azure-app-onboard --agent cline ``` ## Qué hace - Es el orquestador de punta a punta: de una idea de negocio, una idea de app o una app existente hasta un despliegue funcionando en Azure. - Analiza la aplicación, autodetecta los servicios de Azure adecuados, genera la infraestructura y despliega — a medida de la app, no desde una plantilla. - Incluye estimación de costes y aprobación previa al despliegue. - Exige que **todo** repositorio pase el pipeline completo de 10 pasos, sin saltarse ninguno ni cortocircuitar por lo que reconozca. ## Cuándo usarla - Se quiere llevar una app a Azure, planificarla o saber cuánto costaría ejecutarla. - Se pregunta qué servicios de Azure hacen falta, o se quiere migrar una app existente sin reescribirla. ## Cuándo no - Cuando se quiere usar azd para desplegar, que va a `azure-deploy`. - Para optimizar costes existentes, que va a `azure-cost`. - Para comprobar solo si el código está listo, que va a `azure-app-onboard-prereq`. ## Qué la activa - "lleva mi app a Azure" - "¿qué servicios de Azure necesito?" - "¿cuánto costaría ejecutar esto?" - "despliega mi app a la nube" ## Antes de instalar - Coordina cuatro sub-skills por fases — prereq, prepare, scaffold y deploy — que no son invocables directamente por el usuario. ## Archivos - SKILL.md — 6 KB - deploy/SKILL.md — 7 KB - deploy/references/approval-gate-template.md — 3 KB - deploy/references/blocked-patterns.md — 6 KB - deploy/references/code-deployment-appservice.md — 5 KB - deploy/references/code-deployment-container-apps.md — 8 KB - deploy/references/code-deployment-swa.md — 6 KB - deploy/references/database-post-deploy.md — 4 KB - deploy/references/deploy-checklist-template.md — 10 KB - deploy/references/deploy-safety.md — 5 KB - deploy/references/deploy-schemas.ts — 3 KB - deploy/references/error-classification.md — 4 KB - deploy/references/health-check-patterns.md — 6 KB - deploy/references/mcp-tools.md — 6 KB - deploy/references/portal-links.md — 3 KB - deploy/references/preflight-checks.md — 4 KB - deploy/references/subagent-preflight.md — 5 KB - prepare/SKILL.md — 6 KB - prepare/references/deploy-strategy.md — 7 KB - prepare/references/mcp-tools.md — 6 KB - prepare/references/naming-patterns.md — 5 KB - prepare/references/prepare-schemas.ts — 7 KB - prepare/references/pricing-guide-services.md — 8 KB - prepare/references/pricing-guide.md — 4 KB - prepare/references/service-mapping.md — 8 KB - prepare/references/sku-matrix.md — 3 KB - prepare/references/sku-quota-validation.md — 9 KB - prepare/references/subagent-pricing.md — 2 KB - prepare/references/subagent-quota.md — 3 KB - prepare/references/validation-rubric.md — 2 KB - references/approval-gates.md — 7 KB - references/azd-template-routing.md — 5 KB - references/handoff-protocol.md — 8 KB - references/iac-resources.md — 3 KB - references/intent-gathering.md — 2 KB - references/mcp-tool-reference.md — 4 KB - references/pipeline-rules-runtime.md — 4 KB - references/pipeline-rules.md — 6 KB - references/session-protocol.md — 8 KB - references/session-schemas.ts — 5 KB - references/subscription-resolution.md — 2 KB - scaffold/SKILL.md — 14 KB - scaffold/references/bicep-app-service.md — 5 KB - scaffold/references/bicep-container-apps.md — 9 KB - scaffold/references/bicep-patterns-data.md — 4 KB - scaffold/references/bicep-patterns-security.md — 8 KB - scaffold/references/bicep-patterns.md — 7 KB - scaffold/references/bicep-swa.md — 757 B - scaffold/references/cicd-pipelines.md — 325 B - scaffold/references/dockerfile-generation.md — 4 KB - scaffold/references/env-var-secrets.md — 4 KB - scaffold/references/error-handling.md — 1 KB - scaffold/references/iac-generation-rules.md — 7 KB - scaffold/references/mcp-tools.md — 7 KB - scaffold/references/rbac-roles.md — 4 KB - scaffold/references/scaffold-healing-rules.md — 3 KB - scaffold/references/scaffold-schemas.ts — 3 KB - scaffold/references/self-healing.md — 2 KB - scaffold/references/self-review-checklist.md — 9 KB - scaffold/references/self-review-procedure.md — 2 KB - scaffold/references/subagent-iac-gen.md — 10 KB - scaffold/references/subagent-review.md — 4 KB - scaffold/references/subagent-validate.md — 7 KB - scaffold/references/terraform-patterns.md — 7 KB - scaffold/references/validation-and-manifest.md — 5 KB - scaffold/references/waf-checklist.md — 2 KB - scaffold/scripts/scaffold-conformance.ps1 — 13 KB - scaffold/scripts/scaffold-conformance.sh — 14 KB ## SKILL.md Reproducido tal cual desde microsoft/azure-skills bajo MIT. Esta sección es el documento original y está en inglés. # Azure App Onboard > ⛔ **Every repo goes through the full pipeline (Steps 1–10). No exceptions.** Do not skip steps, refuse, or short-circuit based on what you recognize. Follow the Workflow table below sequentially — read each step's references before acting. ## Quick Reference | Property | Value | |----------|-------| | Best for | Developers who know what to build but not which Azure services to use | | Inputs | Business idea or existing codebase, budget/scale preferences (optional) | | Outputs | Architecture plan, cost estimate, IaC files, deployed Azure resources | | Phases | Discover → Architect → Scaffold → Deploy (self-contained, no external skill calls) | ## When to Use This Skill - Deploy existing code without knowing which Azure services to use - Check if your existing code is ready to deploy to Azure - Move an existing app to Azure without rewriting or with minimal changes - Get cost estimates before committing to infrastructure - Understand architecture decisions and rejected alternatives - Get answers to Azure architecture or service selection questions (e.g., "What database should I use?") - Get guided Azure onboarding without prior experience ## When NOT to Use | Scenario | Use Instead | |----------|-------------| | Run `azd up` or execute an existing deployment | `azure-deploy` | | Optimize existing Azure spend | `cost-optimization` from the optional `azure-cost` plugin | | Generate Bicep/Terraform for a known architecture | `azure-prepare` | | Validate infrastructure or run preflight checks | `azure-validate` | | Troubleshoot a running Azure deployment | `azure-diagnostics` | | Deploy to or manage AKS/Kubernetes directly | `azure-kubernetes` | | Look up or list existing Azure resources | `azure-resource-lookup` | If `cost-optimization` is unavailable, explain that it is provided by the optional `azure-cost` plugin and direct the user to their client's supported plugin installation flow; do not imply the handoff completed. ## Pipeline Rules > ⛔ **You MUST read [`references/pipeline-rules.md`](references/pipeline-rules.md) at the start of every AppOnboard session.** It contains approval gates, phase lifecycle, session artifacts, deploy-as-is, and security baseline rules. ## Workflow > ⛔ **Deploy recovery:** After deploy gate approval OR before any `az deployment`/`az webapp deploy`/`az acr build` — if you haven't read `deploy/SKILL.md`, read `.copilot-azure/sessions/{id}/deploy-checklist.md` first, then `deploy/SKILL.md`. ⛔ NEVER invoke `{"skill": "azure-deploy"}` — that is a DIFFERENT skill for a DIFFERENT workflow. > ⛔ **Post-scaffold transition (MANDATORY):** Immediately after `scaffold-manifest.json` is written, YOUR NEXT ACTION MUST be Step 8 (Deploy Approval Gate) — NOT a summary report, NOT a "here are the generated files" message, NOT a completion signal. Confirm `context.json` has `completedPhases: [...,"scaffold"]` + `currentPhase: "deploy"` (update it yourself if the scaffold subagent didn't). Re-read [approval-gates.md § Deploy Gate](references/approval-gates.md) if evicted from context (scaffold reference loading is heavy), then present the exact prompt: **"🚀 Ready to deploy? (Yes / Run manually / Edit plan / Cancel)"**. This gate is the LAST content in your response — wait for the user's reply. | # | Step | Action | Reference | |---|------|--------|-----------| | 1 | **Session check + Azure login** | Create/resume session, verify Azure CLI auth, resolve subscription + user identity | ⛔ **You MUST read [session-protocol.md](references/session-protocol.md)** | | 2 | **Scope triage** | Check azd markers, triage question. Empty workspace or code-only (no infra) → Step 3 directly. | ⛔ Read [intent-gathering.md](references/intent-gathering.md) § Scope Triage | | 3 | **Prereq scan** | ⛔ Skip if `completedPhases` includes `"prereq"`. Otherwise: invoke `{"skill": "azure-app-onboard-prereq"}`. Write `prereq-output.json`, update `context.json`. **Halt if:** `overallHealth: "blocked"` OR `routeToSkill` set. | | | 4 | **Gather intent** | Present prereq results, confirm stack + Azure services, ask remaining questions. | ⛔ Read [intent-gathering.md](references/intent-gathering.md) § After Prereq Returns | | 5 | **Plan architecture** | Write `prepare-plan.json`. | ⛔ **You MUST read [prepare/SKILL.md](prepare/SKILL.md)** | | 6 | **Scaffold approval gate** | Display plan for user approval BEFORE generating any files. | ⛔ Read [approval-gates.md](references/approval-gates.md) § Scaffold Gate | | 7 | **Scaffold** | Generate IaC, self-review. Write `scaffold-manifest.json`. Update `context.json`. | ⛔ **You MUST read [scaffold/SKILL.md](scaffold/SKILL.md)** | | 8 | **Deploy approval gate** | Display validation summary. ⛔ After approval: FIRST read deploy-checklist.md → deploy/SKILL.md. NEVER `{"skill": "azure-deploy"}`. | ⛔ Read [approval-gates.md](references/approval-gates.md) § Deploy Gate | | 9 | **Deploy** | Execute IaC, health-check. Write `deploy-result.json`. | ⛔ **You MUST read [deploy/SKILL.md](deploy/SKILL.md)** | | 10 | **Handoff** | Surface deployment identity, cleanup commands, next steps. | ⛔ **You MUST read [`handoff-protocol.md`](references/handoff-protocol.md)** | ## Error Handling | Error | Remediation | |-------|-------------| | Phase fails | Halt, report phase + error. User decides: retry, skip, abort. | | MCP server unavailable | Skip affected checks, add disclaimer to `costEstimate.assumptions[]` and every approval gate. | | Missing RBAC | Report required role + `az role assignment` command. | > **Shared references:** [MCP tools](references/mcp-tool-reference.md) (cross-phase tool parameters) | [IaC resources](references/iac-resources.md) (Azure resource docs for troubleshooting) ## Dónde encaja - Categoría: [DevOps e infraestructura](https://skillsagentes.com/categorias/devops-infraestructura.md) — Despliegues, contenedores, IaC y flujos de gestión de incidentes. - Creador: [microsoft](https://skillsagentes.com/creators/microsoft.md) — 43 skills en el directorio - [Todas las skills](https://skillsagentes.com/skills.md) - [Ranking de instalaciones](https://skillsagentes.com/ranking.md) ## Otras skills del mismo repositorio - [Microsoft Foundry](https://skillsagentes.com/skills/microsoft/azure-skills/microsoft-foundry.md): Despliega, evalúa, ajusta y gestiona agentes de Foundry de punta a punta con azd: agentes hospedados, evaluación por lotes y continua, optimizador de prompts y fine-tuning (SFT/DPO/RFT). - [Azure Prepare](https://skillsagentes.com/skills/microsoft/azure-skills/azure-prepare.md): Prepara proyectos Azure basados en azd para desplegar: genera azure.yaml, la infraestructura (Bicep o Terraform) y los Dockerfiles del flujo del Azure Developer CLI. - [Azure Diagnostics](https://skillsagentes.com/skills/microsoft/azure-skills/azure-diagnostics.md): Depura incidencias de producción en Azure con AppLens, Azure Monitor, resource health y triaje seguro. Cubre App Service, Container Apps, Functions, AKS, VMs y mensajería. - [Azure Validate](https://skillsagentes.com/skills/microsoft/azure-skills/azure-validate.md): Validación previa al despliegue en Azure. Comprueba en profundidad la configuración, la infraestructura (Bicep o Terraform), los roles RBAC, los permisos de identidad administrada y los prerrequisitos. - [Deploy Model](https://skillsagentes.com/skills/microsoft/azure-skills/deploy-model.md): Skill unificado de despliegue de modelos de Azure OpenAI con enrutado por intención: despliegues rápidos con preset, despliegues personalizados y descubrimiento de capacidad entre regiones y proyectos. ## Skills relacionadas - [Airunway Aks Setup](https://skillsagentes.com/skills/microsoft/azure-skills/airunway-aks-setup.md): Instala AI Runway sobre AKS, de un clúster desnudo a un modelo funcionando: verificación del clúster, instalación del controlador, evaluación de GPU, configuración del proveedor y primer despliegue. - [Appinsights Instrumentation](https://skillsagentes.com/skills/microsoft/azure-skills/appinsights-instrumentation.md): Guía para instrumentar aplicaciones web con Azure Application Insights: patrones de telemetría, configuración del SDK y referencias. Para añadirlo a tu app, usa azure-prepare. - [Azure App Onboard Prereq](https://skillsagentes.com/skills/microsoft/azure-skills/azure-app-onboard-prereq.md): Evalúa si tu código está listo para desplegar en Azure, antes del trabajo de infraestructura: salud del build, dependencias, compatibilidad del stack y bloqueantes de despliegue. - [Azure Cloud Migrate](https://skillsagentes.com/skills/microsoft/azure-skills/azure-cloud-migrate.md): Evalúa y migra cargas de trabajo de otras nubes a Azure con informes y conversión de código. Soporta Lambda→Functions, Beanstalk/Heroku/App Engine→App Service y Fargate/Kubernetes/Cloud Run→Container Apps. - [Azure Compute](https://skillsagentes.com/skills/microsoft/azure-skills/azure-compute.md): Router de VMs y VMSS de Azure. Cubre recomendar y comparar tamaños, crear y aprovisionar, reservas de capacidad (CRG) y Essential Machine Management (EMM). --- Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)