Dostępne akcje funkcji GitHub Actions służące do rozwoju platformy Microsoft Power Platform
Akcje usługi GitHub dla Microsoft Power Platform zostały opisane w poniższych sekcjach. Dodatkowo są wyświetlane przykładowe przepływy pracy GitHub. Aby uzyskać więcej informacji na temat akcji GitHub i sposobu ich pobierania, przejdź do tematu Akcje GitHub dla platformy Microsoft Power Platform.
Konfigurowanie poświadczeń do używania z akcjami GitHub i Microsoft Power Platform
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.
Aby uzyskać szczegółowe informacje na temat konfigurowania wpisów tajnych w GitHub, zobacz szyfrowane wpisy tajne
Aby uzyskać szczegółowe informacje na temat sposobu konfigurowania uwierzytelniania nazwy głównej usługi dla Microsoft Power Platform, zobacz narzędzia do kompilacji DevOps
Po skonfigurowaniu można wywołać nazwę główną usługi z poziomu skryptów akcji.
Parametry do zdefiniowania w skrypcie akcji GitHub jako zmienne środowiska:
- Wprowadź identyfikator, taki jak:
WF_APPLICATION_ID:<your application id> - Identyfikator dzierżawcy, taki jak:
WF_TENANT_ID:<your tenant id>
Następnie należy dodać i zapisać klucz tajny klienta jako wpis tajny GitHub. Klucz ten będzie przywoływany z poziomu przepływu pracy za pomocą parametru, takiego jak: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Zadania pomocy
Dostępne zadanie pomocy opisano poniżej.
Akcje — instalacja
Gdy przepływ pracy akcje GitHub wymusza instalację Power Platform, w którym występuje kod CLI w kontekście modułu uruchamiającego i błędu limitu czasu, należy użyć wersji 1 (@v1) z dodatkową akcją (actions-install) jak poniżej.
Ważne
- Zastosowanie wersji 1 (@v1) może doprowadzić do aktualizacji istniejących akcji GitHub, które mogą powodować aktualizowanie bieżących przepływów pracy.
- Zadanie Instaluj Power Platform Tools należy dodać jako pierwsze zadanie w przepływie pracy przed innymi akcjami GitHub w Power Platform.
jobs:
builds:
runs-on: windows-latest # alternate runner OS is: ubuntu-latest
steps:
- name: Install Power Platform Tools
uses: microsoft/powerplatform-actions/actions-install@v1
- name: Export Solution
uses: microsoft/powerplatform-actions/export-solution@v1
with:
environment-url: 'https://myenv.crm.dynamics.com'
user-name: 'me@myenv.onmicrosoft.com'
password-secret: ${{ secrets.MYPASSWORD }}
solution-name: aSolution
solution-output-file: 'aSolution.zip'
working-directory: 'out'
Dodatkowe przykłady akcji GitHub można znaleźć w witrynie Akcje Power Platform.
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 do dołączania na wczesnym etapie przepływu pracy w GitHub, aby sprawdzić łączność przed rozpoczęciem przetwarzania.
| 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. |
Zadania rozwiązania
Te zadania powodują wykonywanie akcji w rozwiązaniach. Obejmują następujące pozycje:
import-solution
Importuje rozwiązanie do środowiska docelowego.
| Parametr | Opis |
|---|---|
| adres URL środowiska | (Wymagane) Adres URL środowiska docelowego, do którego chcesz zaimportować rozwiązanie (na przykład https://YourOrg.crm.dynamics.com). |
| user-name | (Wymagane) Jeśli używasz uwierzytelniania za pomocą nazwy użytkownika i hasła — nazwa użytkownika konta, z którego się łączysz. |
| password-secret | (Wymagane) Jeśli używasz uwierzytelniania za pomocą nazwy użytkownika i hasła — hasło konta, z którego się łączysz. |
| solution-file | (Wymagane) Ścieżka i nazwa pliku rozwiązania, który ma zostać zaimportowany. |
| 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. |
export-solution
Powoduje wyeksportowanie rozwiązania ze środowiska źródłowego.
| Parametr | Opis |
|---|---|
| adres URL środowiska | (Wymagane) Adres URL środowiska, z którego chcesz wyeksportować rozwiązanie (na przykład https://YourOrg.crm.dynamics.com). |
| user-name | (Wymagane) Jeśli używasz uwierzytelniania za pomocą nazwy użytkownika i hasła — nazwa użytkownika konta, z którego się łączysz. |
| password-secret | (Wymagane) Jeśli używasz uwierzytelniania za pomocą nazwy użytkownika i hasła — 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. |
| solution-name | (Wymagane) Nazwa rozwiązania do wyeksportowania. Zawsze należy używać nazwy rozwiązania, a nie jego nazwy wyświetlanej. |
| solution-output-file | (Wymagane) Ścieżka i nazwa pliku z archiwum zip rozwiązania, który ma zostać wyeksportowany ze środowiska źródłowego. |
| zarządzany | (Wymagane) Ustaw wartość true, aby wyeksportować jako rozwiązanie zarządzane; wartość domyślna (false) powoduje eksportowanie jako rozwiązania niezarządzanego. |
unpack-solution
Pobiera skompresowany plik rozwiązania i rozkłada go na wiele plików XML, dzięki czemu można je łatwiej odczytać i zarządzać nimi przez system kontroli źródła.
| Parametr | Opis |
|---|---|
| solution-file | (Wymagane) Podaj ścieżkę i nazwę pliku .zip z rozwiązaniem do rozpakowania. |
| solution-folder | (Wymagane) Folder ścieżki i lokalizacji docelowej, do którego ma zostać rozpakowane rozwiązanie. |
| solution-type | (Wymagane) Typ rozwiązania do rozpakowania. Dostępne opcje to: Niezarządzane (zalecane), Zarządzane i Oba. |
pack-solution
Pakuje rozwiązanie reprezentowane w kontroli źródła do pliku solution.zip, który można zaimportować do innego środowiska.
| Parametr | Opis |
|---|---|
| solution-file | (Wymagane) Ścieżka i nazwa pliku rozwiązanie.zip, do którego należy spakować rozwiązanie (na przykład out/CI/ALMLab.zip). |
| solution-folder | (Wymagane) Ścieżka i folder źródłowy rozwiązania do spakowania. |
| solution-type | (Opcjonalnie) Rodzaj rozwiązania, które ma zostać spakowane. Dostępne opcje to: Niezarządzane (zalecane), Zarządzane i Oba. |
publish-solution
Publikuje dostosowania rozwiązania.
| Parametr | Opis |
|---|---|
| adres URL środowiska | (Wymagane) Adres URL środowiska, w którym chcesz publikować rozwiązanie (na przykład https://YourOrg.crm.dynamics.com). |
| user-name | (Wymagane) Jeśli używasz uwierzytelniania za pomocą nazwy użytkownika i hasła — nazwa użytkownika konta, z którego się łączysz. |
| password-secret | (Wymagane) Jeśli używasz uwierzytelniania za pomocą nazwy użytkownika i hasła — hasło konta, z którego się łączysz. |
| solution-file | (Wymagane) Ścieżka i nazwa pliku rozwiązania, który ma zostać zaimportowany. |
| 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. |
clone-solution
Klonuje rozwiązanie dla danego środowiska.
| Parametr | Opis |
|---|---|
| adres URL środowiska | (Wymagane) Adres URL środowiska, z którego chcesz sklonować rozwiązanie (na przykład https://YourOrg.crm.dynamics.com). |
| user-name | (Wymagane) Jeśli używasz uwierzytelniania za pomocą nazwy użytkownika i hasła — nazwa użytkownika konta, z którego się łączysz. |
| password-secret | (Wymagane) Jeśli używasz uwierzytelniania za pomocą nazwy użytkownika i hasła — hasło konta, z którego się łączysz. |
| solution-file | (Wymagane) Ścieżka i nazwa pliku rozwiązania, który ma zostać zaimportowany. |
| 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. |
| solution-name | (Wymagane) Ścieżka i nazwa pliku solution.zip potrzebnego do sklonowania (na przykład out/CI/ALMLab.zip). |
| solution-version | Wersja rozwiązania do sklonowania. |
| target-folder | Docelowy folder, w którym ma się znaleźć wyodrębnione rozwiązanie. (na przykład repozytorium Git\target-solution-folder). |
| Working-directory | Tymczasowy folder pracy w artefaktach w toku potrzebny do przechowania rozwiązania. domyslnie: root of the repository |
check-solution
Sprawdza plik rozwiązania w celu wykrycia niespójności.
| Parametr | Opis |
|---|---|
| adres URL środowiska | (Wymagane) Adres URL środowiska, z którego chcesz sklonować rozwiązanie (na przykład https://YourOrg.crm.dynamics.com). |
| user-name | (Wymagane) Jeśli używasz uwierzytelniania za pomocą nazwy użytkownika i hasła — nazwa użytkownika konta, z którego się łączysz. |
| password-secret | (Wymagane) Jeśli używasz uwierzytelniania za pomocą nazwy użytkownika i hasła — hasło konta, z którego się łączysz. |
| 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. |
| path | (Wymagane) Ścieżka i nazwa pliku rozwiązania, który ma zostać sprawdzony. |
| obszar geograficzny | Który obszar geograficzny usługi Microsoft Power Platform ma być używany. Wartość domyślna to "Stany Zjednoczone". |
| rule-level-override | Ścieżka do pliku zawierającego tablicę reguł JSON oraz ich poziomy. Akceptowane wartości to Krytyczne, Wysokie, Niskie i Informacyjne. Przykład: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}] |
| checker-logs-artifact-name | Nazwa folderu artefaktów, do którego zostaną przekazane dzienniki narzędzia Microsoft Power Platform checker. Wartość domyślna to „CheckSolutionLogs”. |
upgrade-solution
Umożliwia uaktualnienie rozwiązania.
| Parametr | Opis |
|---|---|
| adres URL środowiska | (Wymagane) Adres URL środowiska, z którego chcesz sklonować rozwiązanie (na przykład https://YourOrg.crm.dynamics.com). |
| user-name | (Wymagane) Jeśli używasz uwierzytelniania za pomocą nazwy użytkownika i hasła — nazwa użytkownika konta, z którego się łączysz. |
| password-secret | (Wymagane) Jeśli używasz uwierzytelniania za pomocą nazwy użytkownika i hasła — hasło konta, z którego się łączysz. |
| solution-file | (Wymagane) Ścieżka i nazwa pliku rozwiązania, który ma zostać zaimportowany. |
| 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. |
| solution-name | (Wymagane) Nazwa rozwiązania do uaktualnienia. |
| asynchroniczny | Uaktualnia rozwiązanie w sposób asynchroniczny. |
| max-async-wait-time | Maksymalny asynchroniczny czas oczekiwania w minutach. Domyślna wartość wynosi 60 minut. |
Zadania związane z pakietem
Zadania te wykonują działania względem pakietów i zawierają następujące elementy.
deploy-package
Umożliwia wdrożenie dll lub pliku zip zawierającego pakiet.
Uwaga
Ta akcja jest obsługiwana tylko w systemie Windows.
| Parametr | opis |
|---|---|
| adres URL środowiska | (Wymagane) Adres URL środowiska, z którego chcesz sklonować rozwiązanie (na przykład https://YourOrg.crm.dynamics.com). |
| user-name | (Wymagane) Jeśli używasz uwierzytelniania za pomocą nazwy użytkownika i hasła — nazwa użytkownika konta, z którego się łączysz. |
| password-secret | (Wymagane) Jeśli używasz uwierzytelniania za pomocą nazwy użytkownika i hasła — hasło konta, z którego się łączysz. |
| 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. |
| package | (Wymagane) Ścieżka do pliku DLL pakietu lub pliku ZIP zawierającego pakiet. |
Zadania portalu
Te zadania wykonują następujące akcje względem Power Pages.
upload-paportal
Przekazane dane do Power Pages.
| Parametr | opis |
|---|---|
| adres URL środowiska | (Wymagane) Adres URL środowiska, do którego chcesz zaimportować rozwiązanie (na przykład https://YourOrg.crm.dynamics.com). |
| 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. |
| upload-path | Ścieżka, w której przechowywana jest zawartość witryny (alias: -p). |
| deployment-profile | deploymentProfile: Prześlij dane portalu ze szczegółami środowiska zdefiniowanymi przez zmienne profilu w pliku deployment-profiles/[profile-name].deployment.yaml file. |
| model-version | Wskazuje, czy dane witryny do przekazania będą używać standardowego (1) czy ulepszonego modelu danych (2). Wartość domyślna to „1”. |
Dowiedz się więcej o obsłudze Microsoft Power Platform CLI dla Power Pages.
Zadania katalogowe (wersja zapoznawcza)
Zadania te wykonują akcje względem katalogu w Power Platform i obejmują następujące elementy.
Uwaga
Obecnie zadania katalogowe dla Power Platform są w wersji zapoznawczej.
instalacja
Zainstaluj element usługi Catalog w środowisku docelowym.
| Parametr | opis |
|---|---|
| catalog-item-id | (Wymagane) Produkt katalogowy do zainstalowania w środowisku docelowym. |
| target-url | (Wymagane) Adres URL środowiska docelowego dla instalacji produktu w katalogu (na przykład "https://YourOrg.crm.dynamics.com"). |
| ustawienia | (Wymagane) Ustawienia pakietu środowiska uruchomieniowego dla struktury instalacji do wykonania. Format ciągu wejściowego musi być następujący: key=value|key=value. |
| target-version | Docelowa wersja do zainstalowania. Jeśli pozostanie puste, wybrana zostanie wersja opublikowana. |
| poll-status | Ankieta, aby sprawdzić status zgłoszenia. |
prześlij
Lista wszystkich opublikowanych produktów katalogowych z bieżącego środowiska (organizacji) Dataverse.
| Parametr | opis |
|---|---|
| path | (Wymagane) Ścieżka do dokumentu przesyłania katalogu. |
| package-zip | Ścieżka do pliku ZIP pakietu. |
| solution-zip | Ścieżka do pliku ZIP rozwiązania. |
| poll-status | Sonduj w celu sprawdzenia stanu swojego żądania. |
stan
Pobierz stan żądania instalacji/przesłania usługi Catalog.
| Parametr | opis |
|---|---|
| tracking-id | (Wymagane) Identyfikator śledzenia żądania. |
| type | (Wymagane) Typ żądania (wartości: Zainstaluj, Prześlij) |
Tworzenie przepływu pracy GitHub
Aby dowiedzieć się więcej o tworzeniu przepływów pracy przy użyciu akcji GitHub, wykonaj akcje Laboratoria akcji GitHub dla Microsoft Power Platform.
Więcej informacji: Informacje o akcjach GitHub