Aggiornare il file azure.yaml

Completato

Il modello include il codice sorgente per l'app e definisce i file Bicep per creare l'infrastruttura corrispondente. Tuttavia, il modello deve comunque descrivere la relazione tra il codice sorgente dell'app e le risorse di Azure. È possibile usare il file azure.yaml per descrivere uno o più servizi app nella codebase e come devono essere distribuiti nelle risorse di Azure di cui è stato effettuato il provisioning.

  1. Nella radice del progetto individuare e aprire il file azure.yaml. Il file contiene vari commenti di codice che forniscono indicazioni ed esempi utili su come definire i servizi. Le definizioni dei servizi abbinano una cartella del codice sorgente a una risorsa di Azure usando una struttura YAML standard.

  2. Copiare e incollare la definizione seguente nella parte inferiore del file azure.yaml:

    services:
        web:
            language: csharp
            project: ./src/web
            host: appservice
    

    Ogni riga di codice in questo schema di esempio descrive un aspetto diverso dei servizi nell'app:

    • services: ogni file azure.yaml definisce il nodo services di primo livello che elenca uno o più servizi inclusi nel modello.
    • web: un nome a scelta che si abbina a un servizio nel codice dell'app, ad esempio api o worker. Tuttavia, questo nome deve corrispondere al valore del tag azd-service-name assegnato alla risorsa nel codice Bicep o Terraform. Ad esempio, questo servizio ha un valore web perché la definizione di servizio app nel file app.bicep specifica tags: { 'azd-service-name': 'web' }. Questa associazione di denominazione dei tag è il modo in cui azd identifica la risorsa di Azure in cui distribuire la directory di codice specificata.
    • language: una proprietà che specifica il linguaggio del codice da distribuire. azd supporta attualmente i valori dei linguaggi csharp, python, javascript e java.
    • project: una proprietà che imposta il percorso in cui è archiviato il codice per il servizio.
    • host: una proprietà che definisce il tipo di servizio di Azure in cui viene distribuita l'app.

    Nota

    Anche in questo caso, assicurarsi che il nome del servizio (in questo caso: web) in azure.yaml corrisponda al tag azd-service-name nella risorsa host corrispondente definita nel file Bicep.

Una volta completato azure.yaml, saranno stati implementati tutti i principali componenti strutturali del modello. Nell'unità successiva si apprenderà come effettuare il provisioning e distribuire le risorse del modello in Azure.