Querladen und Testen der App in der Teams-Umgebung v4

  • Artikel

Wichtig

Wir haben die Erweiterung Teams Toolkit v5 in Visual Studio Code eingeführt. Diese Version wird mit vielen neuen App-Entwicklungsfeatures bereitgestellt. Es wird empfohlen, teams Toolkit v5 zum Erstellen Ihrer Teams-App zu verwenden.

Die Teams Toolkit v4-Erweiterung wird bald veraltet sein.

Nach dem Hinzufügen der API-Verbindung können Sie die API-Verbindung in der lokalen Umgebung des Teams Toolkits testen und Ihre Anwendung in der Cloud bereitstellen. In der CI/CD-Pipeline müssen Sie nach der Einrichtung mit einer anderen Plattform einen Azure-Dienstprinzipal erstellen, um Ressourcen bereitzustellen.

In diesem Abschnitt erfahren Sie Folgendes:

Testen der API-Verbindung in der lokalen Umgebung

Die folgenden Schritte helfen beim Testen der API-Verbindung in der lokalen Umgebung des Teams Toolkits:

  1. Ausführen von npm install

    Führen Sie npm install unter bot oder api im Ordner aus, um hinzugefügte Pakete zu installieren.

  2. Hinzufügen von API-Anmeldeinformationen zu den lokalen Anwendungseinstellungen

    Teams Toolkit fordert keine Anmeldeinformationen an, aber es verbleiben Platzhalter in der lokalen Anwendungseinstellungsdatei. Ersetzen Sie die Platzhalter durch die entsprechenden Anmeldeinformationen für den Zugriff auf die API. Die lokale Anwendungseinstellungsdatei ist die .env.teamsfx.local Datei im bot Ordner oder api .

  3. Verwenden des API-Clients zum Senden von API-Anforderungen

    Importieren Sie den API-Client aus dem Quellcode, der Zugriff auf die API benötigt:

    import { yourApiClient } from '{relative path to the generated file}'

  4. Generieren von HTTP(s)-Anforderungen für die ZIEL-API (mit Axios)

    Der generierte API-Client ist ein Axios-API-Client. Verwenden Sie den Axios-Client, um Anforderungen an die API zu senden.

    Hinweis

    Axios ist ein beliebtes nodejs-Paket, das Sie bei HTTP-Anforderungen unterstützt. Weitere Informationen zum Erstellen von HTTP-Anforderungen finden Sie in der Axios-Beispieldokumentation , um zu erfahren, wie Http(s) erstellt werden.

Bereitstellen Ihrer Anwendung in Azure

Um Ihre Anwendung in Azure bereitzustellen, müssen Sie die Authentifizierung den Anwendungseinstellungen für die entsprechende Umgebung hinzufügen. Ihre API kann z. B. unterschiedliche Anmeldeinformationen für dev und aufweisen prod. Konfigurieren Sie basierend auf den Anforderungen der Umgebung das Teams-Toolkit.

Teams Toolkit konfiguriert Ihre lokale Umgebung. Der bootstrapped-Beispielcode enthält Kommentare, die Ihnen mitteilen, welche App-Einstellungen Sie konfigurieren müssen. Weitere Informationen zu Anwendungseinstellungen finden Sie unter Hinzufügen von App-Einstellungen.

Bereitstellen von CI/CD-Ressourcen

Um Ressourcen für Azure innerhalb von CI/CD bereitzustellen, müssen Sie einen Azure-Dienstprinzipal erstellen und verwenden.

Führen Sie die folgenden Schritte aus, um Azure-Dienstprinzipale zu erstellen:

  1. Registrieren Sie eine Microsoft Azure Active Directory (Azure AD)-Anwendung in einem einzelnen Einzelmandanten.
  2. Weisen Sie Ihrer Azure AD-Anwendung eine Rolle zu, um auf Ihr Azure-Abonnement zuzugreifen. Die Rolle Contributor wird empfohlen.
  3. Erstellen Sie ein neues Azure AD-Anwendungsgeheimnis.

Tipp

Speichern Sie Ihre Mandanten-ID, Anwendungs-ID (AZURE_SERVICE_PRINCIPAL_NAME) und den geheimen Schlüssel (AZURE_SERVICE_PRINCIPAL_PASSWORD) für die zukünftige Verwendung.

Weitere Informationen finden Sie in den Richtlinien für Azure-Dienstprinzipale. Es folgen die drei Möglichkeiten zum Erstellen von Dienstprinzipalen:

Siehe auch