azure-upgrade

Descripción general

¿Qué es azure-upgrade?

azure-upgrade es una skill de actualización guiada para cargas de trabajo existentes en Azure. Está centrada en cambios in situ o casi in situ, como actualizar planes, niveles y SKUs, o mover cargas entre servicios de Azure estrechamente relacionados manteniéndote dentro de Azure.

Los casos de uso habituales incluyen:

• Actualizar Azure Functions de Consumption a Flex Consumption
• Mover una function app a un hosting plan o service tier diferente
• Cambiar el SKU de un servicio de Azure existente
• Migrar de App Service a Azure Container Apps para cargas de backend

La skill combina un flujo de trabajo estructurado (Identify → Assess → Pre-migrate → Upgrade → Validate) con reglas de seguridad y recomendaciones de mejores prácticas, para que puedas evolucionar aplicaciones en producción sin improvisaciones.

¿Para quién está pensado azure-upgrade?

azure-upgrade está diseñado para:

• Desarrolladores e ingenieros de DevOps responsables de servicios backend basados en Azure
• Equipos de plataforma y operaciones cloud que gestionan cambios de plan, nivel o SKU
• Equipos que se están estandarizando en Flex Consumption o modernizando de App Service a Container Apps

Si necesitas ajustar planes o moverte a ofertas más recientes de Azure sin romper producción, esta skill te proporciona un camino repetible y documentado.

¿Qué problemas resuelve azure-upgrade?

azure-upgrade te ayuda a:

• Evaluar la preparación para la actualización antes de tocar cualquier recurso en producción
• Planificar los planes/niveles/SKUs destino en función de tu configuración actual
• Automatizar pasos repetitivos de la actualización siguiendo reglas definidas
• Hacer seguimiento del progreso con un archivo upgrade-status.md en tu repo
• Evitar operaciones inseguras mediante reglas estrictas para acciones destructivas y confirmación del usuario

Esta skill está pensada específicamente para cambios dentro de Azure. No gestiona migraciones entre nubes; para ese escenario deberías usar una skill de migración independiente como azure-cloud-migrate.

¿Cuándo es buena opción usar azure-upgrade?

Usa azure-upgrade cuando:

• Estás actualizando una Azure Functions app en ejecución a Flex Consumption
• Quieres cambiar el hosting tier o el SKU de una carga de trabajo existente
• Estás migrando una aplicación de App Service a Azure Container Apps
• Necesitas un proceso trazable y por fases para actualizaciones operativas en Azure

Puede que no sea la mejor opción cuando:

• Estás moviendo cargas fuera de Azure (migración entre nubes)
• Estás configurando una aplicación totalmente nueva sin recursos existentes
• Solo necesitas automatización de pipelines CI/CD (para eso encajan mejor skills como azure-deploy)

Si tu principal preocupación es el despliegue seguro, las opciones de rollback y mantener la paridad de configuración durante las actualizaciones de Azure, azure-upgrade está alineado con ese trabajo.

Cómo usarlo

1. Instalación y configuración

Para agregar la skill azure-upgrade desde el repositorio microsoft/azure-skills, utiliza la CLI de skills en el entorno de tu agente:

npx skills add https://github.com/microsoft/azure-skills --skill azure-upgrade

Una vez instalada, revisa los archivos clave que definen cómo funciona la skill:

• SKILL.md – descripción general, triggers y reglas
• references/global-rules.md – reglas de seguridad y mejores prácticas
• references/workflow-details.md – detalle de las fases del flujo de trabajo y guía para el seguimiento de estado

Asegúrate de que tu agente esté configurado con acceso a las Azure MCP tools relevantes, como mcp_azure_mcp_get_bestpractices y mcp_azure_mcp_documentation, tal y como se hace referencia en las reglas de la skill.

2. Entender el flujo de trabajo de actualización

azure-upgrade sigue una secuencia definida:

1. Identify – Aclarar el recurso de origen (por ejemplo, el plan actual de Functions) y el plan, nivel o SKU de destino.
2. Assess – Generar una evaluación sobre la preparación y compatibilidad de la actualización.
3. Pre-migrate – Recopilar app settings, configuración, dependencias y detalles de conectividad.
4. Upgrade – Ejecutar los pasos automatizados para aplicar el nuevo plan/nivel/SKU o crear el nuevo recurso de destino.
5. Validate – Verificar que la aplicación actualizada funciona correctamente y está lista para recibir tráfico.

Las reglas que aplica la skill exigen seguir las fases en orden. Saltarse la evaluación o los pasos de pre-migración está explícitamente desaconsejado, lo que ayuda a mantener los cambios en producción seguros y previsibles.

3. Hacer seguimiento del progreso con upgrade-status.md

El flujo de trabajo utiliza un archivo de seguimiento sencillo, local al repo, para que las actualizaciones sean auditables y fáciles de compartir en el equipo.

Crea upgrade-status.md en la raíz de tu workspace siguiendo la estructura descrita en references/workflow-details.md. Como mínimo, debería incluir:

• Nombre de la app de origen y plan actual
• Plan o servicio de destino
• Resource group y región
• Fecha de inicio
• Una checklist de las fases del flujo de trabajo (Identify, Assess, Pre-migrate, Upgrade, Validate)
• Notas sobre incidencias, decisiones y errores

Actualiza este archivo a medida que el agente avance por cada fase. Si una fase falla, registra el error y resuélvelo antes de continuar.

4. Respetar las reglas globales de seguridad

El archivo references/global-rules.md define los límites innegociables para azure-upgrade, entre ellos:

• Destructive Action Policy – El agente no debe eliminar apps, servicios, resource groups, ni modificar DNS/dominios personalizados sin confirmación explícita mediante ask_user.
• Comprobaciones de confirmación del usuario – La selección de suscripciones o regiones, la creación de nuevos recursos y los cambios en restricciones de red deben pasar por una aprobación explícita del usuario.
• Mejores prácticas – La skill prioriza managed identities, runtimes modernos y mantener el recurso original en funcionamiento hasta que la versión actualizada esté completamente validada.

Si personalizas o amplías los flujos de trabajo, mantén estas reglas intactas para que tu automatización siga siendo segura en entornos de producción.

5. Ejecutar escenarios de actualización habituales

Una vez instalada, interactúas con azure-upgrade mediante instrucciones en lenguaje natural que coinciden con los triggers definidos en SKILL.md. Ejemplos de prompts que puedes darle a tu agente:

• "Assess if my function app is ready to move from Consumption to Flex Consumption."
• "Automate the upgrade of my Functions plan to Flex Consumption in the same resource group."
• "Help me migrate this App Service API to Azure Container Apps and validate it before cutover."
• "Change the hosting plan for this function app and document each step in upgrade-status.md."

La skill entonces:

1. Interpretará tu intención como un escenario de actualización.
2. Cargará las referencias de escenario relevantes y las global rules.
3. Usará Azure MCP tools para documentación y comprobaciones de mejores prácticas.
4. Propondrá o generará pasos de actualización, solicitando confirmación antes de cualquier cambio de impacto.

6. Encadenar con skills relacionadas

Tras una actualización y validación correctas, azure-upgrade permite una integración limpia con otras skills centradas en Azure:

• azure-validate – para validaciones y pruebas más profundas después de la actualización.
• azure-deploy – para configurar o afinar pipelines CI/CD alrededor de tus recursos recién actualizados.

De este modo, azure-upgrade se centra en el flujo de trabajo de gestión del cambio, sin dejar de encajar en un ecosistema de automatización más amplio.

Preguntas frecuentes

¿azure-upgrade es adecuado para cargas de trabajo en producción?

Sí, azure-upgrade está pensado para uso en producción. Las global rules exigen explícitamente:

• Ejecución por fases (sin saltarse la evaluación)
• Confirmación para acciones destructivas o irreversibles
• Mantener la app/servicio original en funcionamiento hasta que la versión actualizada esté completamente validada

Cuando se usa según lo previsto y se combina con tus propios controles de gestión del cambio, permite realizar actualizaciones seguras en entornos de producción.

¿azure-upgrade gestiona migraciones entre nubes?

No. azure-upgrade está centrado en actualizaciones dentro de Azure, como cambios de plan, nivel y SKU, o migraciones entre servicios de Azure como App Service y Container Apps. Para mover cargas entre nubes deberías utilizar una skill de migración específica, como azure-cloud-migrate.

¿Qué servicios de Azure puedo actualizar con azure-upgrade?

La skill está orientada a cargas de trabajo existentes, como:

• Azure Functions apps (por ejemplo, Consumption → Flex Consumption)
• Apps que se ejecutan en Azure App Service
• Cargas que quieres mover a Azure Container Apps

Como las reglas subyacentes se centran en planes, niveles y SKUs, resulta especialmente útil cuando necesitas modernizar el hosting o ajustar la capacidad de servicios backend.

¿Cómo lleva el control azure-upgrade de lo que ya se ha hecho?

La skill se basa en un archivo upgrade-status.md en tu repositorio, tal y como se describe en references/workflow-details.md. Este archivo registra:

• Detalles clave de los recursos
• Estado de finalización de cada fase
• Errores y notas de remediación

Este mecanismo sencillo hace que las actualizaciones sean auditables y fáciles de revisar, incluso si participan varios miembros del equipo o distintos agentes.

¿azure-upgrade eliminará mis recursos originales?

No sin aprobación explícita. references/global-rules.md define una Destructive Action Policy estricta para:

• Eliminar apps, servicios o resource groups
• Detener o deshabilitar servicios originales
• Modificar DNS o bindings de dominios personalizados

Todas estas acciones requieren confirmación explícita mediante ask_user. Tú decides cuándo (o si) desmantelar los recursos originales después de una actualización satisfactoria.

¿Puedo personalizar el flujo de trabajo de azure-upgrade?

Puedes adaptar cómo usas el flujo de trabajo (por ejemplo, integrando el archivo de estado con tus propios procesos o combinándolo con otras herramientas internas), pero las fases definidas y las reglas de seguridad están ahí para mantener las actualizaciones predecibles y seguras. Si amplías o envuelves azure-upgrade, conserva:

• La secuencia Identify → Assess → Pre-migrate → Upgrade → Validate
• Las global rules para acciones destructivas y confirmaciones

Así te aseguras de que cualquier automatización personalizada siga beneficiándose de las protecciones integradas.

¿Cómo encaja azure-upgrade con los pipelines CI/CD?

azure-upgrade se centra en cambios operativos puntuales o periódicos sobre recursos existentes. Tras completar una actualización y su validación, puede ceder el control a azure-deploy para:

• Configurar o actualizar pipelines CI/CD
• Alinear los flujos de despliegue con el nuevo plan, nivel o servicio

Utiliza azure-upgrade para cambiar de forma segura las características de infraestructura y confía en las skills orientadas a pipelines para los despliegues continuos.

¿Qué necesito antes de usar azure-upgrade?

Antes de ejecutar azure-upgrade, asegúrate de tener:

• Acceso a la suscripción de Azure y al resource group de destino
• Claridad sobre el plan/nivel/SKU o servicio de destino que quieres (por ejemplo, Container Apps)
• Un entorno de agente configurado con la skill azure-upgrade y las Azure MCP tools

Contar con esta información de antemano ayudará al agente a completar rápidamente las fases de Identify y Assess y reducirá las idas y vueltas de confirmación.