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 das 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.

  1. Öffnen Sie Visual Studio Code.

  2. Öffnen Sie den Projektordner, in dem Sie die App erstellt haben.

  3. Wählen Sie auf der Randleiste das Symbol Teams Toolkit aus.

  4. 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.

  5. Melden Sie sich mit Ihren Anmeldeinformationen bei Ihrem Azure-Konto an.

  6. 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

  1. Wählen Sie im abschnitt LIFECYCLE im linken Bereich Bereitstellen aus.

    Screenshot: Auswahl von

  2. Wählen Sie eine Umgebung aus. (Wenn nur eine Umgebung vorhanden ist, wird dieser Schritt übersprungen.)

  3. Wählen Sie Bereitstellen.

    Screenshot: Auswahl von

  4. 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 einer Azure App Service-Instanz an. Es wird automatisch generiert, nachdem der Bereitstellungsbefehl ausgeführt wurde. Wenn Sie bereits über eine Azure App Service-Instanz 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 der ZIP-Bereitstellungsfunktion 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 einer Azure Functions-Instanz an. Es wird automatisch generiert, nachdem der Bereitstellungsbefehl ausgeführt wurde. Wenn Sie bereits über eine Azure Functions-Instanz verfügen, finden Sie die zugehörige 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 einer Azure Functions-Instanz an. Es wird automatisch generiert, nachdem der Bereitstellungsbefehl ausgeführt wurde. Wenn Sie bereits über eine Azure Functions-Instanz verfügen, finden Sie die zugehörige 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 einer Azure Functions-Instanz an. Es wird automatisch generiert, nachdem der Bereitstellungsbefehl ausgeführt wurde. Wenn Sie bereits über eine Azure Functions-Instanz verfügen, finden Sie die zugehörige 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