Ereignisse
17. März, 23 Uhr - 21. März, 23 Uhr
Nehmen Sie an der Meetup-Serie teil, um skalierbare KI-Lösungen basierend auf realen Anwendungsfällen mit Mitentwicklern und Experten zu erstellen.
Jetzt registrierenDieser Browser wird nicht mehr unterstützt.
Führen Sie ein Upgrade auf Microsoft Edge durch, um die neuesten Features, Sicherheitsupdates und den technischen Support zu nutzen.
Die Azure Developer CLI (azd
) stellt zwei unterschiedliche Workflows bereit, um eine Vorlage für die Verwendung mit Ihrer App zu initialisieren, darunter:
Beide Ansätze werden im Übersichtsdokument "Create Azure Developer CLI templates" untersucht.
In diesem Artikel erfahren Sie, wie Sie Ihrer App Unterstützung für die Azure Developer CLI (azd
) über den Ansatz "Vorlage auswählen" hinzufügen. Besuchen Sie die App-Unterstützung hinzufügen azd
, indem Sie ein vorhandenes Vorlagendokument verwenden, um weitere Informationen zum alternativen Ansatz zu finden. Sie können auch die Schulung besuchen – Erstellen und Bereitstellen von azd
Vorlagen für weitere Informationen zum Erstellen von azd
Vorlagen.
Mit dem azd init
Befehl "Vorlagenworkflow auswählen" können Sie eine vorhandene azd
Vorlage auswählen, die als Ausgangspunkt verwendet werden soll. Der Inhalt der ausgewählten Vorlage wird dem Stammverzeichnis Ihres Projekts hinzugefügt. Die meisten Vorlagen stellen den erforderlichen Satz von azd
Dateien und Ordnern bereit, und viele enthalten eine vollständige Set-Infrastruktur-as-Code-Dateien, um Azure-Ressourcen für einen ausgewählten Anwendungsstapel bereitzustellen.
In diesem Beispiel verwenden Sie die Vorlage "Starter - Bicep ", die die grundlegende Struktur einer azd
Vorlage und einige nützliche Codebausteine enthält, um zu beginnen. Startvorlagen sind eine großartige Wahl, wenn Sie die richtige Vorlagenstruktur und die richtigen Startressourcen gerüsten möchten, aber dennoch Eigene Infrastrukturdateien erstellen möchten.
Um zusammen mit den schritten vor der Verwendung einer vorhandenen Beispielanwendung zu folgen, klonen Sie das folgende Startprojekt in ein leeres Verzeichnis auf Ihrem Computer:
git clone https://github.com/Azure-Samples/msdocs-python-flask-webapp-quickstart
Navigieren Sie in Ihrem Befehlszeilentool zu dem Stammverzeichnis des geklonten Projekts.
Führen Sie den azd init
Befehl aus, um eine azd
Vorlage zu initialisieren.
azd init
Wenn Sie dazu aufgefordert werden, wählen Sie die Option zum Auswählen einer Vorlage aus.
Wählen Sie in der Liste der Vorlagen "Starter - Bicep" aus. Sie können den Vorlagennamen eingeben oder die Tastaturpfeiltasten verwenden, um sie zu finden.
Wenn Sie dazu aufgefordert werden, geben Sie einen kurzen Umgebungsnamen ein, z . B. "testenv".
Nachdem Sie ausgeführt azd init
haben, werden die folgenden Ressourcen zu Ihrem aktuellen Verzeichnis hinzugefügt:
├── .azdo [ Configures an Azure Pipeline ]
├── .devcontainer [ For DevContainer ]
├── .github [ Configures a GitHub workflow ]
├── .vscode [ VS Code workspace configurations ]
├── .azure [ Stores Azure configurations and environment variables ]
├── infra [ Contains infrastructure as code files ]
│ ├── main.bicep/main.tf [ Main infrastructure file ]
│ ├── main.parameters.json/main.tfvars.json [ Parameters file ]
│ └── core/modules [ Contains reusable Bicep/Terraform modules ]
└── azure.yaml [ Describes the app and type of Azure resources]
Ihr Projekt enthält jetzt die Kernstruktur und Ressourcen einer azd
Vorlage. Um jedoch die Azure-Ressourcen für Ihr spezifisches Projekt bereitzustellen, müssen die Bicep-Dateien im infra
Ordner aktualisiert werden. Um die Beispielanwendung zu hosten, müssen Sie die folgenden Ressourcen mithilfe von Bicep-Dateien definieren:
Öffnen Sie das Stammprojektverzeichnis in Ihrem Editor, z. B. Visual Studio Code.
Öffnen Sie die main.bicep
Datei im infra
Ordner mit Ihrem Editor. Diese Datei enthält nützliche Codebausteine zum Einrichten wesentlicher Variablen, Parameter und Benennungskonventionen. Fügen Sie unterhalb des Kommentarblocks um Zeile 50, die gelesen wird Add resources to be provisioned below
, die folgende Bicep hinzu:
// Creates an app service instance to host the app
module web './core/host/appservice.bicep' = {
name: 'web'
scope: rg
params: {
name: '${abbrs.webSitesAppService}web-${resourceToken}'
location: location
tags: union(tags, { 'azd-service-name': 'web' })
appServicePlanId: appServicePlan.outputs.id
runtimeName: 'python'
runtimeVersion: '3.8'
scmDoBuildDuringDeployment: true
}
}
// Create an App Service Plan to group applications under the same payment plan and SKU
module appServicePlan './core/host/appserviceplan.bicep' = {
name: 'appserviceplan'
scope: rg
params: {
name: '${abbrs.webServerFarms}${resourceToken}'
location: location
tags: tags
sku: {
name: 'B1'
}
}
}
Hinweis
${resourceToken}
Variable verwendet. Dieses Token wird an den Namen aller azure-Ressourcen angefügt, die von azd
.azd
verwendet Tags zum Identifizieren von Ressourcen, damit Sie die Namen basierend auf der Benennungskonvention Ihrer Organisation ändern können.'azd-service-name': 'web'
Tag im App-Dienst ist der Wert azd
, der zum Identifizieren des Bereitstellungshosts verwendet wird. Der Wert muss mit dem übereinstimmen, was für den Dienst in der Datei "azure.yaml " definiert ist.Um die App bereitzustellen, azd
müssen Sie mehr über Ihre App wissen. Die azure.yaml
Datei wird verwendet, um den Quellcodespeicherort, die Sprache und den Azure-Hostingdienst für jeden Dienst in Ihrer App zu definieren. Ausführliche Informationen finden Sie im Azure.yaml-Schema.
Öffnen Sie den azure.yaml
Stamm des Projekts.
Fügen Sie die folgenden Zeilen am Ende der Datei hinzu:
name: msdocs-python-flask-webapp-quickstart
services:
web:
project: .
language: py
host: appservice
Speichern Sie alle Ihre Änderungen, und führen Sie den folgenden Befehl aus, um die App-Ressourcen in Azure bereitzustellen und bereitzustellen:
azd up
Wenn der Befehl abgeschlossen ist, klicken Sie auf den Link in der Befehlsausgabe, um zur bereitgestellten Website zu navigieren.
Ihr Projekt ist jetzt mit der Azure Developer CLI kompatibel und kann als Vorlage verwendet werden.
Hinweis
azd
unterstützt auch die Verwendung von Buildpack zum Standardmäßigen Containern Ihrer Apps. Wenn Ihre azd
Vorlage auf Azure Container Apps oder Azure Kubernetes Service ausgerichtet ist, aber keine Docker-Datei enthält, azd
generiert automatisch ein Image mit Buildpack.
Ereignisse
17. März, 23 Uhr - 21. März, 23 Uhr
Nehmen Sie an der Meetup-Serie teil, um skalierbare KI-Lösungen basierend auf realen Anwendungsfällen mit Mitentwicklern und Experten zu erstellen.
Jetzt registrierenTraining
Modul
Erstellen Ihrer ersten Azure Developer CLI-Vorlage - Training
Hier erfahren Sie, wie Sie eigene Azure Developer CLI-Vorlagen erstellen.
Zertifizierung
Microsoft Certified: Azure Developer Associate - Certifications
Erstellen von End-to-End-Lösungen in Microsoft Azure zum Erstellen von Azure Functions-Lösungen, Implementieren und Verwalten von Web-Apps, Entwickeln von Lösungen mit Azure Storage u. v. m.
Dokumentation
Übersicht über die Erstellung von Azure Developer CLI-Vorlagen
So konvertieren Sie eine App in eine azure-entwicklerfähige Vorlage.
Hinzufügen von Azure Developer CLI-Unterstützung zu Ihrer App mithilfe von Code in Ihrem App-Verzeichnis
Erste Schritte mit dem Feature zum Verfassen der Azure Developer CLI
Erstellen und Erstellen Ihrer Apps mithilfe des Features zum Verfassen der Azure Developer CLI