Umgebungen im Microsoft Teams-Toolkit
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.dev
geschrieben.
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.yml
erstellen.
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:
Öffnen Sie Ihr Teams-App-Projekt in Visual Studio Code.
Wählen Sie auf der Aktivitätsleiste von Visual Studio Code das Symbol Teams Toolkit aus.
Wählen Sie das + Symbol im Abschnitt UMGEBUNG aus.
Geben Sie einen Namen für die Umgebung ein, und drücken Sie die EINGABETASTE.
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.
Siehe auch
Platform Docs