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 un elenco di modelli di avvio e opzioni complete dell'app di esempio. I modelli di avvio includono la struttura di cartelle essenziale, l'infrastruttura iniziale come file di codice e altri file di configurazione boilerplate per iniziare a creare modelli. I modelli di esempio completi includono anche il codice dell'applicazione segnaposto e i file necessari per distribuirli. Per questo modulo si apprenderà come creare un modello personalizzato anziché modificare il codice dell'app esistente, quindi scegliere l'opzione Starter - Bicep dall'elenco. 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:

    The starter template structure.

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:

  • .azdo: cartella contenente i file di configurazione iniziale .yml per CI/CD con Azure Pipelines.
  • .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.
  • .github: cartella contenente un modello di configurazione iniziale .yml per configurare una pipeline CI/CD tramite GitHub actions.
  • 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.

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.