Umgebungen im Microsoft Teams-Toolkit

  • Artikel

Teams Toolkit bietet eine Möglichkeit zum Ausführen und Testen Ihrer App in verschiedenen Zielen für die Bereitstellung wie Entwicklung, Staging, Produktion oder lokal auf Ihrem Computer. Dazu enthält das Teams-Toolkit einen optionalen Satz von Features, die die Konfiguration dieser verschiedenen Ziele mithilfe von Informationen in Umgebungsdateien orchestrieren. Die Umgebungsdateien stellen eine Sammlung aller Ressourcen eines Bereitstellungsziels dar. Teams Toolkit-Projektvorlagen enthalten zwei Standardumgebungsgruppierungen: eine zum Ausführen der App auf Ihrem Computer mit dem Namen "local" und eine weitere zum Hosten an einem anderen Ort namens "dev". Sie können die Entwicklungsumgebung umbenennen und weitere Umgebungen über das Fenster Umgebungen oder manuell mit einer neuen .env.{environment-name} Datei hinzufügen. Sie können die lokale Umgebung nicht umbenennen.

Durch das Hinzufügen verschiedener Umgebungsdateien kann das Teams-Toolkit die Bereitstellung von Ressourcen automatisieren, die zum Ausführen der App und Zum Bereitstellen Ihres Codes für diese Ressourcen erforderlich sind. Sie können einen einzelnen Satz von Bereitstellungsregeln für die Anzahl von Umgebungen verwenden, die diese Features verwenden.

Verwenden von Umgebungsdateien mit dem Teams-Toolkit

Das Teams-Toolkit verwendet eine Namenskonvention für die Umgebungsdateien, z. B.: .env.{environment-name}. Mithilfe der Lebenszyklusbefehle des Toolkits (Bereitstellen, Bereitstellen oder Veröffentlichen) müssen Sie einen Umgebungsnamen angeben. Der Name der Umgebung sollte mit dem Wert übereinstimmen, der beim Erstellen der Umgebungsdatei für {environment-name} ausgewählt wurde.

Hinweis

Sie können Umgebungsvariablen für das Teams Toolkit in Ihrer aktuellen Shellumgebung definieren, die alle Werte in der .env Datei während eines Namenskonflikts außer Kraft setzen.

Speicherort der Umgebungsdatei

Standardmäßig lädt das Teams-Toolkit keine env-Variablen, und fahren Sie einfach mit der Ausführung von Aktionen fort, und schreiben Sie Ausgaben in ./env/.env.dev. Wenn environmentFolderPath nicht definiert ist, lädt Teams Toolkit keine Umgebungsvariablen aus der .env Datei und führt Aktionen aus, wenn der env dev ist. Die Ausgaben werden in ./env/.env.devgeschrieben.

Lokale Umgebungen

Zum Erstellen einer Microsoft Teams-App werden bestimmte Ressourcen wie App-Registrierungen und der Teams-Client in der Cloud gehostet. Die anderen Ressourcen, z. B. das Einschließen der Anwendungslogik, können jedoch lokal gehostet werden, um die Teständerungen während der App-Entwicklung zu vereinfachen. Alle Teams Toolkit-Projektvorlagen und -Beispiele sind mit einer local Umgebung konfiguriert. Die lokale Umgebung verfügt über ./env/.env.local Dateien und ./env/.env.local.user und unterstützt Sie beim Ausführen Ihrer App mit einem lokal gehosteten Webserver. Bei Verwendung von Visual Studio Code (VS Code) und Visual Studio (VS) werden die Projektvorlagen und Beispiele so eingerichtet, dass sie das Debuggen mit Haltepunkten unterstützen.

Um zwischen einer lokalen Umgebung und allen anderen Umgebungen zu unterscheiden, können Sie eine separate Projektdatei mit dem Namen teamsapp.local.yml im selben Verzeichnis wie teamsapp.ymlerstellen.

Manuelles Erstellen einer neuen Umgebung in Visual Studio Code

Jedes Projekt kann eine lokale Umgebung, aber mehrere Remoteumgebungen aufweisen. Nachdem Sie ein Projekt erstellt haben, konfiguriert teams Toolkit die folgenden Standardumgebungen:

  • Lokale Umgebung zur Darstellung der Umgebungskonfiguration des lokalen Computers.
  • Entwicklungsumgebung zur Darstellung der Remote- oder Cloudumgebungskonfiguration.

So erstellen Sie eine neue Umgebung:

  1. Öffnen Sie Ihr Teams-App-Projekt in Visual Studio Code.

  2. Wählen Sie auf der Aktivitätsleiste von Visual Studio Code das Symbol Teams Toolkit aus.

  3. Wählen Sie das + Symbol im Abschnitt UMGEBUNG aus.

    Screenshot: Hervorgehobenes Plussymbol im Abschnitt

  4. Geben Sie einen Namen für die Umgebung ein, und drücken Sie die EINGABETASTE.

    Screenshot: Eingabe des Umgebungsnamens

Ziel einer Umgebung

Wenn Sie über mehrere Umgebungen verfügen und die Menüelemente Produktion, Entwicklung oder lokal auswählen, werden Sie vom Teams Toolkit aufgefordert, eine Zielumgebung auszuwählen.

Screenshot: Ausgewählte Produktionsumgebung

Siehe auch