Creare la struttura del modello

  • 6 minuti

L'interfaccia della riga di comando per sviluppatori di Azure (azd) consente di creare nuovi modelli per le app usando il comando azd init e i modelli di avvio. In questa unità si creerà lo scaffolding o la struttura di base di un nuovo modello che verrà compilato per il resto del modulo.

  1. In una directory vuota nel computer locale eseguire il comando azd init.

    azd init

  2. L'output del comando visualizza tre diverse opzioni per inizializzare un modello di azd:

  • Usa il codice nella directory corrente: Analizza il codice della tua app per creare e configurare automaticamente determinati asset di modello per te.

  • Selezionare un modello: scegliere un modello di avvio esistente che include la struttura di cartelle essenziale, l'infrastruttura di avvio come file di codice e altri file di configurazione boilerplate per semplificare i modelli di compilazione.

  • Creare un progetto minimo: genera i file di configurazione minimi da iniziare.

    Leggi di più su queste diverse opzioni nella documentazione Panoramica dei modelli CLI per sviluppatori Azure.

  1. Scegliere l'opzione Selezionare un modello e azd visualizza un elenco preconfigurato di modelli disponibili.

  2. Cercare Starter e quindi selezionare l'opzione Starter - Bicep nell'elenco dei risultati. L'interfaccia della riga di comando per sviluppatori di Azure supporta anche l'uso di Terraform se si preferisce tale opzione. Il supporto di Terraform è attualmente in alfa e deve essere abilitato manualmente.

  3. Quando viene richiesto un nome di ambiente, immettere azdlearn o un nome di propria scelta. Il nome dell'ambiente influisce sulla denominazione delle risorse di cui è stato effettuato il provisioning in Azure.

  4. Viene creato un set di cartelle all'interno della directory corrente:

    Struttura del modello iniziale.

Nota

Si potrebbe aver notato che il comando azd init fornisce anche un modello di progetto denominato Minimal, che contiene la struttura del modello più semplice possibile. Tuttavia, il modello Starter - Bicep selezionato include codice di scaffolding aggiuntivo molto utile ma ancora indipendente dalla tecnologia, quindi spesso è un'ottima scelta per iniziare.

Le cartelle generate forniscono tutti i blocchi predefiniti essenziali di un modello azd:

  • .azure: cartella contenente le impostazioni essenziali per l'ambiente Azure del modello, ad esempio il nome dell'ambiente.
  • .devcontainer: cartella contenente i file di configurazione usati per eseguire il modello in un ambiente contenitore di sviluppo.
  • infra : cartella contenente i file Bicep iniziali per l'infrastruttura del modello come codice. Se è stato selezionato il modello di avvio Terraform, questa cartella contiene invece i file Terraform.
  • azure.yaml: file che descrive come le parti dell'applicazione eseguono il mapping ai servizi in Azure.
  • .gitignore - Un file .gitignore iniziale per escludere i file indesiderati dal controllo della versione Git.
  • README.md: file README iniziale che fornisce indicazioni generali per l'utente finale del modello.

Questo modello di avvio contiene la maggior parte di ciò che è necessario creare un modello azd personalizzato. Nelle prossime unità si apprenderà come aggiornare questi file esistenti e aggiungere nuovi asset per creare un modello completo.