Narzędzia Microsoft Power Platform Build Tools dla Azure DevOps
Użyj Microsoft Power Platform Build Tools, aby zautomatyzować typowe zadania tworzenia i wdrażania związane z aplikacjami budowanymi na Microsoft Power Platform. Do zadań mogą należeć:
- Synchronizowanie metadanych rozwiązania (nazywanego również rozwiązaniami) zawierającego różne składniki platformy, takie jak:
- Aplikacje zaangażowania klienta: Dynamics 365 Sales, Customer Service, Field Service, Marketing i Project Service Automation
- Aplikacje kanwy
- Aplikacje oparte na modelu
- Przepływy interfejsu użytkownika
- Agenci wirtualni
- Modele AI Builder
- Łączniki między środowiskami projektowymi a kontrolą źródłową
- Generowanie artefaktów kompilacji
- Wdrażanie w środowiskach z prądem podrzędnym
- Środowiska obsługi administracyjnej i usuwania inicjowania
- Wykonywanie analiz statycznych w stosunku do rozwiązań przy użyciu usługi sprawdzania Power Apps
Użyj Microsoft Power Platform Build Tools z wszelkimi innymi dostępnymi zadaniami Azure DevOps na potrzeby potoków kompilacji i wersji. Potoki, zwykle używane przez zespoły to: rozpoczęcie, eksport z programowania, utworzenie i wydanie.
Uwaga
Narzędzia Microsoft Power Platform Build Tools są obsługiwane tylko dla środowiska Microsoft Dataverse z bazą danych. Więcej informacji: Tworzenie środowiska z bazą danych.
Narzędzia Microsoft Power Platform Build Tools są już dostępne dla regionów GCC i GCC High.
Co to są narzędzia Microsoft Power Platform Build Tools?
Narzędzia Microsoft Power Platform Build Tools są zbiorem Power Platform określonych zadań kompilacji Azure DevOps, które eliminują konieczność ręcznego pobierania niestandardowych narzędzi i skryptów w celu zarządzania cyklem eksploatacji aplikacji opartych na Microsoft Power Platform.
Zadania można wykonywać pojedynczo, na przykład w celu zaimportowania rozwiązania do środowiska down danego użytkownika lub utworzyć potok w celu zastosowania scenariusza takiego jak wygenerowanie artefaktu kompilacji, wdrożenie w celu przetestowania lub zmiana twórcy importu. Zadania kompilacji można podzielić na cztery ogólne typy:
- Pomoc
- Kontrola jakości
- Rozwiązanie
- Zarządzanie środowiskiem
Aby uzyskać więcej informacji na temat dostępnych zadań, zobacz zadania Microsoft Power Platform Build Tools.
Czym jest Power Platform Build Tools w wersji 2.0?
Oprócz tego, co oferuje Power Platform Build Tools, wersja 2.0 Power Platform Build Tools jest oparta na Power Platform CLI.
Power Platform Build Tools w wersji 1.0 jest oparty na programie PowerShell. Power Platform Build Tools 2.0 to wersja, która zostanie zdysowana i dodane zostaną nowe funkcje.
W przypadku poprzednich wersji Power Platform Build Tools do tworzenia wykonajmy krytyczne aktualizacje zabezpieczeń. Zalecamy, aby klienci jak najszybciej przeszli na Power Platform Build Tools w wersji 2.0.
Ważne
Nie można mieszać i łączyć wersji zadań dla narzędzi Power Platform Build Tools w potoku budowania.
Pobierz Microsoft Power Platform Build Tools
Microsoft Power Platform Build Tools można zainstalować w organizacji Azure DevOps z Azure Marketplace.
Po ich zainstalowaniu wszystkie zadania wchodzące w skład narzędzi kompilacji Microsoft Power Platform Build Tools będą dostępne do dodania do każdego nowego lub istniejącego potoku. Można je znaleźć, wyszukując "Power Platform".
Połączenie ze środowiskiem
Aby działać ze środowiskiem Microsoft Power Platform, należy ustanowić połączenie, aby zadania narzędzia tworzenia umożliwiały wykonanie wymaganych akcji. Dostępne są dwa typy połączeń:
| Connection type | opis |
|---|---|
| Główna usługa i klient (zalecane) | Używa uwierzytelniania opartego na głównych usługach i obsługuje uwierzytelnianie wieloetapowe |
| Nazwa użytkownika/hasło | Ogólne połączenie usługi z nazwą użytkownika i hasłem. Nie obsługuje uwierzytelniania wieloetapowego. |
Konfigurowanie połączenia usługi przy użyciu podmiotu zabezpieczeń usługi
Aby skonfigurować połączenie przy użyciu głównej usługi, należy najpierw uwierzytelnić profil Power Platform z wymaganymi uprawnieniami. Należy dodać do środowiska Dataverse aplikację tożsamości Microsoft Entra i skojarzonego użytkownika aplikacji.
Utwórz główną usługę i klucz tajny klienta (zalecane)
Użyj polecenia pac admin create-service-principal, aby utworzyć i skonfigurować główną usługę, która ma być używana z zadaniami Microsoft Power Platform Build Tools.
To polecenie najpierw rejestruje obiekt aplikacji i odpowiadającą mu główną nazwę usługi (SPN) w tożsamości Microsoft Entra. Następnie dodaje aplikację jako Administrator użytkownika do dzierżawy Microsoft Power Platform.
To polecenie ma dwa parametry:
| name | krótka nazwa | Wymagania | opis |
|---|---|---|---|
environment |
env |
Tak | Identyfikator lub adres URL środowiska, do którego ma zostać przypisany użytkownik aplikacji. |
role |
r |
Nie. | Nazwa lub identyfikator roli zabezpieczeń, która ma zostać zastosowana do użytkownika aplikacji. Domyślna wartość to: „Administrator systemowe”. Sprawdzanie rozwiązania wymaga roli z uprawnieniem prvAppendmsdyn_analysisjob privilege, aby dołączać do tabeli msdyn_analysisjob. Administrator systemu domyślnie ma to uprawnienia. |
Możesz użyj w następujący sposób:
C:\> pac admin create-service-principal --environment <environment id>
Po pomyślnym sukcesie zostaną wyświetlone cztery kolumny:
- Power Platform TenantId
- Application ID
- Klucz tajny klienta (w postaci czystego tekstu)
- Wygaśnięcie
Na przykład:
PS C:\>pac admin create-service-principal --environment d3fcc479-0122-e7af-9965-bde57f69ee1d
Connected as admin@M365x57236726.onmicrosoft.com
Successfully assigned user adde6d52-9582-4932-a43a-beca5d182301 to environment d3fcc479-0122-e7af-9965-bde57f69eeld with security role System Administrator
Tenant ID Application ID Client Secret Expiration
2b0463ed-efd7-419d-927d-a9dca49d899c adde6d52-9582-4932-a43a-beca5d182301 beY8Q~JBZ~CBDgIKKBjbZ3g6BofKzoZkYj23Hbf 7/31/2024 4:27:03 PM
Użyj wyświetlanych informacji, aby skonfigurować połączenie z usługą Power Platform.
Ważne
Utrzymywanie bezpieczeństwa i bezpieczeństwo klienta. Po wyczyszczeniu wiersza polecenia nie można ponownie pobrać tego samego klienta.
Konfigurowanie środowiska pod Identyfikator aplikacji
Należy dodać identyfikator aplikacji jako użytkownika aplikacji w środowisku Microsoft Power Platform, z którym się łączysz. Można to zrobić na dwa sposoby.
- Można przejrzeć ten artykuł: Tworzenie użytkownika aplikacji.
- Możesz użyć Power Platform CLI. Na przykład:
PS C:\>pac admin assign-user --user "adde6d52-9582-4932-a43a-beca5d182301" --role "System administrator" --environment d3fcc479-0122-e7af-9965-bde57f69ee1d --application-user
Connected to... SnDemoDev
Connected as admin@M365x57236726.onmicrosoft.com
Successfully assigned user adde6d52-9582-4932-a43a-beca5d182301 to environment d3fcc479-0122-e7af-9965-bde57f69ee1d with security role System Administrator
Upewnij się, że dodany użytkownik aplikacji ma przypisaną rolę administratora systemu (dostępną w „Zarządzaj rolami” w ustawieniach bezpieczeństwa użytkownika aplikacji).
Często zadawane pytania (FAQ)
Czy moje stare rurociągi Microsoft Power Platform Build Tool będą nadal działać?
Starsze potoki nadal działają, ale do starszych zadań nie zostaną dodane nowe funkcje. Jeśli chcesz korzystać z nowszych funkcji, zdecydowanie zalecamy zmianę wersji zadania w potoku.
Dlaczego nowe zadanie opiera się na Power Platform CLI zamiast na PowerShell?
Zadania Power Platform CLI to wieloplatformowa, bardzo duża elastyczność, w tym uruchamianie na wszystkich platformach. Są to te same zadania, które są dostępne w przypadku akcji Power Platform dla GitHub. Masz teraz spójne środowisko między usługami Azure DevOps i GitHub.
Czy Microsoft Power Platform działa tylko z narzędziami budowania dla Power Apps?
Narzędzia do kompilacji działają zarówno z aplikacjami kanwy, jak i opartymi na modelach, Power Virtual Agents, UI Flows i tradycyjnymi przepływami, AI Builder, niestandardowymi łącznikami i przepływami danych, z których wszystkie można teraz dodać do rozwiązania. Na liście znajdują się też aplikacje angażujące klientów (Dynamics 365 Sales, Customer Service, Field Service, Marketing i Project Service Automation) Oddzielne zadania tworzenia są dostępne dla aplikacji Finanse i Operacje.
Poprzednio zainstalowano Podgląd narzędzi kompilacji Build Tools — czy mogę przeprowadzić uaktualnienie wersji zapoznawczej narzędzia Power Apps Build Tools do pełnej wersji Power Platform Build Tools?
Nie można uaktualnić wersji zapoznawczej, ponieważ wprowadzono kilka zmian w wersji ogólnej dostępności. Aby przejść z wersji zapoznawczej, należy zainstalować narzędzia Microsoft Power Platform Build Tools i albo odbudować potoki, albo ponownie skonfigurować istniejące potoki, aby korzystać z nowych zadań narzędzi do budowania. Należy również utworzyć nowe połączenia usługi.
Czy mogę dołączać aplikacje przepływu i kanwy?
Tak, przepływy i aplikacje kanwy rozpoznają rozwiązania, więc jeśli te składniki są dodane do rozwiązania, mogą uczestniczyć w cyklu życia aplikacji. Jednak niektóre kroki wymagają konfiguracji ręcznych. Potrzeba ręcznej konfiguracji zostanie uwzględniona jeszcze w tym roku, kiedy wprowadzimy zmienne środowiskowe i łączniki. Lista aktualnych ograniczeń jest dostępna tutaj: Znane ograniczenia.
Ile kosztują narzędzia kompilacji Microsoft Power Platform?
Narzędzia do budowania są dostępne bezpłatnie. Jednak prawidłowa subskrypcja jest wymagana Azure DevOps do korzystania z narzędzi tworzenia. Więcej informacji można znaleźć Cennik dla Azure DevOps.
Widzę rozszerzenie, ale dlaczego nie mam opcji, aby je zainstalować?
Jeśli opcja instalacji nie jest dostępna, najprawdopodobniej w organizacji nie masz niezbędnych uprawnień w organizacji Azure DevOps. Więcej informacji dostępnych Zarządzanie uprawnieniami dotyczącymi rozszerzeń.
W jaki sposób programiści mogą wykorzystać wyniki zadania sprawdzania?
Wyjście zadania sprawdzania jest dostępne w pliku Sarif, a zarówno rozszerzenia VS Code i Visual Studio mogą wyświetlać i podejmować działania na plikach Sarif.
Zobacz też
Zadania narzędzi kompilacji
Microsoft Power Platform Laboratoria narzędzi kompilacji