Creare un ambiente usando l'interfaccia della riga di comando per sviluppatori di Azure

  • Articolo

In questo articolo si installa l'interfaccia della riga di comando per sviluppatori di Azure (AZD), si crea un nuovo ambiente di distribuzione effettuando il provisioning dell'infrastruttura dell'app negli ambienti di distribuzione di Azure e distribuendo il codice dell'app nell'ambiente di distribuzione di cui è stato effettuato il provisioning.

L'interfaccia della riga di comando per sviluppatori di Azure è uno strumento open source che accelera il tempo necessario per ottenere l'applicazione dall'ambiente di sviluppo locale ad Azure. AZD offre procedure consigliate, comandi descrittivi per gli sviluppatori che eseguono il mapping alle fasi principali del flusso di lavoro, indipendentemente dal fatto che si stia lavorando nel terminale, nell'editor o nell'ambiente di sviluppo integrato (IDE) o CI/CD (integrazione continua/distribuzione continua).

Per informazioni su come configurare AZD per l'uso con ambienti di distribuzione di Azure, vedere Usare l'interfaccia della riga di comando per sviluppatori di Azure con ambienti di distribuzione di Azure.

Prerequisiti

È necessario effettuare le operazioni seguenti:

Preparare l'uso di AZD

Quando si usa AZD per la prima volta, è necessario completare alcune attività di configurazione monouso. Queste attività includono l'installazione dell'interfaccia della riga di comando per sviluppatori di Azure, l'accesso all'account Azure e l'abilitazione del supporto AZD per gli ambienti di distribuzione di Azure.

Installare l'estensione dell'interfaccia della riga di comando per sviluppatori di Azure per Visual Studio Code

Quando si installa azd, gli strumenti azd vengono installati all'interno dell'ambito azd anziché a livello globale e vengono rimossi se azd viene disinstallato. È possibile installare azd in Visual Studio Code o dalla riga di comando.

Per abilitare le funzionalità dell'interfaccia della riga di comando per sviluppatori di Azure in Visual Studio Code, installare l'estensione dell'interfaccia della riga di comando per sviluppatori di Azure versione v0.8.0-alpha.1-beta.3173884. Selezionare l'icona Estensioni nella barra attività, cercare l'interfaccia della riga di comando per sviluppatori di Azure e quindi selezionare Installa.

Screenshot di Visual Studio Code, che mostra il comando Accedi nel riquadro comandi.

Accedere con l'interfaccia della riga di comando per sviluppatori di Azure

Accedere alle risorse di Azure effettuando l'accesso. Quando si avvia un accesso, viene aperta una finestra del browser e viene richiesto di accedere ad Azure. Dopo l'accesso, il terminale visualizza un messaggio che indica che si è connessi ad Azure.

Accedere ad AZD usando il riquadro comandi:

Screenshot di Visual Studio Code, che mostra il riquadro Estensioni con l'interfaccia della riga di comando per sviluppatori di Azure e l'opzione Installa evidenziata.

L'output dei comandi emessi dal riquadro comandi viene visualizzato in un terminale azd dev come nell'esempio seguente:

Screenshot del terminale azd dev, che mostra la pressione di un tasto qualsiasi per chiudere il messaggio.

Abilitare il supporto AZD per ADE

È possibile configurare AZD per effettuare il provisioning e distribuire le risorse agli ambienti di distribuzione usando comandi standard, azd up ad esempio o azd provision. Quando platform.type è impostato su devcenter, tutti gli stati dell'ambiente remoto AZD e il provisioning usano i componenti di Dev Center. AZD usa uno dei modelli di infrastruttura definiti nel catalogo di Dev Center per il provisioning delle risorse. In questa configurazione la cartella infra nei modelli locali non viene usata.

Screenshot di Visual Studio Code, che mostra il comando Abilita supporto nel riquadro comandi.

Creare un ambiente da codice esistente

A questo momento è possibile creare un ambiente in cui lavorare. È possibile iniziare con il codice in una cartella locale oppure clonare un repository esistente. In questo esempio si crea un ambiente usando il codice in una cartella locale.

Inizializzare una nuova applicazione

L'inizializzazione di una nuova applicazione crea i file e le cartelle necessari per il funzionamento di AZD con l'applicazione.

AZD usa un file azure.yaml per definire l'ambiente. Il file azure.yaml definisce e descrive le app e i tipi di risorse di Azure usate dall'applicazione. Per altre informazioni su azure.yaml, vedere schema azure.yaml dell'interfaccia della riga di comando per sviluppatori di Azure.

  1. In Visual Studio Code aprire la cartella che contiene il codice dell'applicazione.

  2. Aprire il riquadro comandi e immettere init dell'interfaccia della riga di comando per sviluppatori di Azure, quindi nell'elenco selezionare l'interfaccia della riga di comando per sviluppatori di Azure (azd): init.

    Screenshot del riquadro comandi di Visual Studio Code con l'interfaccia della riga di comando per sviluppatori di Azure (azd): init evidenziata.

  3. Nell'elenco dei modelli, per continuare senza selezionare un modello, premere INVIO due volte.

  4. Nel terminale AZD selezionare Usa codice nella directory corrente.

    Screenshot del terminale AZD in Visual Studio Code, che mostra il prompt Usa codice nella directory corrente.

  5. azd init identifica i servizi definiti nel codice dell'app e richiede di confermare e continuare, rimuovere un servizio o aggiungere un servizio. Selezionare Conferma e continuare l'inizializzazione dell'app.

    Screenshot che mostra il prompt azD init per confermare e continuare, rimuovere un servizio o aggiungere un servizio.

  6. azd init continua a raccogliere informazioni per configurare l'app. Per questa applicazione di esempio viene richiesto il nome dell'istanza del database MongoDB e le porte su cui i servizi sono in ascolto.

    Screenshot che mostra il prompt azd init per un nome di database.

  7. Immettere un nome per l'ambiente AZD locale.

    Screenshot che mostra il prompt azd init Immettere un nuovo nome di ambiente.

  8. azd init visualizza un elenco dei progetti a cui si ha accesso. Selezionare il progetto per l'ambiente

    Screenshot che mostra azd init prompt Select project.

  9. azd init visualizza un elenco di definizioni di ambiente nel progetto. Selezionare una definizione di ambiente.

    Screenshot che mostra azd init prompt Select environment definitions (Selezionare le definizioni dell'ambiente).

    AZD crea le risorse del progetto, incluso un file azure.yaml nella radice del progetto.

Effettuare il provisioning dell'infrastruttura nell'ambiente di distribuzione di Azure

Quando si è pronti, è possibile effettuare il provisioning dell'ambiente locale in un ambiente di distribuzione di Azure remoto in Azure. Questo processo effettua il provisioning dell'infrastruttura e delle risorse definite nella definizione dell'ambiente nel catalogo di Dev Center.

  1. In Esplora risorse di Azure fare clic con il pulsante destro del mouse su azure.yaml e quindi selezionare l'interfaccia della riga di comando per sviluppatori di Azure (azd)>Provision di Risorse di Azure (provision).

    Screenshot di Visual Studio Code con azure.yaml evidenziato e il menu di scelta rapida AZD con l'interfaccia della riga di comando per sviluppatori di Azure e l'ambiente di provisioning evidenziati.

  2. AZD analizza gli ambienti di distribuzione di Azure per i progetti a cui si ha accesso. Nel terminale AZD selezionare o immettere le informazioni seguenti:

    1. Project
    2. Definizione dell'ambiente
    3. Tipo di ambiente
    4. Ufficio

  3. AZD indica ad ADE di creare un nuovo ambiente in base alle informazioni fornite nel passaggio precedente.

  4. È possibile visualizzare le risorse create nel portale di Azure o nel portale per sviluppatori.

Elencare gli ambienti esistenti (facoltativo)

Verificare che l'ambiente sia creato elencando gli ambienti esistenti.

  1. In Esplora risorse fare clic con il pulsante destro del mouse su azure.yaml e quindi selezionare l'interfaccia della riga di comando per sviluppatori di Azure (azd)>Visualizza ambienti locali e remoti (elenco env).

    Screenshot di Visual Studio Code con azure.yaml evidenziato e il menu di scelta rapida AZD con l'interfaccia della riga di comando per sviluppatori di Azure e Visualizza ambienti locali e remoti evidenziati.

    Viene richiesto di selezionare un progetto e una definizione di ambiente.

Distribuire il codice in ambienti di distribuzione di Azure

Quando viene effettuato il provisioning dell'ambiente, è possibile distribuire il codice nell'ambiente.

  1. In Explorer fare clic con il pulsante destro del mouse su azure.yaml e quindi selezionare l'interfaccia della riga di comando per sviluppatori di Azure (azd)>Deploy Azure Resources (deploy).

    Screenshot di Visual Studio Code con azure.yaml evidenziato e il menu di scelta rapida AZD con l'interfaccia della riga di comando per sviluppatori di Azure e Deploy to Azure evidenziata.

  2. È possibile verificare che il codice venga distribuito selezionando gli URL del punto finale elencati nel terminale AZD.

Pulire le risorse

Al termine dell'ambiente, è possibile eliminare le risorse di Azure.

In Esplora risorse fare clic con il pulsante destro del mouse su azure.yaml e quindi selezionare l'interfaccia della riga di comando per sviluppatori di Azure (azd)>Delete Deployment and Resources (down).

Screenshot di Visual Studio Code con azure.yaml evidenziato e il menu di scelta rapida AZD con l'interfaccia della riga di comando per sviluppatori di Azure e l'opzione Elimina distribuzione e risorse (giù) evidenziata.

Confermare di voler eliminare l'ambiente immettendo y quando richiesto.

Contenuto correlato