Introdução às habilidades de Azure

Neste início rápido, você prepara, valida e implanta um aplicativo para Azure usando Azure Skills.

Pré-requisitos

• Azure Skills instalado (Instale e configure Azure Skills)
• CLI do Azure autenticado (az login concluído com êxito)
• GitHub Copilot CLI ou Código Claude pronto para uso
• Um aplicativo de exemplo (ou criar um aplicativo Node.js)

Scenario

Você tem um aplicativo Node.js. Você deseja implantá-lo no Azure com:

• Hospedagem de aplicativo Web (Serviço de Aplicativo do Azure)
• Uma conta de armazenamento para dados do aplicativo
• Monitoramento com o Application Insights

Preparar seu aplicativo

No assistente de IA, acesse o diretório do projeto e pergunte:

Prepare my application for Azure deployment

A azure-prepare habilidade:

1. Analisa sua base de código
2. Identifica a pilha de tecnologia (Node.js, npm, entre outros)
3. Cria .azure/plan.md com uma estratégia de implantação
4. Gera infraestrutura como código
5. Aguarda sua aprovação

Examinar o plano gerado

Abra .azure/plan.md e examine:

• Project Information — Nome do aplicativo e modo de implantação
• Requisitos – Classificação e escala (pequeno, médio, grande)
• Componentes — tecnologias detectadas
• Deployment Strategy — tecnologia usada para implantar seu aplicativo (CLI do Desenvolvedor Azure, Bicep, Terraform ou CLI do Azure).
• Architecture — serviços Azure selecionados
• Plano de Implementação – tarefas passo a passo

Conteúdo do plano de exemplo:

# Azure Deployment Plan

## Project Information
- Application: my-app
- Mode: NEW

## Requirements
- Classification: Web Application
- Scale: Small
- Environment: Production

## Components
- Runtime: Node.js 18+
- Package Manager: NPM
- Application Type: Express web server

## Recipe
- Type: AZD (Azure Developer CLI)

## Azure Services
- Azure App Service (web app hosting)
- Azure Storage Account (data)
- Application Insights (monitoring)

## Status: Awaiting Approval

Aprovar o plano

Se o plano estiver correto, informe ao assistente de IA:

Approve this plan and proceed to validation

A habilidade atualiza o status do plano para Approved e passa para a próxima etapa.

Validar o plano de implantação

Seu assistente de IA executa a azure-validate habilidade para verificar:

• CLI do Azure acesso e permissões
• sintaxe de modelo Bicep ou Terraform, se aplicável
• Disponibilidade de assinaturas e de regiões do Azure
• Limites de cota de serviço
• Permissões necessárias para sua conta

A validação termina e registra a comprovação de todas as verificações no plano. O status do plano foi atualizado para Validated.

Examinar os resultados da validação

Verifique .azure/plan.md a seção Prova de Validação , que mostra:

• Comandos executados
• Timestamp
• Resultados (aprovados ou reprovados)

Exemplo:

## Validation Proof
- Command: azd provision --preview
- Timestamp: 2026-03-16T14:22:00Z
- Result: ✓ All validation checks passed

Se a validação falhar, examine os erros e peça ao assistente de IA para corrigir problemas:

Fix the validation errors and try again

Implantar no Azure

Quando o plano for validado, informe ao assistente de IA:

Deploy my application to Azure

A(s) azure-deploy habilidade(s):

1. Confirma se o status do plano é Validated
2. Provisiona recursos Azure (armazenamento, serviço de aplicativo, monitoramento)
3. Implanta o seu código do aplicativo
4. Define as configurações do aplicativo
5. Fornece o ponto de extremidade do aplicativo

A implantação normalmente leva de 3 a 5 minutos.

Exibir seu aplicativo implantado

Após a implantação bem-sucedida, o assistente de IA fornece:

• URL do aplicativo (para o Serviço de Aplicativo)
• Nome da conta de armazenamento e chaves de acesso
• Chave de instrumentação do Application Insights

Exemplo:

Deployment complete! 

Your app is live at: https://my-app-abcd1234.azurewebsites.net

Resources deployed:
- App Service: my-app-prod
- Storage Account: mystorageabcd1234
- Application Insights: my-app-insights

Monitor your app: https://portal.azure.com/...

Para verificar se o aplicativo está em execução, visite a URL do aplicativo em um navegador.

Verificar sua implantação

Teste seu aplicativo:

1. Visite sua URL — Abra a URL do aplicativo em um navegador.
2. Verificar monitoramento — exibir logs no Application Insights.
3. Funcionalidade de teste : use os principais recursos do seu aplicativo.

Peça ao assistente de IA o status de monitoramento:

Show me the application logs and performance metrics

Seu assistente de IA consulta o Application Insights e exibe dados recentes de atividade, erros e desempenho.

Atualizar e reimplantar

Se você fizer alterações de código, reimplante facilmente:

1. Atualize seu código em seu editor.

2. Pergunte ao assistente de IA:

   Update the deployment with my latest changes
   

3. A habilidade roda azure-prepare para verificar alterações e, em seguida, azure-deploy para atualizar seus recursos.

Recursos atualizados reutilizam a infraestrutura existente. Somente os componentes alterados são reimplantados.

Limpar os recursos

Quando você não precisar mais do aplicativo, exclua Azure recursos para evitar encargos:

Delete all Azure resources for this application

Seu assistente de IA:

1. Lista os recursos a serem excluídos (para sua confirmação)
2. Exclui o grupo de recursos e todo o conteúdo
3. Confirma a limpeza concluída

Exemplo:

Resources to delete:
- Resource Group: my-app-rg
- All contained resources

Are you sure? (yes/no)

Digite yes para confirmar a exclusão.

Solução de problemas

Falha na implantação com erro de autenticação

Problem: seu assistente de IA não pode se autenticar no Azure.

Solução: Reautenticar usando az login e tente novamente.

Falha na validação do plano

Problem: Azure Skills relata erros de validação.

Solução: Peça ao assistente de IA para examinar e corrigir problemas:

Why did validation fail? Fix the errors.

Aplicativo não acessível após a implantação

Problema: A URL fornecida retorna um erro ou atinge o tempo limite.

Solution:

1. Verifique se a URL está correta.

2. Aguarde de 1 a 2 minutos para propagação de DNS.

3. Verifique se há erros nos logs do Application Insights.

   Show me recent errors in Application Insights
   

Próximas Etapas 

• Servidor MCP (Model Context Protocol) da Azure — detalhes técnicos mais profundos