Microsoft Power Platform nástroje pro sestavení pro 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 pro řešení pomocí služby Power Apps Checker.

Úkoly Microsoft Power Platform Build Tools lze použít spolu s jinými dostupnými úkoly Azure DevOps k vytváření sestavení a kanálů vydaných verzí. 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 je kolekce úloh sestavení Power Platform určených pro Azure DevOps, které eliminují nutnost ručně stahovat vlastní nástroje a skripty pro správu životního cyklu aplikací sestavených v 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 najdete 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, je verze 2.0 Power Platform Build Tools 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í sady 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í:

Typ připojení	Popis
Instanční objekt prostřednictvím federování Identity úloh (doporučeno)	Používá ověřování založené na principu služby prostřednictvím federovaných přihlašovacích údajů. Doporučeno pro tenanty, kteří vyžadují vícefaktorové ověření.
Instanční objekt a tajný klíč klienta	Používá ověřování založené na instančním objektu služby.
Uživatelské jméno / heslo	Obecné připojení služby pomocí uživatelského jména a hesla. Nepodporuje uživatele vyžadující 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	Ne	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 pro připojení k tabulce msdyn_analysisjob. 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:

• Identifikátor tenanta Power Platform
• Identifikátor aplikace
• 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í Microsoft Power Platform CLI. 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

Budou moje staré kanály Microsoft Power Platform Build Tool 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 nový úkol založili na Power Platform CLI namísto PowerShell?

Úlohy Power Platform CLI jsou na více platformách s velkou flexibilitou, včetně běhu na linuxových spouštěčích. Jedná se o stejné úlohy, 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 pouze pro Power Apps?

Nástroje sestavení fungují pro plátnové a modelem řízené aplikace, virtuální agenty Microsoft Copilot Studio, uživatelské toky a tradiční toky, AI Builder, vlastní konektory a datové toky, z nichž všechny se teď dají 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 verze Preview 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 úkolu nástroje pro kontrolu je soubor Sarif a rozšíření VS Code a Visual Studio jsou dostupná pro zobrazení a provedení akce u souborů Sarif.

Viz také

Poznámky k verzi Power Platform Build Tools pro Azure DevOps
Úkoly vytváření nástrojů
Cvičení k Microsoft Power Platform Build Tools