Bereitstellen der Microsoft Teams-App in der Cloud mithilfe von Microsoft Visual Studio Code
Das Microsoft Teams-Toolkit unterstützt Sie beim Bereitstellen oder Hochladen des Front-End- und Back-End-Codes in Ihrer App in Ihren bereitgestellten Cloudressourcen in Azure.
Sie können die Bereitstellung für die folgenden Arten von Cloudressourcen durchführen:
- Azure-App Services
- Azure Functions
- Azure Storage (als statische Website)
- SharePoint
Hinweis
Bevor Sie App-Code in der Azure-Cloud bereitstellen, müssen Sie die Bereitstellung von Cloudressourcen erfolgreich abschließen.
Bereitstellen von Teams-Apps mithilfe des Teams-Toolkits
Der Leitfaden zu den ersten Schritten hilft bei der Bereitstellung mithilfe des Teams-Toolkits. Sie können Folgendes verwenden, um Ihre Teams-App bereitzustellen:
Anmelden bei Ihrem Azure-Konto
Verwenden Sie dieses Konto, um auf die Microsoft Azure-Portal zuzugreifen und neue Cloudressourcen zur Unterstützung Ihrer App bereitzustellen. Bevor Sie Ihre App in Azure App Service, Azure Functions oder Azure Storage bereitstellen, müssen Sie sich bei Ihrem Azure-Konto anmelden.
Öffnen Sie Visual Studio Code.
Öffnen Sie den Projektordner, in dem Sie die App erstellt haben.
Wählen Sie auf der Randleiste das Symbol Teams Toolkit aus.
Wählen Sie Bei Azure anmelden aus.
Tipp
Wenn Sie die Azure-Kontoerweiterung installiert haben und dasselbe Konto verwenden, können Sie diesen Schritt überspringen. Verwenden Sie dasselbe Konto wie in anderen Erweiterungen.
Ihr Standardwebbrowser wird geöffnet, damit Sie sich beim Konto anmelden können.
Melden Sie sich mit Ihren Anmeldeinformationen bei Ihrem Azure-Konto an.
Schließen Sie den Browser, wenn Sie dazu aufgefordert werden, und kehren Sie zu Visual Studio Code zurück.
Im Abschnitt KONTEN der Randleiste werden die beiden Konten separat angezeigt. Außerdem wird die Anzahl der verwendbaren Azure-Abonnements aufgelistet, die Ihnen zur Verfügung stehen. Stellen Sie sicher, dass Mindestens ein verwendbares Azure-Abonnement verfügbar ist. Wenn nicht, melden Sie sich ab, und verwenden Sie ein anderes Konto.
Jetzt können Sie Ihre App in Azure bereitstellen!
Herzlichen Glückwunsch, Sie haben eine Teams-App erstellt! Als Nächstes erfahren Sie, wie Sie mithilfe des Teams-Toolkits eine der Apps in Azure bereitstellen.
Bereitstellen in Azure
Wählen Sie im abschnitt LIFECYCLE im linken Bereich Bereitstellen aus.
Wählen Sie eine Umgebung aus. (Wenn nur eine Umgebung vorhanden ist, wird dieser Schritt übersprungen.)
Wählen Sie Bereitstellen.
Wählen Sie auf der Randleiste das Symbol Teams Toolkit aus.
Anpassen des Bereitstellungslebenszyklus in Teams
Zum Anpassen des Bereitstellungsprozesses können Sie die Bereitstellungsabschnitte in "teamsapp.yml" bearbeiten.
cli/runNpmCommand
Diese Aktion führt npm-Befehle unter dem angegebenen Verzeichnis mit Parametern aus.
Beispiel
- uses: cli/runNpmCommand
with:
workingDirectory: ./src
args: install
Parameter
| Parameter | Beschreibung | Erforderlich | Standardwert |
|---|---|---|---|
| workingDirectory | Stellt den Ordner dar, in dem Sie den Befehl ausführen möchten. Wenn ihr Eingabewert ein relativer Pfad ist, ist er relativ zum workingDirectory. | Nein | Projektstamm |
| Args | Befehlsargumente | Ja |
cli/runDotnetCommand
Diese Aktion führt dotnet-Befehle unter dem angegebenen Verzeichnis mit Parametern aus.
Beispiel
- uses: cli/runDotnetCommand
with:
workingDirectory: ./src
execPath: /YOU_DOTNET_INSTALL_PATH
args: publish --configuration Release --runtime win-x86 --self-contained
Parameter
| Parameter | Beschreibung | Erforderlich | Standardwert |
|---|---|---|---|
| workingDirectory | Stellt den Ordner dar, in dem Sie den Befehl ausführen möchten. Wenn ihr Eingabewert ein relativer Pfad ist, ist er relativ zum workingDirectory. | Nein | Projektstamm |
| Args | npm-Befehlsargumente | Ja | |
| execPath | Executorpfad | Nein | SystemPFAD |
cli/runNpxCommand
Beispiel
- uses: cli/runNpxCommand
with:
workingDirectory: ./src
args: gulp package-solution --ship --no-color
Parameter
| Parameter | Beschreibung | Erforderlich | Standardwert |
|---|---|---|---|
| workingDirectory | Stellt den Ordner dar, in dem Sie den Befehl ausführen möchten. Wenn ihr Eingabewert ein relativer Pfad ist, ist er relativ zum workingDirectory. | Nein | Projektstamm |
| Args | Befehlsargumente | Ja |
azureAppService/zipDeploy
Beispiel
- uses: azureAppService/zipDeploy
with:
workingDirectory: ./src
artifactFolder: .
ignoreFile: ./.webappignore
resourceId: ${{BOT_AZURE_APP_SERVICE_RESOURCE_ID}}
dryRun: false
outputZipFile: ./.deployment/deployment.zip
Parameter
| Parameter | Beschreibung | Erforderlich | Standardwert |
|---|---|---|---|
| workingDirectory | Stellt den Ordner dar, in den Sie das Artefakt hochladen möchten. Wenn ihr Eingabewert ein relativer Pfad ist, ist er relativ zum Projektstamm. | Nein | Projektstamm |
| artifactFolder | Stellt den Ordner dar, in den Sie das Artefakt hochladen möchten. Wenn ihr Eingabewert ein relativer Pfad ist, ist er relativ zum workingDirectory. | Ja | |
| ignoreFile | Gibt den Dateipfad von ignoreFile an, der während des Uploads verwendet wird. Diese Datei kann verwendet werden, um bestimmte Dateien oder Ordner aus dem artifactFolder auszuschließen. Die Syntax ähnelt der von Git ignorierten Syntax. | Nein | null |
| resourceId | Gibt die Ressourcen-ID eines Azure App Service an. Es wird automatisch generiert, nachdem der Bereitstellungsbefehl ausgeführt wurde. Wenn Sie bereits über eine Azure App Service verfügen, finden Sie dessen Ressourcen-ID. | Ja | |
| dryRun | Sie können den parameter dryRun auf true festlegen, wenn Sie nur die Vorbereitung des Uploads testen möchten und nicht beabsichtigen, ihn bereitzustellen. Dadurch können Sie überprüfen, ob die PAKET-ZIP-Datei korrekt ist. | Nein | false |
| outputZipFile | Gibt den Pfad der ZIP-Datei für den gepackten Artefaktordner an. Es ist relativ zum workingDirectory.It's relative to the workingDirectory. Diese Datei wird während der Bereitstellung rekonstruiert, wobei alle Ordner und Dateien in Ihrem artifactFolder widerspiegelt und alle nicht vorhandenen Dateien oder Ordner entfernt werden. | Nein | ./.deployment/deployment.zip |
azureFunctions/zipDeploy
Diese Aktion lädt das Projekt hoch und stellt es mithilfe des Zip Deploy-Features in Azure Functions bereit.
Beispiel
- uses: azureFunctions/zipDeploy
with:
workingDirectory: ./src
artifactFolder: .
ignoreFile: ./.webappignore
resourceId: ${{BOT_AZURE_APP_SERVICE_RESOURCE_ID}}
dryRun: false
outputZipFile: ./.deployment/deployment.zip
Parameter
| Parameter | Beschreibung | Erforderlich | Standardwert |
|---|---|---|---|
| workingDirectory | Stellt den Ordner dar, in den Sie das Artefakt hochladen möchten. Wenn ihr Eingabewert ein relativer Pfad ist, ist er relativ zum Projektstamm. | Nein | Projektstamm |
| artifactFolder | Stellt den Ordner dar, in den Sie das Artefakt hochladen möchten. Wenn ihr Eingabewert ein relativer Pfad ist, ist er relativ zum workingDirectory. | Ja | |
| ignoreFile | Gibt den Dateipfad von ignoreFile an, der während des Uploads verwendet wird. Diese Datei kann verwendet werden, um bestimmte Dateien oder Ordner aus dem artifactFolder auszuschließen. Die Syntax ähnelt der von Git ignorierten Syntax. | Nein | null |
| resourceId | Gibt die Ressourcen-ID eines Azure Functions an. Es wird automatisch generiert, nachdem der Bereitstellungsbefehl ausgeführt wurde. Wenn Sie bereits über eine Azure Functions verfügen, finden Sie dessen Ressourcen-ID im Azure-Portal. | Ja | |
| dryRun | Sie können den parameter dryRun auf true festlegen, wenn Sie nur die Vorbereitung des Uploads testen möchten und nicht beabsichtigen, ihn bereitzustellen. Dadurch können Sie überprüfen, ob die PAKET-ZIP-Datei korrekt ist. | Nein | false |
| outputZipFile | Gibt den Pfad der ZIP-Datei für den gepackten Artefaktordner an. Es ist relativ zum workingDirectory.It's relative to the workingDirectory. Diese Datei wird während der Bereitstellung rekonstruiert, wobei alle Ordner und Dateien in Ihrem artifactFolder widerspiegelt und alle nicht vorhandenen Dateien oder Ordner entfernt werden. | Nein | ./.deployment/deployment.zip |
azureStorage/deploy
Diese Aktion lädt das Projekt hoch und stellt es in Azure Storage bereit.
Beispiel
- uses: azureStorage/deploy
with:
workingDirectory: ./src
artifactFolder: .
ignoreFile: ./.webappignore
resourceId: ${{BOT_AZURE_APP_SERVICE_RESOURCE_ID}}
Parameter
| Parameter | Beschreibung | Erforderlich | Standardwert |
|---|---|---|---|
| workingDirectory | Stellt den Ordner dar, in den Sie das Artefakt hochladen möchten. Wenn ihr Eingabewert ein relativer Pfad ist, ist er relativ zum Projektstamm. | Nein | Projektstamm |
| artifactFolder | Stellt den Ordner dar, in den Sie das Artefakt hochladen möchten. Wenn ihr Eingabewert ein relativer Pfad ist, ist er relativ zum workingDirectory. | Ja | |
| ignoreFile | Gibt den Dateipfad von ignoreFile an, der während des Uploads verwendet wird. Diese Datei kann verwendet werden, um bestimmte Dateien oder Ordner aus dem artifactFolder auszuschließen. Die Syntax ähnelt der von Git ignorierten Syntax. | Nein | null |
| resourceId | Gibt die Ressourcen-ID eines Azure Functions an. Es wird automatisch generiert, nachdem der Bereitstellungsbefehl ausgeführt wurde. Wenn Sie bereits über eine Azure Functions verfügen, finden Sie dessen Ressourcen-ID im Azure-Portal. | Ja |
azureStorage/deploy
Diese Aktion lädt das Projekt hoch und stellt es in Azure Storage bereit.
Beispiel
- uses: azureStorage/deploy
with:
workingDirectory: ./src
artifactFolder: .
ignoreFile: ./.webappignore
resourceId: ${{BOT_AZURE_APP_SERVICE_RESOURCE_ID}}
Parameter
| Parameter | Beschreibung | Erforderlich | Standardwert |
|---|---|---|---|
| workingDirectory | Stellt den Ordner dar, in den Sie das Artefakt hochladen möchten. Wenn ihr Eingabewert ein relativer Pfad ist, ist er relativ zum Projektstamm. | Nein | Projektstamm |
| artifactFolder | Stellt den Ordner dar, in den Sie das Artefakt hochladen möchten. Wenn ihr Eingabewert ein relativer Pfad ist, ist er relativ zum workingDirectory. | Ja | |
| ignoreFile | Gibt den Dateipfad von ignoreFile an, der während des Uploads verwendet wird. Diese Datei kann verwendet werden, um bestimmte Dateien oder Ordner aus dem artifactFolder auszuschließen. Die Syntax ähnelt der von Git ignorierten Syntax. | Nein | null |
| resourceId | Gibt die Ressourcen-ID eines Azure Functions an. Es wird automatisch generiert, nachdem der Bereitstellungsbefehl ausgeführt wurde. Wenn Sie bereits über eine Azure Functions verfügen, finden Sie dessen Ressourcen-ID im Azure-Portal. | Ja |
spfx/deploy
Diese Aktion lädt generierte sppkg hoch und stellt es im SharePoint-App-Katalog bereit. Sie können den Mandanten-App-Katalog manuell erstellen oder indem Sie createAppCatalogIfNotExist auf true festlegen, wenn Sie keinen im aktuellen M365-Mandanten haben.
Beispiel
- uses: spfx/deploy
with:
createAppCatalogIfNotExist: false
packageSolutionPath: ./src/config/package-solution.json
Parameter
| Parameter | Beschreibung | Erforderlich | Standardwert |
|---|---|---|---|
| createAppCatalogIfNotExist | Wenn der Wert true ist, erstellt diese Aktion zuerst den Mandanten-App-Katalog, falls nicht vorhanden. | Nein | Falsch |
| packageSolutionPath | Pfad zum package-solution.json im SPFx-Projekt. Diese Aktion berücksichtigt die Konfiguration zum Abrufen von Ziel-sppkg. | Ja |
Siehe auch
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für