azure-upgrade

Visão geral

O que é o azure-upgrade?

azure-upgrade é uma skill de upgrade guiado para workloads existentes no Azure. Ela é focada em mudanças in-place e quase in-place, como atualização de planos, camadas e SKUs ou movimentação entre serviços Azure relacionados, mantendo tudo dentro do Azure.

Casos de uso típicos incluem:

• Atualizar Azure Functions de Consumption para Flex Consumption
• Mover uma function app para um hosting plan ou service tier diferente
• Alterar o SKU de um serviço Azure existente
• Migrar de App Service para Azure Container Apps para workloads de backend

A skill combina um fluxo estruturado (Identify → Assess → Pre-migrate → Upgrade → Validate) com regras de segurança e orientações de boas práticas, para que você evolua aplicações em produção sem depender de tentativas e erros.

Para quem é o azure-upgrade?

azure-upgrade foi criado para:

• Desenvolvedores e engenheiros de DevOps responsáveis por serviços de backend no Azure
• Times de plataforma e operações de cloud que gerenciam mudanças de plano, camada ou SKU
• Equipes que estão padronizando em Flex Consumption ou modernizando de App Service para Container Apps

Se você precisa ajustar planos ou migrar para ofertas mais novas do Azure sem quebrar produção, esta skill oferece um caminho repetível e documentado.

Quais problemas o azure-upgrade resolve?

azure-upgrade ajuda você a:

• Avaliar a prontidão para upgrade antes de tocar em qualquer recurso em produção
• Planejar planos/camadas/SKUs de destino com base na configuração atual
• Automatizar etapas repetitivas de upgrade de acordo com regras definidas
• Acompanhar o progresso com um arquivo upgrade-status.md no seu repositório
• Evitar operações inseguras por meio de regras rígidas para ações destrutivas e confirmação do usuário

Esta skill é especificamente voltada a mudanças dentro do Azure. Ela não trata de migrações entre clouds; para esse cenário, use uma skill de migração separada, como azure-cloud-migrate.

Quando o azure-upgrade é uma boa opção?

Use azure-upgrade quando:

• Você está atualizando um app do Azure Functions em execução para Flex Consumption
• Você quer mudar a camada de hospedagem ou o SKU de um workload existente
• Você está migrando um app de App Service para Azure Container Apps
• Você precisa de um processo rastreável, baseado em fases, para upgrades operacionais no Azure

Pode não ser a melhor opção quando:

• Você está movendo workloads para fora do Azure (migração entre clouds)
• Você está configurando um app totalmente novo, sem recursos existentes
• Você só precisa de automação de pipeline de CI/CD (melhor atendido por skills como azure-deploy)

Se sua principal preocupação é rollout seguro, opções de rollback e paridade de configuração durante upgrades no Azure, o azure-upgrade é alinhado exatamente a esse trabalho.

Como usar

1. Instalação e configuração

Para adicionar a skill azure-upgrade a partir do repositório microsoft/azure-skills, use o skills CLI no ambiente do seu agente:

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

Depois de instalar, explore os arquivos principais que definem como a skill funciona:

• SKILL.md – descrição em alto nível, gatilhos e regras
• references/global-rules.md – regras de segurança e boas práticas
• references/workflow-details.md – detalhes das fases do fluxo e orientações de acompanhamento de status

Certifique-se de que seu agente esteja configurado com acesso às ferramentas Azure MCP relevantes, como mcp_azure_mcp_get_bestpractices e mcp_azure_mcp_documentation, conforme referenciado nas regras da skill.

2. Entenda o fluxo de upgrade

azure-upgrade segue uma sequência prescrita:

1. Identify – Especificar o recurso de origem (por exemplo, plano atual do Functions) e o plano, camada ou SKU de destino.
2. Assess – Gerar uma avaliação de prontidão para upgrade e compatibilidade.
3. Pre-migrate – Coletar app settings, configuração, dependências e detalhes de conectividade.
4. Upgrade – Executar as etapas automatizadas para aplicar o novo plano/camada/SKU ou criar o novo recurso de destino.
5. Validate – Verificar se o app atualizado está funcional e pronto para receber tráfego.

As regras aplicadas pela skill exigem que as fases sejam seguidas na ordem correta. Pular a avaliação ou os passos de pré-migração é explicitamente desencorajado, o que ajuda a manter mudanças em produção seguras e previsíveis.

3. Acompanhe o progresso com upgrade-status.md

O fluxo usa um arquivo simples, localizado no repositório, para tornar os upgrades auditáveis e compartilháveis pelo time.

Crie upgrade-status.md na raiz do seu workspace usando a estrutura documentada em references/workflow-details.md. No mínimo, ele deve registrar:

• Nome do app de origem e plano atual
• Plano ou serviço de destino
• Resource group e região
• Data de início
• Um checklist das fases do fluxo (Identify, Assess, Pre-migrate, Upgrade, Validate)
• Notas sobre problemas, decisões e erros

Atualize esse arquivo à medida que o agente avança em cada fase. Se uma fase falhar, registre o erro e resolva-o antes de prosseguir.

4. Respeite as regras globais de segurança

O arquivo references/global-rules.md define os guardrails obrigatórios do azure-upgrade, incluindo:

• Destructive Action Policy – O agente não deve excluir apps, serviços, resource groups ou modificar DNS/domínios personalizados sem confirmação explícita via ask_user.
• Verificações de confirmação do usuário – Seleção de subscriptions ou regiões, criação de novos recursos e alteração de restrições de rede devem sempre passar por aprovação explícita do usuário.
• Boas práticas – A skill favorece managed identities, runtimes modernos e manter o recurso original em execução até que o recurso atualizado esteja totalmente validado.

Ao customizar ou estender fluxos de trabalho, mantenha essas regras intactas para que sua automação continue segura em ambientes de produção.

5. Execute cenários comuns de upgrade

Depois de instalada, você interage com o azure-upgrade por meio de intenções em linguagem natural que correspondem aos gatilhos definidos em SKILL.md. Exemplos de prompts que você pode passar para seu agente incluem:

• "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."

A skill irá:

1. Interpretar sua intenção como um cenário de upgrade.
2. Carregar as referências de cenário relevantes e as regras globais.
3. Usar ferramentas Azure MCP para documentação e checagens de boas práticas.
4. Propor ou gerar as etapas de upgrade, pedindo confirmação antes de qualquer mudança impactante.

6. Encaminhe para skills relacionadas

Após um upgrade bem-sucedido e validado, o azure-upgrade permite um hand-off limpo para outras skills focadas em Azure:

• azure-validate – para validação e testes pós-upgrade mais aprofundados.
• azure-deploy – para configurar ou aprimorar pipelines de CI/CD em torno dos recursos recém-atualizados.

Isso mantém o azure-upgrade focado no fluxo de change management, ao mesmo tempo em que se encaixa em um ecossistema mais amplo de automação.

FAQ

O azure-upgrade é adequado para workloads em produção?

Sim, o azure-upgrade foi projetado para uso em produção. As regras globais exigem explicitamente:

• Execução baseada em fases (sem pular a etapa de avaliação)
• Confirmação para ações destrutivas ou irreversíveis
• Manter o app/serviço original em execução até que a versão atualizada esteja totalmente validada

Quando usado conforme previsto e combinado com seus próprios controles de change management, ele suporta upgrades seguros em ambientes de produção.

O azure-upgrade trata migrações entre clouds?

Não. O azure-upgrade é focado em upgrades dentro do Azure, como mudanças de plano, camada e SKU ou migrações entre serviços Azure, como App Service e Container Apps. Para mover workloads entre clouds, você deve usar uma skill de migração dedicada, como azure-cloud-migrate.

Quais serviços do Azure posso atualizar com o azure-upgrade?

A skill é voltada para workloads existentes, como:

• Apps do Azure Functions (por exemplo, Consumption → Flex Consumption)
• Apps em execução no Azure App Service
• Workloads que você deseja mover para Azure Container Apps

Como as regras de base focam em planos, camadas e SKUs, ela é particularmente útil sempre que você precisa modernizar a hospedagem ou ajustar a capacidade de serviços de backend.

Como o azure-upgrade acompanha o que já foi feito?

A skill depende de um arquivo upgrade-status.md no seu repositório, conforme descrito em references/workflow-details.md. Esse arquivo registra:

• Detalhes principais dos recursos
• Status de conclusão de cada fase
• Erros e notas de correção

Esse mecanismo simples torna os upgrades auditáveis e fáceis de revisar, mesmo quando vários membros do time ou agentes estão envolvidos.

O azure-upgrade vai excluir meus recursos originais?

Não, sem aprovação explícita. references/global-rules.md define uma Destructive Action Policy rigorosa:

• Exclusão de apps, serviços ou resource groups
• Interrupção ou desativação de serviços originais
• Modificação de DNS ou bindings de domínios personalizados

Todas essas ações exigem confirmação explícita via ask_user. Você continua no controle de quando (ou se) descomissionar os recursos originais após um upgrade bem-sucedido.

Posso customizar o fluxo de trabalho do azure-upgrade?

Você pode adaptar como usa o fluxo (por exemplo, integrando o arquivo de status aos seus próprios processos ou combinando-o com outras ferramentas internas), mas as fases definidas e as regras de segurança existem para manter os upgrades previsíveis e seguros. Se você estender ou encapsular o azure-upgrade, preserve:

• A sequência Identify → Assess → Pre-migrate → Upgrade → Validate
• As regras globais para ações destrutivas e confirmações

Isso garante que qualquer automação customizada continue se beneficiando dos guardrails embutidos.

Como o azure-upgrade se encaixa em pipelines de CI/CD?

azure-upgrade é focado em mudanças operacionais pontuais ou periódicas em recursos existentes. Depois de concluir um upgrade e validação, ele pode fazer hand-off para o azure-deploy para:

• Configurar ou atualizar pipelines de CI/CD
• Alinhar fluxos de deployment ao novo plano, camada ou serviço

Use o azure-upgrade para alterar com segurança as características de infraestrutura e, em seguida, conte com skills focadas em pipeline para os deployments contínuos.

O que eu preciso antes de usar o azure-upgrade?

Antes de executar o azure-upgrade, garanta que você tenha:

• Acesso à subscription e ao resource group de destino no Azure
• Clareza sobre o plano/camada/SKU ou serviço de destino desejado (por exemplo, Container Apps)
• Um ambiente de agente configurado com a skill azure-upgrade e as ferramentas Azure MCP

Ter essas informações prontas ajuda o agente a concluir rapidamente as fases de Identify e Assess e reduz o vai e vem de confirmações.