Nakonfigurujte potrubia ALM Accelerator
Potrubia sú motormi akcelerátora ALM. Automatizujú proces ALM pre Power Platform. Sú vytvorené pomocou Azure Pipelines, služby Azure DevOps, a uložené v projekte Azure DevOps .
Na automatizáciu procesu ALM sa používajú štyri hlavné potrubia:
- Import
- Export
- Delete
- Zostavte/nasaďte
Potrubia sú navrhnuté na použitie s aplikáciou ALM Accelerator canvas. Aplikáciu nemusíte používať, ale odporúčame ju. Aplikácia poskytuje jednoduché rozhranie na vyvolanie kanálov a spôsob, ako ich nakonfigurovať bez toho, aby ste museli rozumieť základným parametrom.
Bežné scenáre potrubia ALM Accelerator
Potrubia a aplikácia ALM Accelerator majú predvolené konfigurácie, ktoré vám umožňujú rýchlo začať s ALM for Power Platform. Potrubia môžu pokrývať mnoho rôznych scenárov ALM, aby vyhovovali požiadavkám vašej organizácie. Nasledujúce časti popisujú niektoré bežné scenáre a ako ich možno pokryť prostredníctvom konfigurácie kanála, profilov nasadenia a krokov v aplikácii ALM Accelerator alebo priamo prostredníctvom kanála.
Nainštalujte kanály v jednom projekte a zdrojový kód v inom projekte
V aplikácii ALM Accelerator a v profiloch nasadenia môžete zadať projekt potrubia a zdrojový projekt. Voľba v sprievodcovi nastavením vám umožňuje zadať samostatný projekt potrubia a repo. Tieto možnosti sú užitočné, ak chcete segmentovať úložisko riešení na základe používateľov, podnikovej štruktúry alebo iných faktorov. Vo väčšine prípadov sú súbory kanálov YAML uložené v projekte potrubia a kanály na export, import a odstránenie sa vytvoria v projekte, kde je riešenie riadené zdrojom.
Spustite potrubia bez akcelerátora ALM
Aplikácia plátna ALM Accelerator poskytuje jednoduchú vrstvu tlačidiel na spustenie potrubí. Na ich spustenie však aplikáciu nepotrebujete. Ak chcete použiť kanály nezávisle od aplikácie, spustite ich priamo z príkazového riadku. Môžete si tiež vytvoriť svoju vlastnú aplikáciu. Použite vlastný konektor pre Azure DevOps API, ktorý je súčasťou riešenia ALM Accelerator, na vyvolanie potrubí pomocou Power Automate alebo iného Power Platform technológií.
V každom prípade, ak chcete použiť potrubia nezávisle, kľúčom je pochopiť parametre, ktoré sa im odovzdávajú.
Parametre potrubia
Parametre pre import-unmanaged-to-dev-environment: Na importovanie nespravovaného riešenia z kontroly zdroja do vývojového prostredia použite kanál riešenia importu.
Nasledujúca tabuľka popisuje parametre importovacieho kanála.
| Parameter | Príklad | Description |
|---|---|---|
| Project | Môj Azure DevOps Projekt | Názov projektu, do ktorého sa má importovať riešenie |
| Odkladací priestor | Môj Azure DevOps Repo | Názov odkladacieho priestoru, z ktorého sa má importovať riešenie |
| SolutionName | MySolutionName | Názov riešenia, ktoré sa má importovať |
| me@example.com | E-mailová adresa používateľa importujúceho riešenie | |
| UserName | Priezvisko, meno | Meno používateľa importujúceho riešenie |
| Vetva | main | Vetva, z ktorej sa má vytvoriť riešenie a importovať |
| ServiceConnectionName | MyServiceConnection | Názov servisného pripojenia, ktoré sa má použiť na import |
| ServiceConnectionUrl | example.crm.dynamics.com | Adresa URL prostredia výrobcu pre import |
| EnvironmentName | MyDevEnvironment | Používa sa na nájdenie nastavení nasadenia v potrubí nasadenia; vráti názov priečinka pod konfiguračným adresárom v zdroji riešenia |
Parametre pre delete-unmanaged-solution-and-components: Použite kanál na odstránenie riešenia na odstránenie nespravovaného riešenia a všetkých jeho komponentov z vývojového prostredia.
Nasledujúca tabuľka popisuje parametre vymazávacieho kanála.
| Parameter | Príklad | Description |
|---|---|---|
| SolutionName | MySolutionName | Názov riešenia, ktoré sa má odstrániť |
| ServiceConnectionName | MyServiceConnection | Názov servisného pripojenia, ktoré sa má použiť na odstránenie riešenia |
| ServiceConnectionUrl | example.crm.dynamics.com | Adresa URL prostredia výrobcu pre riešenie, ktoré sa má odstrániť |
Parametre pre export-solution-to-git: Na export riešenia do úložiska Git použite kanál exportného riešenia.
Nasledujúca tabuľka popisuje parametre exportného kanála.
| Parameter | Príklad | Description |
|---|---|---|
| Project | Môj Azure DevOps Projekt | Názov projektu, do ktorého sa má exportovať zdrojový kód riešenia |
| Odkladací priestor | Môj Azure DevOps Repo | Názov odkladacieho priestoru, do ktorého sa má exportovať zdrojový kód riešenia |
| SolutionName | MySolutionName | Názov riešenia, ktoré sa má exportovať |
| me@example.com | E-mailová adresa používateľa exportujúceho riešenie | |
| UserName | Priezvisko, meno | Meno používateľa exportujúceho riešenie |
| CommitMessage | Oprava chyby č. 1234 | Popis zmien, ktoré sa majú uložiť pri odovzdaní do odkladacieho priestoru |
| Vetva | main | Buď zdrojová vetva, z ktorej sa má vytvoriť vetva, alebo existujúca vetva, do ktorej sa má zaviazať |
| BranchToCreate | feature-1234 | Jedinečný názov novej pobočky, ktorá sa má v prípade potreby vytvoriť na základe parametra Branch |
| ServiceConnectionName | MyServiceConnection | Názov servisného pripojenia, ktoré sa má použiť na export riešenia |
| ServiceConnectionUrl | example.crm.dynamics.com | Adresa URL prostredia tvorcu, kde existuje nespravované riešenie, ktoré sa má exportovať |
| Údaje | [Nastavenia nasadenia JSON] | Reťazec JSON obsahujúci nastavenia nasadenia na použitie na export a konfiguráciu kanálov nasadenia |
| PortalSiteName | MyPortalSite | Názov webovej lokality Power Pages spojenej s riešením, ktoré sa má exportovať |
Prispôsobte vytváranie verzií riešení, keď na ich export alebo nasadenie použijete kanály ALM Accelerator
V predvolenom nastavení sú exportované a nasadené riešenia verzované s použitím názvu uvedeného v súbore YAML kanála nasadenia. Potrubia ALM Accelerator vám však umožňujú prispôsobiť vytváranie verzií riešenia, keď ho exportujete alebo nasadzujete. Nasledujúce časti popisujú metódy, ktoré môžete použiť.
Exportované verzovanie
Vo všetkých nasadených prostrediach použite číslo verzie exportované kanálmi ako číslo verzie. Vytvorte premennú s názvom UseSolutionVersionFromDataverse vo svojom exportnom potrubí alebo globálnu premennú v knižnici premenných pre ALM Accelerator. Dajte mu hodnotu True. Premenná zaisťuje, že číslo verzie exportovanej vo vašom riešení sa zachová v downstream prostrediach a prejaví sa vo vašom ovládacom prvku zdroja, keď je zdroj riešenia potvrdený.
Vlastná logika verzovania
Na nastavenie verzie riešenia použite háky ALM Accelerator. Pridajte svoju vlastnú logiku do šablóny build-solution-pack-pre-hook.yml na manipuláciu so Solution.xml priamo alebo pomocou iných nástrojov, ako je verzia riešenia pac.
Vlastné vytváranie verzií podľa vlastných šablón
Možnosť priniesť svoje vlastné šablóny na generovanie kanálov nasadenia poskytuje flexibilitu pri vytváraní verzií počas počiatočného exportu riešenia. Ako príklad vytvorte kópiu a build-deploy-validation/test/prod-SampleSolution.yml a zmeňte názov zostavy z predvoleného na stratégiu tvorby verzií založenú na konfigurovať čísla spustenia alebo zostavy:
build:
- name: 1.0.$(Date:yyyyMMdd)$(Rev:.r)
...
Keď máte šablóny na svojom mieste, aktualizujte kroky nasadenia vo svojom profile nasadenia, aby na ne ukazovali.
Prispôsobenie počtu krokov nasadenia vo vašich kanáloch a názvov cieľových prostredí
Podobne ako v prípade vlastného vytvárania verzií so šablónami aj možnosť priniesť si vlastné šablóny na generovanie kanálov nasadenia poskytuje väčšiu flexibilitu pri počiatočnom exporte riešenia. Zadajte projekt, v ktorom existujú vaše šablóny, a cestu k šablóne, ktorá sa má použiť na vygenerovanie kanála nasadenia. Nastavenia pre projekt a cestu sú v profile nasadenia a v tabuľke Kroky nasadenia v administračnej aplikácii ALM Accelerator.
Cesta k šablóne je relatívna ku koreňu umiestnenia exportného kanála. Napríklad cesta k predvoleným šablónam potrubia nasadenia overovacieho prostredia je /Pipelines/build-deploy-validation-SampleSolution.yml. Ak chcete použiť šablónu v rovnakom projekte ako kanál exportu, zadajte cestu ako /Pipelines/build-deploy-validation-MyCustomTemplate.yml.
Nasledujúca tabuľka popisuje zástupné symboly v šablónach pre hodnoty špecifické pre riešenie, ktoré sa nahradia pri generovaní kanála nasadenia.
| Zástupný symbol | Description |
|---|---|
| SampleSolutionName | Názov riešenia, ktoré sa má nasadiť |
| RepositoryContainingTheBuildTemplates | Odkladací priestor obsahujúci šablóny zostavy, ktoré sa majú použiť pre kanál nasadenia |
| BranchContainingTheBuildTemplates | Vetva obsahujúca šablóny zostavy, ktoré sa majú použiť pre kanál nasadenia |
| alm-urýchľovač-skupina-premennej | Globálna skupina premenných, ktorú používajú šablóny zostavy pre kanál nasadenia |
Odporúčame vám skopírovať build-deploy-validation/test/prod-SampleSolution.yml šablónu kanála, aby ste mohli začať s vlastnou šablónou.
Vykonajte vlastné kroky vo svojich kanáloch bez úpravy predvolených šablón
Šablóny potrubí ALM Accelerator majú niekoľko bodov rozšírenia alebo hákov, ktoré môžete použiť na prispôsobenie potrubí a zároveň minimalizovať hluk z konfliktov pri zlučovaní v scenároch inovácie. Zistite viac o háčikoch ALM Accelerator.
Zapnite alebo vypnite konkrétne akcie v kanáloch
Potrubia používajú premenné na určenie, či sa má alebo nemá vykonať úloha alebo ktorá úloha z niekoľkých možností sa má vykonať. Nasledujúca tabuľka popisuje premenné, ktoré môžete nastaviť pre jednotlivé kanály alebo prostredníctvom skupiny premenných-alm-akcelerátor pre všetky kanály.
Poznámka
Ak chcete nastaviť tieto premenné pre konkrétne riešenia pri exporte, vytvorte špecifický exportný kanál na základe šablóny exportného kanála. Pomenujte to export-solution-to-git-{SolutionName}. Aplikácia ALM Accelerator používa tento exportný kanál na riešenie, a nie univerzálny export-riešenie-to-git.
| Premenná | Predvolené | Potrubia | Description |
|---|---|---|---|
| GenerateDeploymentSettings | Pravdivé | Export | Ak je hodnota false, nastavenia nasadenia sa nevygenerujú a neuložia v ovládaní zdroja. |
| UseDeploymentSettingsPlaceholders | Pravdivé | Export | Ak je hodnota false, nastavenia nasadenia nepoužívajú zástupné symboly a všetky hodnoty pre nastavenia nasadenia sa uložia do súborov deploymentSettings.json a customDeploymentSettings.json .DÔLEŽITÉ: Citlivé informácie môžu byť uložené ako obyčajný text v nastaveniach nasadenia. Tieto hodnoty môžu čítať všetci používatelia s prístupom k ovládaniu zdroja. Dávajte pozor, ak nastavíte hodnotu pre túto premennú. |
| DisableFlows | Nepravdivé | Export | Ak je pravda, všetky toky sú v rozbalenom zdrojovom kóde pred potvrdením vypnuté. |
| UseSolutionVersionFromDataverse | Nepravdivé | Export | Ak je pravda, číslo verzie exportované vo vašom riešení sa zachová v prostrediach po prúde. Číslo verzie sa odráža vo vašom ovládacom prvku zdroja, keď je zdroj riešenia potvrdený. |
| DoNotExportCurrentEnvironmentVariableValues | Nepravdivé | Export | Ak je pravda, hodnoty premenných pre aktuálne prostredie sa odstránia zo zdrojového kódu rozbaleného riešenia. |
| PublishCustomizationsBeforeExport | Pravdivé | Export | Ak je hodnota false, prispôsobenia sa pred exportom riešenia nezverejnia. Táto možnosť je užitočná, ak pracujete v zdieľanom prostredí a chcete exportovať iba najnovšie publikované prispôsobenia. |
| CacheEnabled | Pravdivé | Exportovať/nasadiť | Ak je hodnota false, ukladanie modulov PowerShell do vyrovnávacej pamäte je zakázané. Táto možnosť je užitočná, ak vaše kanály vykonávajú čistenie adresára vyrovnávacej pamäte po spustení potrubí. |
| ProcessCanvasApps | Pravdivé | Exportovať/nasadiť | Ak je hodnota false, aplikácie plátna sa nerozbalia počas exportu ani nezabalia počas zostavovania. POZNÁMKA: Funkcia rozbaľovania a balenia plátna je momentálne v ukážke. V súčasnosti sa neodporúča používať v produkčnom prostredí. Zdrojový kód plátna však nemôžete zobraziť v ovládacom prvku zdroja, pokiaľ túto premennú nenastavíte na hodnotu True. |
| DisableSolutionChecker | Nepravdivé | Nasadiť | Ak je pravda, kontrola riešení sa nespustí na každej zostave, ktorá je spustená prostredníctvom žiadosti o stiahnutie. |
| SkipSolutionImport | Nepravdivé | Nasadiť | Ak je pravda, krok importu riešenia sa počas nasadenia preskočí. Stále sa však vykonávajú ďalšie činnosti, ako je aktivácia toku a zdieľanie. |