Konfigurace kanálů aplikace ALM Accelerator
Kanály jsou moduly ALM Accelerator. Automatizují proces ALM pro Power Platform. Jsou vytvořeny pomocí Azure Pipelines, služby Azure DevOps, a uloženy v projektu Azure DevOps.
K automatizaci procesu ALM se používají čtyři hlavní kanály:
- Import
- Export
- Odstranění
- Sestavení/nasazení
Kanály jsou navrženy pro použití s aplikací plátna ALM Accelerator. Aplikaci používat nemusíte, ale doporučujeme to. Aplikace poskytuje jednoduché rozhraní pro vyvolání kanálu a způsob, jak je nakonfigurovat, aniž byste tomu museli rozumět podkladovým parametrům.
Běžné scénáře kanálu ALM Accelerator
Kanály a aplikace ALM Accelerator mají výchozí konfigurace, které vám umožňují rychle začít s ALM pro Power Platform. Kanál může pokrýt mnoho různých scénářů ALM, aby vyhovovaly požadavkům vaší organizace. Následující části popisují některé běžné scénáře a jak je lze pokrýt prostřednictvím konfigurace kanálu, profilů nasazení a kroků v aplikaci ALM Accelerator nebo přímo prostřednictvím kanálu.
Instalace kanálů do jednoho projektu a zdrojového kódu do jiného projektu
V aplikaci ALM Accelerator a v profilech nasazení můžete zadat projekt kanálu a projekt se zdrojovým kódem. Možnost v průvodci nastavením umožňuje zadat samostatný projekt kanálu a úložiště. Tyto možnosti jsou užitečné, pokud chcete segmentovat úložiště řešení na základě uživatelů, podnikové struktury nebo jiných faktorů. Ve většině případů jsou soubory YAML kanálu uloženy v projektu kanálu a kanály pro export, import a odstranění jsou vytvořeny v projektu, kde je řešení se správou zdrojového kódu.
Spuštění kanálů bez ALM Accelerator
Aplikace plátna ALM Accelerator poskytuje jednoduchou vrstvu tlačítek pro spouštění kanálu. K jejich spuštění však aplikaci nepotřebujete. Pokud chcete používat kanály nezávisle na aplikaci, spusťte je přímo z příkazového řádku. Můžete také vytvořit vlastní aplikaci. Použijte vlastní konektor pro rozhraní API Azure DevOps, který je součástí řešení ALM Accelerator, k vyvolání kanálů pomocí Power Automate nebo jiných technologií Power Platform.
V obou případech, pokud chcete používat kanály nezávisle, klíčem je porozumět parametrům, které jsou jim předávány.
Parametry kanálu
Parametry pro import-unmanaged-to-dev-environment: Pomocí kanálu řešení importu importujte nespravované řešení z řízení zdroje do vývojového prostředí.
V následující tabulce jsou popsány parametry kanálu importu.
| Parametr | Příklad | Popis |
|---|---|---|
| Project | Můj projekt Azure DevOps | Název projektu, do kterého se má řešení importovat |
| Úložiště | Moje úložiště Azure DevOps | Název úložiště, ze kterého se má řešení importovat |
| Název řešení | MySolutionName | Název řešení, které má být importováno |
| me@example.com | E-mailová adresa uživatele importujícího řešení | |
| UserName | Příjmení, Jméno | Uživatelské jméno uživatele importujícího řešení |
| Pobočka | main | Větev, ze které se má vytvořit řešení a importovat |
| ServiceConnectionName | MyServiceConnection | Název připojení služby, která se má použít k importu |
| ServiceConnectionUrl | example.crm.dynamics.com | Adresa URL prostředí tvůrce pro import |
| EnvironmentName | MyDevEnvironment | Používá se k nalezení nastavení nasazení v kanálu nasazení; vrátí název složky v adresáři config ve zdrojovém kódu řešení |
Parametry pro delete-unmanaged-solution-and-components: Použijte kanál odstranění řešení k odstranění nespravovaného řešení a všech jeho komponent z vývojového prostředí.
V následující tabulce jsou popsány parametry kanálu odstranění.
| Parametr | Příklad | Popis |
|---|---|---|
| Název řešení | MySolutionName | Název řešení, které se má odstranit |
| ServiceConnectionName | MyServiceConnection | Název připojení služby, která se má použít pro řešení, které se má odstranit |
| ServiceConnectionUrl | example.crm.dynamics.com | Adresa URL prostředí výrobce pro řešení, které má být odstraněno |
Parametry pro export-solution-to-git: Pomocí kanálu exportního řešení exportujte řešení do úložiště Git.
V následující tabulce jsou popsány parametry kanálu exportu.
| Parametr | Příklad | Popis |
|---|---|---|
| Project | Můj projekt Azure DevOps | Název projektu, do kterého se má zdrojový kód řešení exportovat |
| Úložiště | Moje úložiště Azure DevOps | Název úložiště, do kterého se má zdrojový kód řešení exportovat |
| Název řešení | MySolutionName | Název řešení, které má být exportováno |
| me@example.com | E-mailová adresa uživatele exportujícího řešení | |
| UserName | Příjmení, Jméno | Uživatelské jméno uživatele exportujícího řešení |
| CommitMessage | Oprava chyby č. 1234 | Popis změn, které se mají uložit do zápisu v úložišti |
| Pobočka | main | Buď zdrojová větev, ze které se má vytvořit větev, nebo existující větev, do které se má potvrdit |
| BranchToCreate | feature-1234 | Jedinečný název nové větve, kterou chcete v případě potřeby vytvořit na základě parametru Branch |
| ServiceConnectionName | MyServiceConnection | Název připojení služby, která se má použít k exportu řešení |
| ServiceConnectionUrl | example.crm.dynamics.com | Adresa URL prostředí tvůrce, kde exportované nespravované řešení existuje |
| Data | [JSON nastavení nasazení] | Řetězec JSON obsahující nastavení nasazení, které se má použít pro export a konfiguraci kanálů nasazení |
| PortalSiteName | MyPortalSite | Název webu Power Pages spojeného s řešením, které má být exportováno |
Přizpůsobení správy verzi řešení, když k jejich exportu nebo nasazení používáte kanály ALM Accelerator
Ve výchozím nastavení jsou exportovaná a nasazená řešení verzována pomocí názvu zadaného v souboru YAML kanálu nasazení. Kanály ALM Accelerator vám však umožňují přizpůsobení správy verzi řešení, když ho exportujete nebo nasazujete. Následující část popisují metody, které můžete používat.
Správa exportovaných verzí
Použijte číslo verze exportované kanály jako číslo verze ve všech nasazených prostředích. Vytvořte proměnnou s názvem UseSolutionVersionFromDataverse v kanálu exportu nebo globální proměnnou v knihovně proměnných pro ALM Accelerator. Dejte jí hodnotu True. Tato proměnná zajišťuje, že číslo verze exportované ve vašem řešení bude zachováno v prostředích pro stahování a bude reflektováno ve vaší správě zdrojového kódu, když je zdrojový kód řešení potvrzen.
Logika vlastní správy verzí
Pomocí háčků ALM Accelerator nastavte verzi řešení. Přidejte svou vlastní logiku do šablony build-solution-pack-pre-hook.yml a manipulujte se souborem Solution.xml přímo nebo pomocí jiných nástrojů, jako je verze řešení pac.
Vlastní správa verzí podle vlastních šablon
Možnost přinést vlastní šablony pro generování kanálů nasazení poskytuje flexibilitu pro správu verzí během počátečního exportu řešení. Jako příklad vytvořte kopii build-deploy-validation/test/prod-SampleSolution.yml a změňte název sestavení z výchozího na strategii správy verzí založenou na konfiguraci čísel spuštění nebo sestavení:
build:
- name: 1.0.$(Date:yyyyMMdd)$(Rev:.r)
...
Až budete mít šablony zavedené, aktualizujte kroky nasazení ve svém profilu nasazení, aby na ně odkazovaly.
Úprava počtu kroků nasazení ve vašich kanálech a názvů cílových prostředí
Podobě jako u vlastní správy verzí s šablonami možnost přinést vlastní šablony pro generování kanálů nasazení poskytuje větší flexibilitu pro správu verzí během počátečního exportu řešení. Zadejte projekt, ve kterém existují vaše šablony, a cestu k šabloně, která se má použít ke generování kanálu nasazení. Nastavení pro projekt a cestu jsou v profilu nasazení a v tabulce Kroky nasazení v aplikaci pro správu ALM Accelerator.
Cesta k šabloně je relativní ke kořenu umístění kanálu exportu. Například cesta k výchozím šablonám kanálu nasazení ověřovacího prostředí je /Pipelines/build-deploy-validation-SampleSolution.yml. Chcete-li použít šablonu ve stejném projektu jako kanál exportu, zadejte cestu jako /Pipelines/build-deploy-validation-MyCustomTemplate.yml.
Následující tabulka popisuje zástupné symboly v šablonách pro hodnoty specifické pro řešení, které jsou nahrazeny při generování kanálu nasazení.
| Zástupný symbol | Popis |
|---|---|
| SampleSolutionName | Název řešení, které má být nasazeno |
| RepositoryContainingTheBuildTemplates | Úložiště obsahující šablony sestavení, které se mají použít pro kanál nasazení |
| BranchContainingTheBuildTemplates | Větev obsahující šablony sestavení, které se mají použít pro kanál nasazení |
| alm-accelerator-variable-group | Skupina globálních proměnných, kterou šablony sestavení používají pro kanál nasazení |
Doporučujeme zkopírovat šablonu kanálu build-deploy-validation/test/prod-SampleSolution.yml, abyste mohli začít s vlastní šablonou.
Provádění vlastních kroků ve vašich kanálech bez úpravy výchozích šablon
Šablony kanálů ALM Accelerator mají několik bodů rozšíření nebo háčků, které můžete použít k přizpůsobení kanálů a zároveň minimalizovat šum z konfliktů sloučení ve scénářích upgradu. Zjistěte více o háčcích ALM Accelerator.
Zapnutí nebo vypnutí konkrétních akcí v kanálech
Kanály pomocí proměnných určují, zda se má, nebo nemá úloha provést nebo která úloha z několika možností se má provést. Následující tabulka popisuje proměnné, které můžete nastavit pro jednotlivý kanál nebo prostřednictvím alm-accelerator-variable-group pro všechny kanály.
Poznámka:
Chcete-li nastavit tyto proměnné pro konkrétní řešení při exportu, vytvořte konkrétní kanál exportu na základě šablony kanálu exportu. Pojmenujte ho export-solution-to-git-{SolutionName}. Aplikace ALM Accelerator používá tento kanál exportu pro řešení namísto kanálu general-purpose export-solution-to-git.
| Proměnná | Výchozí | Kanál(y) | Popis |
|---|---|---|---|
| GenerateDeploymentSettings | True | Export | Pokud je hodnota false, nastavení nasazení se nevygenerují a neuloží do správy zdrojového kódu. |
| UseDeploymentSettingsPlaceholders | True | Export | Pokud je hodnota false, nastavení nasazení nepoužívají zástupné symboly a všechny hodnoty nastavení nasazení se uloží do souborů deploymentSettings.json a customDeploymentSettings.json.DŮLEŽITÉ: Citlivé informace mohou být v nastavení nasazení uloženy jako prostý text. Všichni uživatelé s přístupem ke správě zdrojového kódu mohou tyto hodnoty číst. Dávejte pozor, pokud nastavíte hodnotu této proměnné. |
| DisableFlows | False | Export | Pokud je true, všechny toky jsou v rozbaleném zdrojovém kódu před potvrzením vypnuty. |
| UseSolutionVersionFromDataverse | False | Export | Pokud má hodnotu true, číslo verze exportované ve vašem řešení se zachová v prostředích pro stahování. Číslo verze se odráží ve vaší správě zdrojového kódu, když je zdrojový kód řešení potvrzen. |
| DoNotExportCurrentEnvironmentVariableValues | False | Export | Pokud je true, hodnoty proměnných pro aktuální prostředí jsou odstraněny ze zdrojového kódu rozbaleného řešení. |
| PublishCustomizationsBeforeExport | True | Export | Pokud je hodnota false, přizpůsobení se před exportem řešení nepublikují. Tato možnost je užitečná, pokud pracujete ve sdíleném prostředí a chcete exportovat pouze nejnovější publikovaná přizpůsobení. |
| CacheEnabled | True | Export/nasazení | Pokud je hodnota false, ukládání modulů PowerShell do mezipaměti je zakázáno. Tato možnost je užitečná, pokud vaše kanály provádějí čištění adresáře mezipaměti po spuštění kanálů. |
| ProcessCanvasApps | True | Export/nasazení | Pokud je hodnota false, aplikace plátna se nerozbalí během exportu ani nesbalí během sestavení. POZNÁMKA: funkce rozbalení a zabalení plátna je aktuálně v Preview. V současné době se nedoporučuje pro použití v produkčním prostředí. Zdrojový kód plátna však nemůžete zobrazit ve správě zdrojového kódu, pokud tuto proměnnou nenastavíte na hodnotu True. |
| DisableSolutionChecker | False | Nasadit | Pokud je true, kontrola řešení se nespustí na každém sestavení, které je iniciováno prostřednictvím požadavku na stažení. |
| SkipSolutionImport | False | Nasadit | Pokud je true, krok importu řešení se během nasazení vynechá. Stále se však provedou další činnosti, jako je aktivace toku a sdílení. |