Tutorial: Erste Schritte in GitHub Actions für Microsoft Power Platform
Dieses dreiteilige Tutorial bietet Ihnen die Möglichkeit, bewährte Methoden zur Automatisierung der Erstellung und Bereitstellung Ihrer App mithilfe von GitHub Actions für Power Platform kennenzulernen. In den ersten beiden Tutorials geht es darum, die erforderlichen Umgebungen einzurichten und eine Lösung für die spätere Verwendung mit GitHub Actions zu erstellen. Wenn Sie mit dem Erstellen von Umgebungen und Lösungen vertraut sind, können Sie die folgenden Tipps nutzen und zum dritten Tutorial springen, um mit der Verwendung von GitHub Actions für Power Platform zu beginnen.
- Drei Microsoft Dataverse-Umgebungen in Ihrem Mandanten erstellen
- (Dringend empfohlen) Einen Dienstprinzipal erstellen und die entsprechenden Berechtigungen bereitstellen
- Eine Modellgesteuerte App erstellen
- Ihre App mithilfe der Application Lifecycle Management-Automatisierung (AML-Automatisierung) bereitstellen
Tipp
Wenn Sie schon mit dem Konzept mehrerer Dataverse Umgebungen vertraut sind und wissen, wie Lösungen zum Packen Ihrer App verwendet werden, laden Sie das Beispiel ALMLab Lösung herunter und nutzen Sie es und gehen Sie dann zum letzten Tutorial in dieser Serie.
Los geht's mitt Tutorial #1 und dem erstellen von drei Dataverse Umgebungen.
Erforderlichen Umgebungen erstellen
Sie müssen in Ihrer Demoumgebung oder in Ihrem benutzerdefinierten Mandanten drei Dataverse Umgebungen erstellen oder darauf Zugreifen können. Folgen Sie zum Erstellen dieser Dashboards den Anweisungen unten. Gehen Sie andernfalls zum Ende dieses Tutorials, um die nächsten Schritte auszuführen.
Melden Sie sich beim Power Platform Admin Center mit Anmeldeinformationen an, mit denen Sie auf einen Mandanten mit einer verfügbaren Kapazität von mindestens 3 GB zugreifen können (erforderlich zum Erstellen der drei Umgebungen).
Wählen Sie im Navigationsbereich Umgebungen aus.
Wählen Sie + Neu, um Ihre erste Umgebung zu erstellen.
Die erste Umgebung sollte „Ihr Name – dev“ genannt, die Region auf „Vereinigte Staaten (Standard)“ festgelegt, der Umgebungstyp auf Sandbox (falls verfügbar) festgelegt werden. Wenn nicht, verwenden Sie „Testversion“.
- Stellen Sie sicher, dass die Umschalttaste Datenbank für diese Umgebung erstellen auf Ja festgelegt ist
Klicken Sie auf „Weiter“.
Legen Sie die gewünschte Sprache und Währung fest und stellen Sie das Optionsfeld Beispiel-Apps und -Daten bereitstellen? auf Ja festgesetzt wird, klicken Sie dann auf Speichern
Ihre Entwicklungsumgebung wurde erstellt. Führen Sie die Schritte 2 bis 7 oben aus, um eine zweite Umgebung mit dem Namen „Ihr Name – Erstellen“ zu erstellen, und erstellen Sie dann schließlich eine dritte Umgebung mit dem Namen „Ihr Name – Prod“
Jetzt verfügen Sie über die Umgebungen, die wir dafür benötigen, und sind bereit, mit den nächsten Modulen dieses Praxislabs zu beginnen.
Erstellen Sie das Dienstprinzipalkonto und geben Sie ihm Rechte für die erstellten Umgebungen
Sie müssen in Microsoft Entra ID eine Anwendungsregistrierung erstellen. Führen Sie dies für alle verwendeten DEV/BUILD/PROD-Umgebungen durch. Weitere Informationen: Tutorial: Registrieren einer App mit Microsoft Entra ID
Bitte notieren und speichern Sie bei der Erstellung der Anwendungsregistrierung die Verzeichnis-ID (Mandant) und die Anwendungs-ID (Client) der Anwendung.
Wählen Sie im Navigationsbereich der Seite Überblick die Option API-Berechtigungen aus.
Wählen Sie + Berechtigung hinzufügen aus und wählen Sie auf der Registerkarte Microsoft-APIs die Option Dynamics CRM aus.
Wählen Sie im Formular API-Berechtigung anfordern die Option Delegierte Berechtigungen aus, überprüfen Sie die Berechtigung user_impersonation und wählen Sie dann Berechtigungen hinzufügen aus.
Wählen Sie im Formular API-Berechtigung anfordern die Option PowerApps-Laufzeitdienst aus. Wählen Sie Delegierte Berechtigungen aus, überprüfen Sie die Berechtigung user_impersonation und wählen Sie dann Berechtigungen hinzufügen aus.
Wählen Sie im Formular API-Berechtigungen anfordern die Option APIs, die meine Organisation verwendet aus. Suchen Sie über das Suchfeld nach „PowerApps-Advisor“ und wählen Sie in der Ergebnisliste PowerApps-Advisor aus. Wählen Sie dann Delegierte Berechtigungen aus, überprüfen Sie die Berechtigungen Analysis.All und wählen Sie dann Berechtigungen hinzufügen aus.
Fahren Sie mit der Erstellung eines geheimen Clientschlüssels fort, indem Sie im Navigationsbereich Zertifikate und Geheimnisse auswählen.
Wählen Sie unter Geheime Clientschlüssel die Option + Neuer geheimer Clientschlüssel aus.
Geben Sie im Formular eine Beschreibung ein und wählen Sie Hinzufügen Notieren Sie sich die Zeichenfolge des geheimen Schlüssels. Es ist nicht möglich, den geheimen Schlüssel erneut anzuzeigen, nachdem Sie das Formular verlassen haben.
Anlegen von Anwendungsbenutzern
Damit der GitHub-Workflow Lösungen als Teil einer CI/CD-Pipeline bereitstellen kann, muss einem „Anwendungsbenutzer“ Zugriff auf die Umgebung gewährt werden. Ein „Anwendungsbenutzer“ stellt einen nicht lizenzierten Benutzer dar, der unter Verwendung der in den vorherigen Schritten abgeschlossenen Anwendungsregistrierung authentifiziert wird.
Melden Sie sich beim Power Platform Admin Center an.
Gehen Sie zu Umgebungen> öffnen Sie die gewünschte Umgebung >Einstellungen>Benutzer + Berechtigungen>Anwendungsbenutzer.
Wählen Sie + Neuer App-Benutzer. Auf der rechten Seite des Bildschirms wird ein Bereich geöffnet.
Wählen Sie + App hinzufügen aus. Eine Liste aller Anwendungsregistrierungen in Ihrem Microsoft Entra-Mandanten wird angezeigt. Fahren Sie mit der Auswahl des Anwendungsnamens aus der Liste der registrierten Apps fort.
Wählen Sie unter Geschäftsbereich im Dropdownfeld Ihre Umgebung als Unternehmenseinheit aus.
Wählen Sie unter Sicherheitsrollen die Option System Administrator aus und wählen Sie dann Erstellen aus. Dies ermöglicht den Dienstprinzipalzugriff auf die Umgebung.
Nachdem Sie nun den Dienstprinzipal erstellt haben, können Sie entweder den Dienstprinzipal oder den Standardbenutzernamen und das Standardkennwort für Ihren GitHub-Workflow verwenden.
Wichtig
Wenn Sie die mehrstufige Authentifizierung (MFA) aktiviert haben, ist die Dienstprinzipalauthentifizierung die Authentifizierungsmethode, die Sie verwenden sollten.
Siehe auch
Automatisieren Sie Ihren Workflow von der Idee bis zur Produktion