Microsoft Power Platform Build Tools for Azure DevOps

Použití Microsoft Power Platform Build Tools k automatizaci běžných úloh sestavení a nasazení souvisejících s aplikacemi postavenými na Microsoft Power Platform. Mezi tyto úlohy patří:

• Synchronizace metadat řešení (také označovaných jako řešení), která obsahují různé komponenty platformy, jako jsou:
  • Aplikace pro zapojení zákazníků: Dynamics 365 Sales, Customer Service, Field Service, Marketing a Project Service Automation
  • Aplikace plátna
  • Modelem řízené aplikace
  • Toky uživatelského rozhraní
  • Virtuální agenti
  • Modely AI Builder
  • Konektory mezi vývojovými prostředími a správou zdrojového kódu
• Generování atefaktů sestavení
• Nasazení do navazujících prostředí
• Zřizování nebo rušení zřízených prostředí
• Provádění kontrol statické analýzy řešení pomocí služeb kontroly Power Apps

Úlohy Microsoft Power Platform Build Tools použijte spolu s jakýmkoli jinými dostupnými úlohami Azure DevOps pro sestavení vašich kanálů buildu a vydání. Kanály, které týmy běžně vytvářejí, jsou: Iniciativa, Export z vývoje, Sestavení a Vydaná verze.

Poznámka:

Microsoft Power Platform Build Tools jsou podporovány pouze pro prostředí Microsoft Dataverse s databází. Další informace: Vytvoření prostředí s databází.

Microsoft Power Platform Build Tools jsou nyní k dispozici pro použití v regionech GCC a GCC High.

Co jsou Microsoft Power Platform Build Tools?

Microsoft Power Platform Build Tools jsou kolekcí úloh sestavení Azure DevOps pro Power Platform, které eliminují potřebu ručně stahovat vlastní nástroje a skripty pro správu životního cyklu aplikací postavených na Microsoft Power Platform.

Úkoly můžete používat jednotlivě, například importovat řešení do podřízeného prostředí, nebo společně v kanálu k přípravě scénáře, například generovat artefakt sestavení, nasadit k testování nebo odebrat změny tvůrce. Úkoly sestavení lze do značné míry kategorizovat do čtyř typů:

• Pomocník
• Kontrola kvality
• Řešení
• Správa prostředí

Další informace o dostupných úlohách naleznete na stránce Úlohy Microsoft Power Platform Build Tools.

Co je Power Platform Build Tools verze 2.0?

Kromě toho, co poskytují Power Platform Build Tools, verze 2.0 Power Platform Build Tools je založená na Power Platform CLI.

Nástroj Power Platform Build Tools verze 1.0 je založen na prostředí PowerShell. Power Platform Build Tools 2.0 je verze, která bude mít podporu a do které budou přidávány novější funkce.

Pro předchozí verze Power Platform Build Tools podle potřeby provedeme důležité aktualizace zabezpečení. Důrazně doporučujeme, aby zákazníci přešli Power Platform Build Tools verze 2.0 co nejdříve.

Důležité

Nelze kombinovat verze úloh pro Power Platform Build Tools ve vašem kanálu buildu.

Získání Microsoft Power Platform Build Tools

Microsoft Power Platform Build Tools lze instalovat do organizací Azure DevOps z Azure Marketplace.

Po instalaci budou všechny úkoly obsažené v Microsoft Power Platform Build Tools k dispozici nástroje pro vytváření, které lze přidat do jakéhokoli nového nebo stávajícího kanálu. Najdete je vyhledáním „Power Platform“.

Připojení k prostředím

Chcete-li interagovat s prostředím Microsoft Power Platform, musíte navázat připojení, aby mohly úlohy nástrojů pro sestavení provádět požadované akce. Existují dva typy připojení:

Connection type	Popis
Instanční objekt a tajný klíč klienta (doporučeno)	Používá ověřování založené na instančním objektu a podporuje vícefaktorové ověřování
Uživatelské jméno / heslo	Obecné připojení služby pomocí uživatelského jména a hesla. Nepodporuje vícefaktorové ověřování.

Konfigurace připojení služeb pomocí instančního objektu

Chcete-li nakonfigurovat připojení pomocí instančního objektu, musíte mít nejprve profil Power Platform ověřený s požadovanými oprávněními. Musíte přidat aplikaci Microsoft Entra ID a přidruženého uživatele aplikace k prostředí Dataverse.

Vytvoření instančního objektu a tajného klíče klienta

Pomocí příkazu pac admin create-service-principal vytvořte a nakonfigurujte instanční objekt, který se má používat s úlohami Microsoft Power Platform Build Tools.

Tento příkaz nejprve zaregistruje objekt aplikace a odpovídající hlavní název služby (SPN) v Microsoft Entra ID. Potom přidá aplikaci jako uživatele typu správce do tenanta Microsoft Power Platform.

Tento příkaz má dva parametry:

jméno	krátký název	Požadováno	Popis
environment	env	Ano	ID nebo adresa URL prostředí, ke kterému má být uživatel aplikace přidán.
role	r	No	Název nebo ID role zabezpečení, která má být pro uživatele aplikace použita. Výchozí hodnota je „Správce systému“. Kontrola řešení vyžaduje roli s oprávněním prvAppendmsdyn_analysisjob privilege k připojení k msdyn_analysisjob table. Role Správce systému má ve výchozím nastavení toto oprávnění.

Můžete ji použít takto:

C:\> pac admin create-service-principal  --environment <environment id>

Po úspěchu se zobrazí čtyři sloupce:

• ID klienta Power Platform
• Application ID
• Tajný kód klienta (čistý text)
• Vypršení platnosti

Příklad:

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

Pomocí zobrazených informací nakonfigurujte připojení služby Power Platform.

Důležité

Bezpečně si schovejte a uchovejte tajný klíč klienta. Jakmile je příkazový vymazán, nemůžete znovu načíst stejný tajný klíč klienta.

Konfigurace prostředí pomocí ID aplikace

Musíte přidat ID aplikace a uživatele aplikace do prostředí Microsoft Power Platform, ke kterému se připojujete. Jsou dva způsoby, jak to můžete udělat.

• Můžete si přečíst tento článek: Vytvoření uživatele aplikace.
• Můžete použít rozhraní příkazového řádku Power Platform. Příklad:

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

Ujistěte se, že přidaný uživatel aplikace má přiřazenu roli správce systému (k dispozici v části „Správa rolí“ v nastavení zabezpečení pro uživatele aplikace).

Nejčastější dotazy

Bude můj starý kanál buildu Microsoft Power Platform nadále fungovat?

Starší kanály nadále fungují, ale ke starším úlohám nebudou přidány novější funkce. Pokud chcete uplatnit novější funkce, důrazně doporučujeme, abyste změnili verzi úlohy kanálu.

Proč jste založili nový úkol na Power Platform CLI místo na PowerShell?

Úlohy Power Platform CLI jsou multiplatformní s velkou flexibilitou, včetně běhu na linuxových spuštěčích. Jedná se o stejné úkoly, které jsou k dispozici s Power Platform Actions pro GitHub. Nyní mezi nimi máte konzistentní prostředí v Azure DevOps a GitHub.

Fungují nástroje Microsoft Power Platform Build Tools pro Power Apps?

Nástroje sestavení fungují jak pro aplikace plátna, tak pro modelem řízené aplikace, Power Virtual Agents, toky uživatelského rozhraní a tradiční toky, AI Builder, vlastní konektory a toky dat, které lze nyní přidat do řešení. Tento seznam zahrnuje také aplikace pro zapojení zákazníků (Dynamics 365 Sales, Customer Service, Field Service, Marketing a Project Service Automation). Pro aplikace Finance a Provoz jsou k dispozici samostatné úlohy sestavení.

Již dříve jsem nainstaloval náhled Build Tools - mohu upgradovat z náhledu Power Apps Build Tools na Power Platform Build Tools?

Nemůžete upgradovat z verze Preview, protože jsme museli zavést některé změny způsobující chybu v obecně dostupné verzi. Chcete-li přejít z verze Preview, musíte nainstalovat Microsoft Power Platform Build Tools a buď znovu sestavit své kanály, nebo překonfigurovat své stávající kanály tak, aby mohly používat nové úkoly nástrojů Build Tools. Musíte také vytvořit nová připojení ke službě.

Mohu zahrnout toky a aplikace plátna?

Ano, toky a aplikace plátna berou v potaz řešení, takže pokud jsou tyto komponenty přidány do vašeho řešení, mohou se účastnit životního cyklu vaší aplikace. Některé kroky však stále vyžadují ruční konfiguraci. Potřebu ruční konfigurace budeme řešit později v tomto roce, když zavedeme proměnné a konektory prostředí. Seznam aktuálních omezení najdete zde: Známá omezení.

Kolik stojí Microsoft Power Platform Build Tools?

Nástroje pro sestavení jsou k dispozici zdarma. Je však vyžadováno platné předplatné k Azure DevOps pro použití Build Tools. Další informace najdete zde: Ceny Azure DevOps.

Vidím rozšíření, ale proč nemám možnost jej nainstalovat?

Pokud nevidíte možnost Instalovat, pak vám pravděpodobně chybí potřebná oprávnění k instalaci v organizaci Azure DevOps. Další informace: Správa oprávnění rozšíření.

Jak mohou vývojáři použít výsledky kontrolní úlohy?

Výstup kontrolní úlohy je soubor Sarif a VS Code a pro zobrazování a provádění akcí se soubory Sarif jsou k dispozici rozšíření Visual Studio.

Viz také

Power Platform Build Tools pro poznámky k verzi Azure DevOps
Úkoly vytváření nástrojů
Laboratoře Microsoft Power Platform Build Tools