Introduzione alle competenze di Azure

In questa guida introduttiva si prepara, convalida e si distribuisce un'applicazione in Azure usando Azure Skills.

Prerequisiti

• Azure Skills installato (Installare e configurare Azure Skills)
• interfaccia della riga di comando di Azure autenticato (az login completato correttamente)
• GitHub Copilot CLI o Claude Code pronto per l'uso
• Un'applicazione di esempio (o creare un'app Node.js)

Scenario

È disponibile un'applicazione Node.js. Si vuole distribuirlo in Azure con:

• Hosting di applicazioni Web (Servizio app di Azure)
• Un account di archiviazione per i dati dell'applicazione
• Monitoraggio con Application Insights

Preparare l'applicazione

Nel tuo assistente AI, vai alla directory del progetto e chiedi:

Prepare my application for Azure deployment

Competenza azure-prepare :

1. Analizza la codebase
2. Identifica lo stack di tecnologie (Node.js, npm e così via)
3. Crea .azure/plan.md con una strategia di distribuzione
4. Genera l'infrastruttura come codice
5. Attende l'approvazione

Esaminare il piano generato

Apri .azure/plan.md ed esamina:

• Project Information- Nome applicazione e modalità di distribuzione
• Requisiti: classificazione e scalabilità (small, medium, large)
• Componenti: tecnologie rilevate
• Deployment Strategy: tecnologia usata per distribuire l'applicazione (interfaccia della riga di comando per sviluppatori Azure, Bicep, Terraform o interfaccia della riga di comando di Azure).
• Architecture: Azure servizi selezionati
• Piano di implementazione: attività dettagliate

Contenuto del piano di esempio:

# 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

Approvare il piano

Se il piano è corretto, indicare all'assistente di intelligenza artificiale:

Approve this plan and proceed to validation

La funzione aggiorna lo stato del piano a Approved e passa al passaggio successivo.

Convalidare il piano di distribuzione

L'assistente AI esegue la azure-validate funzione per verificare:

• Accesso e autorizzazioni di interfaccia della riga di comando di Azure
• Bicep o sintassi del modello di Terraform, se applicabile
• Disponibilità della sottoscrizione e della regione di Azure
• Limiti di quota del servizio
• Autorizzazioni necessarie per l'account

La convalida si conclude e tutti i controlli vengono documentati nel piano. Lo stato del piano viene aggiornato a Validated.

Esaminare i risultati della convalida

Controllare la sezione Prova di Convalida in .azure/plan.md, che mostra:

• Comandi eseguiti
• Marca temporale:
• Risultati (superati o non riusciti)

Esempio:

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

Se la convalida ha esito negativo, esaminare gli errori e chiedere all'assistente di intelligenza artificiale di risolvere i problemi:

Fix the validation errors and try again

Distribuire su Azure

Quando il piano viene convalidato, indicare all'assistente di intelligenza artificiale:

Deploy my application to Azure

Competenza azure-deploy :

1. Conferma che lo stato del piano è Validated
2. Effettua il provisioning di risorse Azure (archiviazione, servizio app, monitoraggio)
3. Distribuisce il codice dell'applicazione
4. Configura le impostazioni dell'applicazione
5. Fornisce l'endpoint dell'applicazione

La distribuzione richiede in genere 3-5 minuti.

Visualizzare l'applicazione distribuita

Dopo la corretta distribuzione, l'assistente per intelligenza artificiale fornisce:

• URL applicazione (per il servizio app)
• Nome e chiavi di accesso dell'account di archiviazione
• Chiave di strumentazione di Application Insights

Esempio:

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/...

Per verificare che l'app sia in esecuzione, visitare l'URL dell'applicazione in un browser.

Verificare la distribuzione

Testare l'applicazione:

1. Visitare l'URL: aprire l'URL dell'applicazione in un browser.
2. Controllare il monitoraggio: visualizzare i log in Application Insights.
3. Funzionalità di test: usare le funzionalità principali dell'app.

Chiedere all'assistente di intelligenza artificiale di monitorare lo stato:

Show me the application logs and performance metrics

L'assistente di intelligenza artificiale esegue query su Application Insights e visualizza le attività, gli errori e i dati sulle prestazioni recenti.

Aggiornare e ridistribuire

Se si apportano modifiche al codice, ridistribuire facilmente:

1. Aggiornare il codice nell'editor.

2. Chiedere all'assistente di intelligenza artificiale:

   Update the deployment with my latest changes
   

3. L'abilità viene eseguita azure-prepare per verificare la presenza di modifiche, quindi azure-deploy per aggiornare le risorse.

Le risorse aggiornate riutilizzano l'infrastruttura esistente. Solo i componenti modificati vengono ridistribuiti.

Pulire le risorse

Quando l'applicazione non è più necessaria, eliminare Azure risorse per evitare addebiti:

Delete all Azure resources for this application

Assistente di intelligenza artificiale:

1. Elenca le risorse da eliminare (per la conferma)
2. Elimina il gruppo di risorse e tutto il contenuto
3. Conferma il completamento della pulizia

Esempio:

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

Are you sure? (yes/no)

Digitare yes per confermare l'eliminazione.

Risoluzione dei problemi

La distribuzione ha esito negativo e viene visualizzato un errore di autenticazione

Problem: L'assistente di intelligenza artificiale non può eseguire l'autenticazione per Azure.

Soluzione: Ripetere l'autenticazione usando az login e riprovare.

La convalida del piano ha esito negativo

Problema: Azure Skills riporta errori di convalida.

Soluzione: Chiedere all'assistente di intelligenza artificiale di esaminare e risolvere i problemi:

Why did validation fail? Fix the errors.

Applicazione non accessibile dopo la distribuzione

Problema: L'URL fornito restituisce un errore o un timeout.

Soluzione:

1. Verificare che l'URL sia corretto.

2. Attendere 1-2 minuti per la propagazione DNS.

3. Controllare la presenza di errori nei log di Application Insights.

   Show me recent errors in Application Insights
   

Passaggi successivi

• Documentazione del server Azure Model Context Protocol (MCP)- Dettagli tecnici più approfonditi