Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die innere Schleife von Copilot Managed Runtime-Apps ist ein schneller, Git-nativer Workflow zum Erstellen, Anzeigen einer Vorschau und Bereitstellen von Apps. Bearbeiten Sie den Code in Ihrer IDE, führen Sie einen Commit durch, und pushen Sie ihn, und lassen Sie die Plattform den gepushten Commit für den Vorschauendpunkt erstellen. Wenn Sie bereit sind, live zu gehen, stellen Sie die Bereitstellung explizit mithilfe von ms app deploybereit.
In diesem Artikel wird beschrieben, wie die einzelnen Phasen der inneren Schleife funktionieren, was die Plattform hinter den Kulissen leistet und wo Ihre Arbeit bei den einzelnen Schritten stattfindet. Es ergänzt Schnellstart: Erstellen einer Microsoft Copilot Managed Runtime-App mit GitHub Copilot und Schnellstart: Erstellen einer App mit dem Copilot Managed Runtime SDK, die denselben Flow End-to-End mit Befehlen durchlaufen.
In diesem Artikel werden Befehle der Befehlszeilenschnittstelle (CLI) beschrieben, die Sie in ein befehlszeilenbasiertes Terminalfenster eingeben können. Agents wie GitHub Copilot verfügen über ähnliche Fähigkeiten und können diese Befehle bei Bedarf auch ausgeben. Sie können beispielsweise einen Agent bitten, einfach "bereitzustellen", und er führt das Äquivalent von ms app deployaus. Du musst nicht alle diese Befehle lernen, aber sie sind immer dabei, wenn du sie brauchst.
Das erwartet Sie
Ein paar Verhaltensweisen prägen das gesamte Erlebnis. Wenn man sie im Voraus kennt, ist der Rest der inneren Schleife vorhersehbar.
- Es ist Git-nativ. Die
msCLI funktioniert mit echtem Git, anstatt es zu ersetzen. Sie verwendengit add,git commit, undgit pushzwar auf die gleiche Weise wie bei jedem Projekt, sodass Ihre Coding-Agents, Branch-Richtlinien und vorhandenen Workflows übernommen werden. - Builds erfolgen, wenn Sie sie brauchen. A
git pushaktualisiert Ihre Quelle der Wahrheit, baut aber nichts allein auf. Die Plattform baut nach Bedarf auf: beim Öffnen der Vorschau, beim Bereitstellen oder beim Ausführen eines Builds selbst. - Die Vorschau ist automatisch; Die Live-Schaltung ist bewusst. Jeder erfolgreiche Build steht für alle Commits und Branches in der Vorschau zur Verfügung. Die Höherstufung zu Ihrer Live-App ist immer ein expliziter Schritt, den Sie unternehmen.
- Jeder Build ist adressierbar. Jeder Build verfügt über eine stabile ID, einen Status und den Commit, von dem er stammt, sodass Sie jeden Build als Ziel verwenden können, wenn
--commit <sha>Sie seinen Status überprüfen oder bereitstellen.
Repositorymodi
Jede App verwendet einen von drei Repositorymodi. Sie wählen den Modus bei ms app create oder ms app initaus. Der Modus ist für die Lebensdauer der App festgelegt, und zum Wechseln des Modus muss eine neue App erstellt werden.
| Modus | Auslöser | Quelle der Wahrheit | Geeignet in folgender Situation |
|---|---|---|---|
| Plattformverwaltetes Git (Standard) |
ms app create
--repo Ohne Kennzeichnung |
Ein Repository, das die Plattform in Ihrem Namen bereitstellt und verwaltet | Teams, die nicht über ein Setup für die Quellcodeverwaltung verfügen oder Git ohne Konfiguration sofort verwenden möchten. |
| Bring your own GitHub |
ms app create
--repo <url>
|
Ein externes Repository im Besitz einer GitHub Enterprise Cloud-organization | Teams, die bereits auf GitHub Enterprise Cloud standardisiert sind und möchten, dass ihre bestehenden Branchrichtlinien, Pull Request Reviews und CI auf die verwaltete App angewendet werden. |
| Bring Your Own Build |
ms app create
--repo none
|
Es gibt kein Repository, das der Plattform bekannt ist. In diesem Fall müssen Sie den Code selbst für die Bereitstellung auf der Plattform erstellen. | Verwende diesen Modus, wenn du die Quelle nicht über GitHub oder plattformseitig verwaltetes Git verwalten möchtest. |
Umgebungen
Jeder Entwickler und jeder Coding-Agent, der Apps in seinem Auftrag erstellt, landet in einer Umgebung: einer sicheren Sandbox, die die Plattform zuerst ms app create bereitstellt oder ms app init.
Eine Umgebung ist identitätsbezogen, automatisch bereitgestellt und erbt die Richtlinien Ihrer Organization von dem Moment an, in dem sie vorhanden sind. Sie verlangen es nicht; Du fängst einfach an zu arbeiten, und es ist da. Diese Umgebungen sind mit einer von Microsoft verwalteten Baseline von Administratorrichtlinien vorkonfiguriert, sodass die Governance ab dem Zeitpunkt gilt, an dem Sie mit der Erstellung beginnen. Administratoren können die Baseline dann nach Bedarf überprüfen und anpassen.
Abhängigkeiten hinzufügen
Nach der Ausführung ms app createenthält das App-Verzeichnis das Gerüst für eine App. Der nächste Schritt besteht darin, Pakete hinzuzufügen, von denen die App abhängt, indem Sie npm install.
Sie müssen diesen Schritt nur einmal ausführen, es sei denn, Sie fügen später weitere Pakete hinzu.
Die innere Schleife
Von der Erstellung bis zur langfristigen, zuverlässigen Nutzung durchlaufen Apps eine Schleife:
- Lokal bearbeiten und ausführen: Erstellen Sie die App, und durchlaufen Sie sie in einer engen Schleife durch die Bearbeitung und das schnelle Anzeigen der Ergebnisse einer Änderung. Die App ist nur für einen Mitwirkenden auf einem einzelnen Computer vorhanden.
- In Quellcodeverwaltung speichern: Verwenden Sie Git-Befehle zum Hinzufügen, Commit und Pushen, um Ihre Änderungen beizubehalten und mit anderen Mitwirkenden zusammenzuarbeiten.
- Plattformbuild und Vorschau: Erstellen Sie die App auf der Plattform, und zeigen Sie eine Vorschau aus der Cloud an.
- Für die Produktion bereitstellen: Geben Sie die App für Endbenutzer für die Produktionsverwendung frei. Ihre App ist live.
- Integrität und Nutzung überwachen: Stellen Sie sicher, dass Ihre App verfügbar bleibt, und messen Sie die Nutzung für weitere Investitionen.
Die Schleife wiederholt sich mit Benutzerfeedback, neuen Ideen, geänderten Anforderungen und unzähligen anderen Gründen.
Wenn unterwegs etwas schief geht, können Sie mit der Quellcodeverwaltung eine zuvor bekannte gute Version bereitstellen und die Blockierung von Endbenutzern aufheben. Weitere Informationen finden Sie im Abschnitt zum Zurückkehren zu einer früheren Version.
Lokal bearbeiten und ausführen
Bearbeiten Sie Code in Ihrer bevorzugten IDE, und geben Sie die App lokal mit ms app devab. Dieser Befehl kehrt nicht zurück; Stattdessen beginnt es zu arbeiten und kann mit einer+ Strg-C-Tastenkombination heruntergefahren werden. Wenn Sie diesen Befehl mit einem Agent starten, z. B. GitHub Copilot, zeigt dies, dass eine Hintergrundaufgabe ausgeführt wird.
Während er arbeitet, führt dieser Befehl zwei Aufgaben aus:
- Es fungiert als Webserver auf Ihrem lokalen Computer, um die App wiederzugeben. Es druckt die URL, die Sie für eine Vorschau der App im lokalen Modus verwenden können, und öffnet möglicherweise auch einen Browser für diese URL.
- Es überwacht Sie auf Änderungen in Ihrer App, während Sie weitere Bearbeitungen vornehmen. Wenn eine erkannt wird, wird der Browser automatisch mit dem Update aktualisiert.
Die bereitgestellte ms app dev URL beginnt mit https://play.managedapps.cloud.microsoft/..., was sich von der URL unterscheidet, die Sie möglicherweise bei anderen Node-basierten lokalen Entwicklungen sehen. Diese Remote-URL ruft für den Großteil des Webinhalts auf den lokalen Computer zurück, bietet aber auch ein Gateway für den Zugriff auf Remotedatendienste und Connectors. Mit diesem Setup können Sie eine lokale App mit Daten in einer Remotedatenquelle wie Dataverse, SharePoint oder von einem beliebigen anderen Connector wiedergeben.
An dieser Stelle:
- Ihre Arbeit befindet sich nur auf dem lokalen Computer, und nur Sie können sie wiedergeben. Fügen Sie in der nächsten Phase hinzu, committen und pushen Sie, um die Arbeit mit anderen Mitwirkenden, einschließlich sich selbst, auf einem anderen Computer beizubehalten und mit ihnen zusammenzuarbeiten.
- Es ist kein Build oder Bereitstellen erforderlich. Der Webserver läuft mit den rohen Quelldateien, was eine schnelle Entwicklung ermöglicht.
In Quellcodeverwaltung speichern
Wenn sich die App lokal wie gewünscht verhält, speichern Sie diese Version in der Quellcodeverwaltung, um sie beizubehalten und mit anderen Mitwirkenden zusammenzuarbeiten.
Führen Sie im Stammverzeichnis der App die folgenden Schritte aus, um diese Version der App in Flaschen abzufüllen und in das Remoterepository von Git zu übertragen.
-
git add .Fügt beim nächsten Commit alle Dateien hinzu, die Sie geändert haben. Das.weist git an, alle Dateien in diesem Verzeichnis und in diesen Unterverzeichnissen einzuschließen. Warnungen zu LF- und CRLF-Zeilenenden können ignoriert werden. -
git commitErstellt den Commit. Ein Commit ist eine bestimmte Version Ihrer App, auf die Sie später mit einer Commit-ID verweisen können. Git fordert eine Nachricht an, um diesen Commit zu kennzeichnen, damit du und andere wissen, was sich mit dieser Version geändert hat. -
git pushSendet den Commit zur sicheren Aufbewahrung und zur Vorschau an den Server. Der Push aktualisiert das Remoterepository, entweder das plattformseitig verwaltete Git-Repository oder Ihr gebundenes externes GitHub-Repository.
An dieser Stelle:
- Ihre Arbeit befindet sich jetzt sowohl auf Ihrem lokalen Computer als auch im Remoterepository. Ihre Änderungen werden sicher auf der Plattform gespeichert und sind nicht mehr auf einen Computer isoliert. Andere Mitwirkende können Ihre Änderungen anzeigen und in der Vorschau anzeigen. Sie können sie weiterhin nach Belieben für weitere Änderungen verwenden
ms app dev. - Der Push löst nicht selbst einen Build aus. Die Fernbedienung hat jetzt einen neuen Commit, den die Plattform als baubare Version betrachtet.
Wenn Sie den Modus "Bring Your Own Build" verwenden, können diese Befehle für Sie anders sein.
Plattformerstellung und Vorschau
Wenn Sie einen Commit auf der Plattform speichern, können Sie und andere Mitwirkende ihn direkt wiedergeben. Geben Sie den Befehl ms app play --mode preview ein, um die URL für die Vorschau anzuzeigen. Halten Sie die STRG-TASTE gedrückt, und wählen Sie die URL aus, oder kopieren Sie die URL, und fügen Sie sie in einen Browser ein.
Standardmäßig wählt die Vorschau den aktuellen Git-Branch aus. Wenn die CLI den Branch nicht identifizieren kann, gibt sie eine Warnung aus und greift auf mainzurück. Wird für einen bestimmten Branch oder ms app play --mode preview --commit <sha> für einen bestimmten Commit verwendetms app play --mode preview --branch <name>.
--branch und --commit schließen sich gegenseitig aus.
Wenn Sie diese Version der App noch nicht gespielt haben, erstellt die Plattform die App bei Bedarf. Wenn ein früherer Build vorhanden ist, spielt die Plattform diesen älteren Build aus, während Sie warten, und fordert Sie auf, ihn zu aktualisieren, wenn er fertig ist.
Alle auf der Plattform gespeicherten Git-Commits können von jedem Mitwirkenden jederzeit ausgeführt werden. Verwenden Sie dieses Feature, um Änderungen zwischen Versionen mit zwei separaten Browserfenstern zu vergleichen. Verwenden Sie die folgenden URLs, um auf einen bestimmten Commit zuzugreifen:
-
https://play.managedapps.cloud.microsoft/apps/<appId>/commit/<commitSHA>Dabei ersetzen<appId>Sie die App-ID GUID, die von angezeigt wird,ms app infound<commitSHA>den vollständigen SHA-Code, der von angezeigt wirdgit log -1. -
https://play.managedapps.cloud.microsoft/apps/<appId>/branch/<branchName>. Der Standardbranchname istmain, aber du kannst auf diese Weise den Kopf eines beliebigen Git-Branches spielen.
Zusätzlich zum Erstellen von Apps bei Bedarf über die Vorschau verwenden Sie den ms app build Befehl, um explizit einen Build zu starten.
Wenn ein Build fehlschlägt, unterstützen die Vorschauendpunkte weiterhin den letzten erfolgreichen Build für die App. To find out why it fail, run ms app build-status. Die Ausgabe meldet den fehlgeschlagenen Build und den Grund für den Fehler, sodass Sie den Code korrigieren und erneut pushen können.
Wenn Sie den Modus "Bring Your Own Build" verwenden, stehen Ihnen diese Vorschau-URL-Endpunkte nicht zur Verfügung. Sie sind dafür verantwortlich, den Build zu erstellen und an die Plattform zu senden.
Bereitstellen für die Produktion
Wenn die Vorschau gut aussieht, verwenden Sie sie ms app deploy , um sie auf die Produktionsversion heraufzustufen, die Sie für Endbenutzer freigeben. Weitere Entwicklungen, Commits und Vorschauen wirken sich erst auf die bereitgestellte Version aus, wenn Sie eine weitere Bereitstellung durchführen.
Die URL für die Liveproduktionsversion der App enthält keinen Commit oder Branchbezeichner. Eine brauchbare Produktions-URL könnte z. B. wie https://play.managedapps.cloud.microsoft/apps/00000000-0000-0000-0000-000000000000folgt aussehen: Diese URL ändert sich bei nachfolgenden Bereitstellungen nicht. Bis Sie die erste Bereitstellung abgeschlossen haben, zeigt das Portal den Endbenutzern eine Meldung an, dass die Bereitstellung nicht erfolgt.
Anfänglich können nur Besitzer der App die bereitgestellte App wiedergeben. Zum Teilen mit anderen verwenden ms app share . Sie können auch Benutzer verwalten https://managedapps.cloud.microsoft und teilbare URLs generieren.
Für Git-gestützte Apps ohne Schalter ms app deploy wählt das aktuelle lokale Git HEADaus. Wenn vor dem Remote nicht festgeschriebene Änderungen oder lokale Commits vorhanden sind, fordert die CLI im interaktiven Modus eine Bestätigung an und stoppt mit einem Nutzungsfehler im nicht-interaktiven oder JSON-Modus, es sei denn, Sie bestehen .--force Gehen Sie durch den Add- , Commit und Push-Flow , um die beabsichtigten Änderungen einzuschließen.
--force umgeht nur den Vorflug; Es werden keine nicht committeten oder nicht gepushten Quellen hochgeladen.
Wird verwendet ms app deploy --commit <commitSHA> , um einen bestimmten Commit bereitzustellen. Verwenden Sie diesen Befehl, um eine frühere Version der App rückgängig zu machen, wenn es Probleme mit einer neuen Bereitstellung gibt.
Die Bereitstellung verwendet einen zwischengespeicherten Build erneut oder übermittelt einen Build für den ausgewählten Commit und wartet auf den Abschluss. Wenn dieser Build fehlschlägt oder abgebrochen wird, wird die Bereitstellung beendet. Es greift nicht auf einen älteren erfolgreichen Build zurück. Die alte bereitgestellte Version bleibt unverändert.
Integrität und Nutzung überwachen
Überwachen Sie eine App nach dem Bereitstellen, um sicherzustellen, dass sie ordnungsgemäß funktioniert, und um die Nutzung zu messen. Weitere Informationen finden Sie unter Überwachen von Apps.
Zurückkehren zu einer vorherigen Version
Manchmal funktioniert eine Änderung nicht so, wie Sie es sich vorgestellt haben, und Sie möchten zur vorherigen Version zurückkehren.
Sie können jeden Commit jederzeit von jedem Branch aus bereitstellen. Überprüfen Sie git log , um zu verstehen, wer wann Änderungen vorgenommen hat und welche Nachricht zu der Änderung bereitgestellt wurde. Verwenden Sie diese Informationen, um eine Commit-ID zu identifizieren, zu der Sie rückgängig machen möchten. Verwenden Sie ms app deploy --commit <commitID> dann, um zu dieser Version rückgängig zu machen.
Die Änderung, die nicht perfekt war, ist immer noch vorhanden, weil nichts in der Quellcodeverwaltung verloren geht. Indem Sie die App für Endbenutzer wiederherstellen, können Sie einen Blick auf den problematischen Commit und den bekannten guten Commit werfen und entscheiden, wie Sie weitermachen wollen. Sie können kleine Änderungen an der Spitze oder am Kopf des Zweigs vornehmen oder einfach die alte Version vor der neuen festschreiben. Wenn Sie bereit sind, erstellen Sie einen neuen Commit am oberen Rand Ihres main Branch oder eines anderen Branchs, und stellen Sie ihn bereit.