Sprievodca konfiguráciou nasadenia
The ALM Accelerator for Power Platform používa konfiguračné súbory vo formáte JSON na automatizáciu nasadenia vašich riešení. Nastavujú odkazy na pripojenia, premenné prostredia a povolenia, zdieľajú aplikácie plátna a aktualizujú vlastníctvo komponentov riešenia, ako sú Power Automate toky, keď sa riešenia nasadzujú do downstreamových prostredí.
Konfiguračné súbory v tomto článku vám umožňujú konfigurovať položky, ktoré sú špecifické pre prostredie, do ktorého sa riešenie nasadzuje. Konfiguračné súbory, ktoré potrebujete, a teda aj kroky, ktoré musíte vykonať v tomto článku, závisia od komponentov, ktoré nasadia vaše kanály riešení. Ak napríklad vaše riešenie obsahuje iba Dataverse tabuľky a modelom riadené aplikácie a nie je potrebná žiadna konfigurácia ani údaje pre jednotlivé prostredia, môžete niektoré z týchto krokov preskočiť.
V nastaveniach nasadenia ALMAcceleratorSampleSolution a vlastných nastaveniach nasadenia sme poskytli príklady konfiguračných súborov.
Predtým, ako začnete
Tento článok je podrobný návod na manuálne nastavenie konfiguračných súborov nasadenia. Poskytuje podrobnosti a kontext pre akcie, ktoré vykonáva aplikácia ALM Accelerator a kanály ako referenciu pre správcov, ktorí chcú poznať špecifiká každého krok v procese.
Odporúčame vám však nakonfigurovať nastavenia nasadenia v aplikácii ALM Accelerator.
Vytvorenie súboru JSON s nastaveniami nasadenia
Keď je súbor customDeploymentSettings.json uložený v koreňovom adresári config , rovnaká konfigurácia platí pre všetky prostredia. Za predpokladu, že používate úlohy kanála transformácie súborov alebo výmeny tokenov pre informácie, ktoré sú špecifické pre konkrétne prostredia, môžete v premenných kanála zadať hodnoty pre jednotlivé prostredia.
Môžete však vytvoriť aj súbory customDeploymentSettings.json pre konkrétne prostredie. Uložte ich do podadresárov adresára config pomenovaných podľa vašich prostredí. Názov adresára sa musí zhodovať s premennou EnvironmentName
, ktorú ste vytvorili pri nastavovaní kanála pre overovacie, testovacie a produkčné prostredia. Ak neexistujú žiadne nastavenia JSON a adresár nasadenia špecifické pre dané prostredie, kanály sa vrátia ku konfigurácii v koreňovom adresári config .
Môžete tiež vytvoriť konfiguračné súbory špecifické pre používateľa, ako je adresár JohannaDev na predchádzajúcom obrázku. Vývojári ich môžu použiť na výber konkrétnej konfigurácie, keď importujú nespravované riešenia z kontroly zdroja.
Súbor JSON s nastaveniami nasadenia konfiguruje odkazy na pripojenie a premenné prostredia.
{
"EnvironmentVariables": [
{
"SchemaName": "cat_shared_sharepointonline_97456712308a4e65aae18bafcd84c81f",
"Value": "#{environmentvariable.cat_shared_sharepointonline_97456712308a4e65aae18bafcd84c81f}#"
},
{
"SchemaName": "cat_shared_sharepointonline_21f63b2d26f043fb85a5c32fc0c65924",
"Value": "#{environmentvariable.cat_shared_sharepointonline_21f63b2d26f043fb85a5c32fc0c65924}#"
},
{
"SchemaName": "cat_TextEnvironmentVariable",
"Value": "#{environmentvariable.cat_TextEnvironmentVariable}#"
},
{
"SchemaName": "cat_ConnectorBaseUrl",
"Value": "#{environmentvariable.cat_ConnectorBaseUrl}#"
},
{
"SchemaName": "cat_DecimalEnvironmentVariable",
"Value": "#{environmentvariable.cat_DecimalEnvironmentVariable}#"
},
{
"SchemaName": "cat_JsonEnvironmentVariable",
"Value": "#{environmentvariable.cat_JsonEnvironmentVariable}#"
},
{
"SchemaName": "cat_ConnectorHostUrl",
"Value": "#{environmentvariable.cat_ConnectorHostUrl}#"
}
],
"ConnectionReferences": [
{
"LogicalName": "new_sharedsharepointonline_b49bb",
"ConnectionId": "#{connectionreference.new_sharedsharepointonline_b49bb}#",
"ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline"
},
{
"LogicalName": "cat_CDS_Current",
"ConnectionId": "#{connectionreference.cat_CDS_Current}#",
"ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_commondataserviceforapps"
}
]
}
Skopírujte predchádzajúcu ukážku kódu JSON do nového súboru s názvom deploymentSettings.json.
Uložte súbor do priečinka config v systéme Git.
Vytvorenie odkazu na pripojenie JSON
Vlastnosť ConnectionReferences
v súbore customDeploymentConfiguration.json nastavuje odkazy na pripojenie vo vašom riešení po importovaní riešenia do prostredia. ConnectionReferences
tiež povoliť toky po importovaní riešenia na základe vlastníka pripojenia, ktorý je špecifikovaný v premennej.
Pripojenia v cieľových prostrediach vytvorte ručne.
Skopírujte ID pre pripojenia.
Získajte logický názov pre odkaz na pripojenie z komponentu odkaz na pripojenie vo vašom riešení.
Získajte ID pripojenia z adresy URL pripojenia po jeho vytvorení. Ak je napríklad adresa URL „https://.../connections/shared_commondataservice/9f66d1d455f3474ebf24e4fa2c04cea2/details“, ID pripojenia je 9f66d1d455f3474ebf24e4fa2c04cea2.
Upravte súbor customDeploymentSettings.json a prilepte identifikátory do vlastníctva
ConnectionReferences
, ako v nasledujúcom príklade kódu:"ConnectionReferences": [ { "LogicalName": "new_sharedsharepointonline_b49bb", "ConnectionId": "#{connectionreference.new_sharedsharepointonline_b49bb}#", "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline" }, { "LogicalName": "cat_CDS_Current", "ConnectionId": "#{connectionreference.cat_CDS_Current}#", "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_commondataserviceforapps" } ]
Ak použijete rozšírenie Nahradiť tokeny a pridáte tokeny do svojej konfigurácie ako v predchádzajúcom príklade, otvorte kanál pre svoje riešenie a potom vyberte Upraviť>Premenné.
Na obrazovke Premenné potrubia vytvorte spojenie <logický názov_referencie_pripojenia>. V tomto príklade má premenná potrubia názov
connection.cat_CDS_Current
.Nastavte hodnotu na ID pripojenia, ktoré ste našli predtým.
Aby ste sa uistili, že hodnota nebude uložená ako obyčajný text, vyberte Uchovať túto hodnotu v tajnosti.
V prípade potreby zopakujte tieto kroky pre každé riešenie a kanál, ktorý vytvoríte.
Vytvorte premennú prostredia JSON v konfiguračnom súbore nasadenia
Vlastnosť EnvironmentVariables
v súbore customDeploymentConfiguration.json nastavuje Dataverse premenné prostredia vo vašom riešení po importovaní riešenia do prostredia.
Dôležité
Keď sa exportujú riešenia riadené zdrojom, hodnoty premenných prostredia sa exportujú s riešením. To môže predstavovať bezpečnostné riziko, ak premenné prostredia obsahujú citlivé informácie. Odporúčame vám neukladať citlivé informácie do premenných prostredia. Jedným zo spôsobov, ako sa uistiť, že hodnoty premenných prostredia nie sú riadené zdrojom, je vytvoriť riešenie špeciálne pre hodnoty premenných prostredia vo vašich vývojových prostrediach a nastaviť ich hodnotu v tomto riešení. Tým sa zabráni exportu hodnôt s riešením a ich uloženiu v ovládaní zdroja.
Skopírujte názov schémy pre premennú prostredia z komponentu premennej prostredia vo vašom riešení.
Upravte súbor customDeploymentSettings.json a prilepte názov do vlastnosti
EnvironmentVariables
, ako v nasledujúcom príklade kódu:{ "EnvironmentVariables": [ { "SchemaName": "cat_TextEnvironmentVariable", "Value": "#{variable.cat_TextEnvironmentVariable}#" }, { "SchemaName": "cat_DecimalEnvironmentVariable", "Value": "#{variable.cat_DecimalEnvironmentVariable}#" }, { "SchemaName": "cat_JsonEnvironmentVariable", "Value": "{\"name\":\"#{variable.cat_JsonEnvironmentVariable.name}#\"}" } ] }
Ak použijete rozšírenie Nahradiť tokeny a pridáte tokeny do svojej konfigurácie ako v predchádzajúcom príklade, otvorte kanál pre svoje riešenie a potom vyberte Upraviť>Premenné.
Na obrazovke Premenné potrubia vytvorte premennú potrubia pre každý token vo vašej konfigurácii; napríklad variable.cat_TextEnvironmentVariable.
Nastavte hodnotu na hodnotu premennej prostredia pre dané prostredie.
Aby ste sa uistili, že hodnota nebude uložená ako obyčajný text, vyberte Uchovať túto hodnotu v tajnosti.
V prípade potreby zopakujte tieto kroky pre každé riešenie a kanál, ktorý vytvoríte.
Vytvorte súbor JSON s nastaveniami vlastného nasadenia
Súbor JSON s nastaveniami vlastného nasadenia obsahuje nastavenia, ktoré aktivujú toky v mene používateľa, určujú vlastníctvo tokov, zdieľajú aplikácie plátna so skupinami Microsoft Entra a po nasadení vytvárajú Dataverse skupinové tímy.
{
"ActivateFlowConfiguration": [
{
"solutionComponentName": "DevOpsKitSampleFlow",
"solutionComponentUniqueName": "0a43b549-50ed-ea11-a815-000d3af3a7c4",
"activateAsUser": "#{activateflow.activateas.DevOpsKitSampleFlow}#"
},
{
"solutionComponentName": "CallMeFromCanvasApp",
"solutionComponentUniqueName": "71cc728c-2487-eb11-a812-000d3a8fe6a3",
"activateAsUser": "#{activateflow.activateas.CallMeFromCanvasApp}#"
},
{
"solutionComponentName": "GetEnvironmentVariables",
"solutionComponentUniqueName": "d2f7f0e2-a1a9-eb11-b1ac-000d3a53c3c2",
"activateAsUser": "#{activateflow.activateas.GetEnvironmentVariables}#"
}
],
"SolutionComponentOwnershipConfiguration": [
{
"solutionComponentType": 29,
"solutionComponentName": "DevOpsKitSampleFlow",
"solutionComponentUniqueName": "0a43b549-50ed-ea11-a815-000d3af3a7c4",
"ownerEmail": "#{owner.ownerEmail.DevOpsKitSampleFlow}#"
},
{
"solutionComponentType": 29,
"solutionComponentName": "CallMeFromCanvasApp",
"solutionComponentUniqueName": "71cc728c-2487-eb11-a812-000d3a8fe6a3",
"ownerEmail": "#{owner.ownerEmail.CallMeFromCanvasApp}#"
},
{
"solutionComponentType": 29,
"solutionComponentName": "GetEnvironmentVariables",
"solutionComponentUniqueName": "d2f7f0e2-a1a9-eb11-b1ac-000d3a53c3c2",
"ownerEmail": "#{owner.ownerEmail.GetEnvironmentVariables}#"
}
],
"AadGroupCanvasConfiguration": [
{
"aadGroupId": "#{canvasshare.aadGroupId.DevOpsKitSampleCanvasApp}#",
"canvasNameInSolution": "cat_devopskitsamplecanvasapp_c7ec5",
"canvasDisplayName": "DevOpsKitSampleCanvasApp",
"roleName": "#{canvasshare.roleName.DevOpsKitSampleCanvasApp}#"
}
],
"AadGroupTeamConfiguration": [
{
"aadGroupTeamName": "Sample Group Team Name",
"aadSecurityGroupId": "#{team.samplegroupteamname.aadSecurityGroupId}#",
"dataverseSecurityRoleNames": [
"#{team.samplegroupteamname.role}#"
]
}
]
}
Skopírujte predchádzajúcu ukážku kódu JSON do nového súboru s názvom customDeploymentSettings.json.
Uložte súbor do priečinka config v systéme Git.
Vytvorte predvolenú premennú prostredia JSON v konfiguračnom súbore vlastného nasadenia
Vlastnosť DefaultEnvironmentVariables
v súbore customDeploymentConfiguration.json sa používa v potrubí exportu na nastavenie Dataverse predvolených premenných prostredia vo vašom riešení, keď riešenie je exportované a uložené v ovládaní zdroja.
Poznámka
Predvolené nastavenia premenných prostredia sa použijú len vtedy, ak je kanál exportu nakonfigurovaný pomocou premennej potrubia VerifyDefaultEnvironmentVariableValues = True
.
Skopírujte názov schémy pre premennú prostredia z komponentu premennej prostredia vo vašom riešení.
Upravte súbor customDeploymentSettings.json a prilepte názov do vlastnosti
DefaultEnvironmentVariables
, ako v nasledujúcom príklade kódu:{ "DefaultEnvironmentVariables": [ [ "cat_TextEnvironmentVariable", "#{defaultvariable.cat_TextEnvironmentVariable}#" ], [ "cat_DecimalEnvironmentVariable", "#{defaultvariable.cat_DecimalEnvironmentVariable}#" ], [ "cat_jsonEnvironmentVariable", "{\"name\":\"#{defaultvariable.cat_jsonEnvironmentVariable.name}#\"}" ] ] }
Ak použijete rozšírenie Nahradiť tokeny a pridáte tokeny do svojej konfigurácie ako v predchádzajúcom príklade, otvorte kanál pre svoje riešenie a potom vyberte Upraviť>Premenné.
Na obrazovke Premenné potrubia vytvorte premennú potrubia pre každý token vo svojej konfigurácii; napríklad defaultvariable.cat_TextEnvironmentVariable.
V prípade potreby zopakujte tieto kroky pre každé riešenie a kanál, ktorý vytvoríte.
Vytvorte Microsoft Entra konfiguráciu plátna skupiny JSON
Vlastnosť AadGroupCanvasConfiguration
v súbore customDeploymentConfiguration.json zdieľa aplikácie plátna vo vašom riešení s konkrétnymi Microsoft Entra skupinami po importovaní riešenia do prostredia.
Skopírujte identifikátory aplikácie canvas a skupiny Microsoft Entra .
Získajte názov schémy pre aplikáciu canvas z komponentu aplikácie canvas vo vašom riešení.
Získajte Microsoft Entra ID skupiny zo stránky Skupina na portáli Azure.
Upravte súbor customDeploymentSettings.json a prilepte identifikátory do vlastníctva
AadGroupCanvasConfiguration
, ako v nasledujúcom príklade kódu:{ "AadGroupCanvasConfiguration": [ { "aadGroupId": "#{canvasshare.aadGroupId}#", "canvasNameInSolution": "cat_devopskitsamplecanvasapp_c7ec5", "roleName": "#{canvasshare.roleName}#" } ] }
roleName
môže byťCanView
,CanViewWithShare
aCanEdit
.Ak použijete rozšírenie Nahradiť tokeny a pridáte tokeny do svojej konfigurácie ako v predchádzajúcom príklade, otvorte kanál pre svoje riešenie a potom vyberte Upraviť>Premenné.
Na obrazovke Premenné potrubia vytvorte premennú potrubia pre každý token vo vašej konfigurácii; napríklad
canvasshare.aadGroupId
.Nastavte hodnotu na Microsoft Entra ID skupiny, s ktorou musí byť aplikácia zdieľaná pre dané konkrétne prostredie.
Aby ste sa uistili, že hodnota nebude uložená ako obyčajný text, vyberte Uchovať túto hodnotu v tajnosti.
V prípade potreby zopakujte tieto kroky pre každé riešenie a kanál, ktorý vytvoríte.
Vytvorte Microsoft Entra skupinu a konfiguráciu tímu JSON
Vlastnosť AadGroupTeamConfiguration
v súbore customDeploymentConfiguration.json mapuje Dataverse tímy a roly do skupín Microsoft Entra v vaše riešenie po importovaní riešenia do prostredia.
Roly zabezpečenia musia byť pridané do vášho riešenia, ak nie sú manuálne vytvorené v cieľovom prostredí. Na tím možno použiť jednu alebo viac rolí. Roly poskytujú povolenia pre komponenty riešenia vyžadované používateľmi v skupine.
Názov Dataverse tímu môže byť z existujúceho tímu alebo nového tímu, ktorý sa vytvorí v Dataverse a namapuje sa na skupinu Microsoft Entra po importovaní riešenia.
Roly Dataverse môžu byť ľubovoľné rola zabezpečenia v Dataverse , ktoré sa použijú na tím po importovaní riešenia. Roly musia mať privilégiá k prostriedkom, ktoré riešenie vyžaduje, ako sú tabuľky a procesy.
Získajte Microsoft Entra ID skupiny zo stránky Skupina na portáli Azure ako v predchádzajúcej časti.
Upravte súbor customDeploymentSettings.json a prilepte JSON do vlastnosti
AadGroupTeamConfiguration
, ako v nasledujúcom príklade kódu:{ "AadGroupTeamConfiguration": [ { "aadGroupTeamName": "alm-accelerator-sample-solution", "aadSecurityGroupId": "#{team.aadSecurityGroupId}#", "dataverseSecurityRoleNames": [ "ALM Accelerator Sample Role" ] } ] }
Ak použijete rozšírenie Nahradiť tokeny a pridáte tokeny do svojej konfigurácie ako v predchádzajúcom príklade, otvorte kanál pre svoje riešenie a potom vyberte Upraviť>Premenné.
Na obrazovke Premenné potrubia vytvorte premennú potrubia pre každý token vo svojej konfigurácii; napríklad
team.aadSecurityGroupId
.Nastavte hodnotu na Microsoft Entra ID skupiny, ktorú chcete priradiť k tímu v Dataverse.
Aby ste sa uistili, že hodnota nebude uložená ako obyčajný text, vyberte Uchovať túto hodnotu v tajnosti.
V prípade potreby zopakujte tieto kroky pre každé riešenie a kanál, ktorý vytvoríte.
Vytvorenie vlastníctva komponentu riešenia JSON
Vlastnosť SolutionComponentOwnershipConfiguration
v súbore customDeploymentConfiguration.json priraďuje vlastníctvo komponentov riešenia Dataverse používateľom po importovaní riešenia do životné prostredie. Priradenie vlastníctva je užitočné pre komponenty, ako sú toky, ktoré štandardne vlastní hlavný používateľ služby po importovaní riešenia potrubím a organizácie ich chcú po importovaní znova priradiť.
Vlastnosť SolutionComponentOwnershipConfiguration
tiež umožňuje toky, ktoré nemajú žiadne odkazy na pripojenie. Tok je povolený zadaným používateľom, keď neexistujú žiadne odkazy na pripojenie na povolenie toku.
Poznámka
Súčasný kanál implementuje iba možnosť nastaviť vlastníctvo tokov.
Kód typu komponentu riešenia je založený na typoch komponentov špecifikovaných v odkaze na webové rozhranie API solutioncomponent EntityType. Napríklad a tok Power Automate je komponent typu 29. Typ komponentu musí byť špecifikovaný ako celočíselná hodnota bez úvodzoviek.
Získajte jedinečný názov komponentu toku Power Automate z rozbaleného riešenia.
Pri vytváraní tokov sa nevyžadujú jedinečné názvy. Jediný skutočný jedinečný identifikátor toku je interné ID, ktoré mu systém pridelí v riešení.
Získajte e-mailovú adresu vlastníka zo záznamu používateľa v Dataverse alebo Microsoft 365.
Upravte súbor customDeploymentSettings.json a prilepte JSON do vlastnosti
AadGroupTeamConfiguration
, ako v nasledujúcom príklade kódu:{ "SolutionComponentOwnershipConfiguration": [ { "solutionComponentType": 29, "solutionComponentUniqueName": "00000000-0000-0000-0000-00000000000", "ownerEmail": "#{owner.ownerEmail}#" }, { "solutionComponentType": 29, "solutionComponentUniqueName": "00000000-0000-0000-0000-00000000000", "ownerEmail": "#{owner.ownerEmail}#" } ] }
Ak použijete rozšírenie Nahradiť tokeny a pridáte tokeny do svojej konfigurácie ako v predchádzajúcom príklade, otvorte kanál pre svoje riešenie a potom vyberte Upraviť>Premenné.
Na obrazovke Premenné potrubia vytvorte premennú potrubia pre každý token vo vašej konfigurácii; napríklad
owner.ownerEmail
.Nastavte hodnotu na e-mailovú adresu vlastníka komponentu.
Aby ste sa uistili, že hodnota nebude uložená ako obyčajný text, vyberte Uchovať túto hodnotu v tajnosti.
V prípade potreby zopakujte tieto kroky pre každé riešenie a kanál, ktorý vytvoríte.
Importujte údaje zo svojho kanála
Po nasadení riešenia do cieľového prostredia možno budete chcieť importovať konfiguračné alebo počiatočné údaje do svojho Dataverse prostredia. Potrubia sú nakonfigurované na import údajov pomocou nástroja na migráciu konfigurácie, ktorý je dostupný cez NuGet. Prečítajte si viac o správe konfiguračných údajov.
Keď sú konfiguračné údaje uložené v koreňovom adresári config , rovnaké konfiguračné údaje sa nasadia do všetkých prostredí. Môžete vytvoriť konfiguračné dátové súbory špecifické pre dané prostredie. Uložte ich do podadresárov adresára config pomenovaných podľa vašich prostredí. Názov adresára sa musí zhodovať s premennou EnvironmentName
, ktorú ste vytvorili pri nastavovaní kanála pre overovacie, testovacie a produkčné prostredia. Ak neexistujú žiadne konfiguračné údaje a adresár pre špecifické prostredie, kanály sa vrátia na konfiguračné údaje v koreňovom adresári config .
Naklonujte úložisko Azure DevOps, kde má byť vaše riešenie riadené zdrojom a kde ste vytvorili kanál riešení YAML, do vášho lokálneho počítača.
Ak ste tak ešte neurobili, vytvorte adresár s názvom config v priečinku config v priečinku riešenia.
Nainštalujte nástroj Configuration Migration Tool. Postupujte podľa pokynov v časti Stiahnutie nástrojov z lokality NuGet.
Otvorte Configuration Migration Tool, vyberte Vytvoriť schému a potom vyberte Pokračovať.
Prihláste sa do nájomníka, z ktorého chcete exportovať konfiguračné údaje.
Vyberte prostredie.
Vyberte tabuľky a stĺpce, ktoré chcete exportovať.
Vyberte Uložiť a exportovať. Uložte údaje do adresárovej cesty config\ConfigurationMigrationData vo vašom lokálnom Azure DevOps repo, v priečinku pre riešenie, pre ktoré sa majú údaje importovať.
Poznámka
Potrubie hľadá tento konkrétny priečinok na importovanie údajov po importovaní vášho riešenia. Uistite sa, že názov priečinka a jeho umiestnenie sú presne také, ako sú uvedené tu.
Po zobrazení výzvy na export údajov vyberte Áno.
Vyberte rovnaké umiestnenie pre exportované údaje, vyberte Uložiť a potom vyberte Exportovať údaje.
Po dokončení exportu rozbaľte súbory zo súboru data.zip do adresára ConfigurationMigrationData . Odstráňte súbory data.zip a SampleData.xml .
Odovzdajte zmeny s vašimi údajmi Azure DevOps.