Dostępne akcje funkcji GitHub Actions służące do administrowania platformą Microsoft Power Platform

W tym artykule przedstawiono informacje o akcjach GitHub, które są dostępne do administrowania Microsoft Power Platform.

Konfigurowanie poświadczeń do użycia w przepływach pracy GitHub

Wiele z tych akcji wymaga połączenia z środowiskiem Microsoft Dataverse. Możesz dodać nazwę główną usługi lub poświadczenia użytkownika jako wpisy tajne w repozytorium GitHub, a następnie użyć ich w przepływach pracy.

Zdefiniuj następujące parametry w swoim skrypcie akcji GitHub jako zmienne środowiska:

  • Identyfikator aplikacji: WF_APPLICATION_ID:<your application id>
  • Identyfikator dzierżawy: WF_TENANT_ID:<your tenant id>

Klucz tajny klienta będzie przechowywany jako wpis tajny w GitHub, jak opisano w Szyfrowane wpisy tajne. Klucz ten będzie przywoływany z poziomu skryptu akcji za pomocą parametru, takiego jak client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}.

Zadania administracyjne

Dostępne zadania administracyjne są opisane poniżej.

Tworzenie środowiska

Parametr Opis
user-name Nazwa użytkownika konta, z którego się łączysz.
password-secret Hasło użytkownika user-name. Hasła na GitHub są definiowane w Ustawieniach w obszarze Sekrety. Nie można pobrać wpisu tajnego po jego zdefiniowaniu i zapisaniu.
app-id Identyfikator aplikacji do użycia podczas uwierzytelniania. Parametr jest wymagany podczas uwierzytelniania za pomocą poświadczeń nazwy głównej usługi.
client-secret Klucz tajny klienta używany do uwierzytelniania potoku GitHub. Parametr jest wymagany podczas uwierzytelniania za pomocą poświadczeń nazwy głównej usługi.
tenant-id Identyfikator dzierżawcy podczas uwierzytelniania za pomocą app-id i client-secret.
name Nazwa środowiska, które zamierzasz stworzyć.
region Nazwa regionu, w którym zostanie utworzone środowisko.
Domyślna wartość to unitedstates.
typ Typ środowiska (Wersja próbna, Piaskownica, Wersja produkcyjna, SubscriptionBasedTrial).
Więcej informacji: Środowiska próbne
waluta Waluta, która ma być walutą używaną przez środowisko.
Domyślna wartość to USD.
język Język, który będzie używany dla środowiska.
Domyślna wartość to English.
szablony Szablony, które należy wdrożyć w środowisku.
Są one przekazywane jako wartości oddzielone przecinkami.
domena Nazwa domeny adresu URL środowiska.
Na przykład https://{contoso}0.crm.dynamics.com

Wartością wyjściową będzie adres URL nowego środowiska.

Kopiowanie środowiska

Parametr Opis
source-url Adres URL źródłowy środowiska do skopiowania.
Na przykład https://source-env.crm.dynamics.com
target-url Adres URL docelowy środowiska do skopiowania.
Na przykład https://target-copy-env.crm.dynamics.com
user-name Nazwa użytkownika konta, z którego się łączysz.
password-secret Hasło użytkownika user-name. Hasła na GitHub są definiowane w Ustawieniach w obszarze Sekrety. Nie można pobrać wpisu tajnego po jego zdefiniowaniu i zapisaniu.
app-id Identyfikator aplikacji do użycia podczas uwierzytelniania. Parametr jest wymagany podczas uwierzytelniania za pomocą poświadczeń nazwy głównej usługi.
client-secret Klucz tajny klienta używany do uwierzytelniania potoku GitHub. Parametr jest wymagany podczas uwierzytelniania za pomocą poświadczeń nazwy głównej usługi.
tenant-id Identyfikator dzierżawcy podczas uwierzytelniania za pomocą app-id i client-secret.

Tworzenie kopii zapasowej środowiska

Parametr Opis
adres URL środowiska Adres URL środowiska, z którego trzeba zrobić kopię zapasową.
Na przykład https://env-to-backup.crm.dynamics.com
backup-label Znacząca nazwa do użycia jako etykieta dla kopii zapasowej środowiska.
user-name Nazwa użytkownika konta, z którego się łączysz.
password-secret Hasło użytkownika user-name. Hasła na GitHub są definiowane w Ustawieniach w obszarze Sekrety. Nie można pobrać wpisu tajnego po jego zdefiniowaniu i zapisaniu.
app-id Identyfikator aplikacji do użycia podczas uwierzytelniania. Parametr jest wymagany podczas uwierzytelniania za pomocą poświadczeń nazwy głównej usługi.
client-secret Klucz tajny klienta używany do uwierzytelniania potoku GitHub. Parametr jest wymagany podczas uwierzytelniania za pomocą poświadczeń nazwy głównej usługi.
tenant-id Identyfikator dzierżawcy podczas uwierzytelniania za pomocą app-id i client-secret.

Przywracanie środowiska z kopii zapasowej

Parametr Opis
source-url Adres URL źródłowy środowiska do przywrócenia.
Na przykład https://env-backup-source.crm.dynamics.com
target-url Docelowy adres URL środowiska, do którego ma być przywrócony system.
Na przykład https://env-target-restore.crm.dynamics.com
user-name Nazwa użytkownika konta, z którego się łączysz.
password-secret Hasło użytkownika user-name. Hasła na GitHub są definiowane w Ustawieniach w obszarze Sekrety. Nie można pobrać wpisu tajnego po jego zdefiniowaniu i zapisaniu.
app-id Identyfikator aplikacji do użycia podczas uwierzytelniania. Parametr jest wymagany podczas uwierzytelniania za pomocą poświadczeń nazwy głównej usługi.
client-secret Klucz tajny klienta używany do uwierzytelniania potoku GitHub. Parametr jest wymagany podczas uwierzytelniania za pomocą poświadczeń nazwy głównej usługi.
tenant-id Identyfikator dzierżawcy podczas uwierzytelniania za pomocą app-id i client-secret.

Resetowanie środowiska

Parametr Opis
adres URL środowiska Adres URL środowiska, które wymaga zresetowania.
Na przykład: https://env-to-reset.crm.dynamics.com
user-name Nazwa użytkownika konta, z którego się łączysz.
password-secret Hasło użytkownika user-name. Hasła na GitHub są definiowane w Ustawieniach w obszarze Sekrety. Nie można pobrać wpisu tajnego po jego zdefiniowaniu i zapisaniu.
app-id Identyfikator aplikacji do użycia podczas uwierzytelniania. Parametr jest wymagany podczas uwierzytelniania za pomocą poświadczeń nazwy głównej usługi.
client-secret Klucz tajny klienta używany do uwierzytelniania potoku GitHub. Parametr jest wymagany podczas uwierzytelniania za pomocą poświadczeń nazwy głównej usługi.
tenant-id Identyfikator dzierżawcy podczas uwierzytelniania za pomocą app-id i client-secret.

Usuwanie środowiska

Parametr Opis
adres URL środowiska Adres URL środowiska, które wymaga usunięcia.
Na przykład https://env-to-delete.crm.dynamics.com
user-name Nazwa użytkownika konta, z którego się łączysz.
password-secret Hasło użytkownika user-name. Hasła na GitHub są definiowane w Ustawieniach w obszarze Sekrety. Nie można pobrać wpisu tajnego po jego zdefiniowaniu i zapisaniu.
app-id Identyfikator aplikacji do użycia podczas uwierzytelniania. Parametr jest wymagany podczas uwierzytelniania za pomocą poświadczeń nazwy głównej usługi.
client-secret Klucz tajny klienta używany do uwierzytelniania potoku GitHub. Parametr jest wymagany podczas uwierzytelniania za pomocą poświadczeń nazwy głównej usługi.
tenant-id Identyfikator dzierżawcy podczas uwierzytelniania za pomocą app-id i client-secret.

Zadania pomocy

Dostępne zadania pomocy są opisane poniżej.

WhoAmI

Weryfikuje połączenie usługi, łącząc się z usługą i wysyłając żądanie WhoAmI [SDK/Web API]. To zadanie może być przydatne na wczesnym etapie procesu DevOps, aby przed rozpoczęciem przetwarzania sprawdzić łączność.

Parametr Opis
adres URL środowiska Adres URL środowiska, z którym się łączysz.
user-name Nazwa użytkownika konta, z którego się łączysz.
password-secret Hasło użytkownika user-name. Hasła na GitHub są definiowane w Ustawieniach w obszarze Sekrety. Nie można pobrać wpisu tajnego po jego zdefiniowaniu i zapisaniu.
app-id Identyfikator aplikacji do użycia podczas uwierzytelniania. Parametr jest wymagany podczas uwierzytelniania za pomocą poświadczeń nazwy głównej usługi.
client-secret Klucz tajny klienta używany do uwierzytelniania potoku GitHub. Parametr jest wymagany podczas uwierzytelniania za pomocą poświadczeń nazwy głównej usługi.
tenant-id Identyfikator dzierżawcy podczas uwierzytelniania za pomocą app-id i client-secret.

Tworzenie i zwalnianie potoku

Aby dowiedzieć się więcej o tworzeniu przepływów pracy i potoków z wieloma akcjami własnoręcznie przy użyciu akcji GitHub dla platformy Microsoft Power Platform, wykonaj ćwiczenia laboratoryjne na akcjach GitHub dla platformy Microsoft Power Platform.

Więcej informacji: Informacje o akcjach GitHub

Zobacz także

Akcje usługi GitHub dla Microsoft Power Platform