Comece com o Azure Skills

Neste guia de início rápido, prepara, valida e implementa uma aplicação no Azure utilizando o Azure Skills.

Pré-requisitos

• Azure Skills instaladas (Instalar e configurar Azure Skills)
• CLI do Azure autenticado (az login concluído com sucesso)
• GitHub Copilot CLI ou código Claude pronto a usar
• Uma aplicação de exemplo (ou criar uma aplicação Node.js)

Scenario

Tem uma aplicação Node.js. Quer implementá-lo no Azure com:

• Web application hosting (Serviço de Aplicações do Azure)
• Uma conta de armazenamento para dados de aplicação
• Monitoramento com o Application Insights

Prepare a sua candidatura

No seu assistente de IA, vá ao diretório do seu projeto e pergunte:

Prepare my application for Azure deployment

A azure-prepare habilidade:

1. Analisa a sua base de código
2. Identifica a pilha tecnológica (Node.js, npm, e assim sucessivamente)
3. Cria .azure/plan.md com uma estratégia de implementação
4. Gera infraestrutura como código
5. Espera pela tua aprovação

Revise o plano gerado

Abra .azure/plan.md e reveja:

• Informação do Projeto—Nome da Aplicação e Modo de Implementação
• Requisitos — Classificação e escala (pequena, média, grande)
• Componentes — Tecnologias detetadas
• Estratégia de Implementação — Tecnologia usada para implementar a sua aplicação (Azure Developer CLI, Bicep, Terraform ou CLI do Azure).
• Arquitetura—Serviços do Azure selecionados
• Plano de Implementação — Tarefas passo a passo

Exemplo de conteúdo do plano:

# 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 parecer correto, diga ao seu assistente de IA:

Approve this plan and proceed to validation

A habilidade atualiza o estado do plano para Approved e avança para o passo seguinte.

Validar o plano de implementação

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

• Acesso e permissões ao CLI do Azure
• Sintaxe do modelo Bicep ou Terraform, se aplicável
• Subscripção e disponibilidade de regiões do Azure
• Limites das quotas de serviço
• Permissões necessárias para a sua conta

A validação termina e regista a prova de todas as verificações no plano. O estado do plano atualiza-se para Validated.

Rever os resultados da validação

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

• Comandos executados
• Data e Hora
• 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, reveja os erros e peça ao seu assistente de IA para corrigir os problemas:

Fix the validation errors and try again

Implementar no Azure

Quando o seu plano for validado, diga ao seu assistente de IA:

Deploy my application to Azure

A azure-deploy habilidade:

1. Confirma que o estado do plano é Validated
2. Provisiona recursos Azure (armazenamento, serviço de aplicações, monitorização)
3. Implementa o código da sua aplicação
4. Configura as definições da aplicação
5. Fornece o endpoint da sua aplicação

A implantação normalmente demora entre 3 a 5 minutos.

Veja a sua aplicação implementada

Após uma implementação bem-sucedida, o seu assistente de IA fornece:

• URL da aplicação (para App Service)
• Nome da conta de armazenamento e chaves de acesso
• Chave de instrumentação 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 a sua aplicação está a funcionar, visite o URL da sua aplicação num navegador.

Verifique a sua implementação

Teste a sua candidatura:

1. Visite o seu URL—Abra o URL da aplicação num navegador.
2. Verifique monitorização—Veja registos em Application Insights.
3. Funcionalidade de teste — Use as principais funcionalidades da sua aplicação.

Peça ao seu assistente de IA o estado de monitorização:

Show me the application logs and performance metrics

O seu assistente de IA consulta o Application Insights e apresenta atividades recentes, erros e dados de desempenho.

Atualizar e reimplantar

Se fizer alterações no código, reimplemente facilmente:

1. Atualiza o teu código no teu editor.

2. Pergunte ao seu assistente de IA:

   Update the deployment with my latest changes
   

3. A habilidade é executada azure-prepare para verificar alterações e depois azure-deploy para atualizar os seus recursos.

Recursos atualizados reutilizam infraestruturas existentes. Apenas os componentes alterados são redistribuídos.

Limpeza de recursos

Quando deixar de precisar da sua aplicação, elimine os recursos do Azure para evitar cobranças:

Delete all Azure resources for this application

O seu assistente de IA:

1. Lista recursos a serem eliminados (para tua confirmação)
2. Elimina o grupo de recursos e todo o conteúdo
3. Confirma limpeza concluída

Exemplo:

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

Are you sure? (yes/no)

Escreva yes para confirmar a eliminação.

Troubleshooting

A implementação falha com erro de autenticação

Problema: O seu assistente de IA não consegue autenticar-se a Azure.

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

Falha na validação do plano

Problema: O Azure Skills reporta erros de validação.

Solução: Pede ao teu assistente de IA para rever e corrigir problemas:

Why did validation fail? Fix the errors.

Aplicação não acessível após a implementação

Problema: O URL fornecido devolve um erro ou um tempo de expiração.

Solution:

1. Verifique se o URL está correto.

2. Espere 1-2 minutos pela propagação do DNS.

3. Verifique os registos do Application Insights para encontrar erros.

   Show me recent errors in Application Insights
   

Passos seguintes

• Documentação do Servidor do Model Context Protocol (MCP) Azure — Detalhes técnicos aprofundados