Aktualisieren der Datei „azure.yaml“

Abgeschlossen

Ihre Vorlage enthält den Quellcode für Ihre App und definiert Bicep-Dateien, um die entsprechende Infrastruktur zu erstellen. Ihre Vorlage muss jedoch weiterhin die Beziehung zwischen dem App-Quellcode und den Azure-Ressourcen beschreiben. Sie können die azure.yaml-Datei verwenden, um einen oder mehrere App-Dienste in Ihrer Codebasis zu beschreiben und zu erläutern, wie sie für die bereitgestellten Azure-Ressourcen bereitgestellt werden sollen.

  1. Suchen Sie im Stammverzeichnis Ihres Projekts nach der azure.yaml-Datei, und öffnen Sie sie. Die Datei enthält verschiedene Codekommentare, die hilfreiche Anleitungen und Beispiele für die Definition von Diensten bieten. Dienstdefinitionen ordnen einen Ordner in Ihrem Quellcode einer Ressource in Azure mithilfe einer standardisierten YAML-Struktur zu.

  2. Kopieren Sie die folgende Definition, und fügen Sie sie unten in der azure.yaml-Datei ein:

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

    Jede Codezeile in diesem Beispielschema beschreibt einen anderen Aspekt der Dienste in Ihrer App:

    • services: Jede azure.yaml-Datei definiert einen services-Knoten der obersten Ebene, der einen oder mehrere Dienste in Ihrer Vorlage auflistet.
    • web: ein Name Ihrer Wahl, der einem Dienst in Ihrem App-Code zugeordnet ist, z. B. api oder worker. Dieser Name muss jedoch mit dem Wert des azd-service-name-Tags übereinstimmen, das Sie der Ressource in Ihrem Bicep- oder Terraform-Code zugewiesen haben. Beispielsweise weist dieser Dienst den Wert web auf, da die App Service-Definition in der app.bicep-Datei tags: { 'azd-service-name': 'web' } angegeben hat. Durch diese Tagnamenszuordnung versteht azd, in welcher Azure-Ressource das angegebene Codeverzeichnis bereitgestellt werden soll.
    • language: Dies ist eine Eigenschaft, die die Sprache des Codes angibt, den Sie bereitstellen möchten. azd unterstützt derzeit die Sprachwerte csharp, python, javascript und java.
    • project: Dies ist eine Eigenschaft, die den Pfad zum Speicherort des Codes für den Dienst festlegt.
    • host: Dies ist eine Eigenschaft, die definiert, für welche Art von Azure-Dienst die App bereitgestellt wird.

    Hinweis

    Stellen Sie auch hier sicher, dass der Name Ihres Diensts (in diesem Fall: web) in azure.yaml mit dem azd-service-name-Tag für die entsprechende Hostressource übereinstimmt, die in der Bicep-Datei definiert ist.

Wenn azure.yaml fertig ist, sind alle wichtigen Strukturkomponenten Ihrer Vorlage vorhanden. In der nächsten Lerneinheit erfahren Sie, wie Sie Ihre Vorlagenressourcen in Azure bereitstellen.