Käyttöönottomäärityksen opas
ALM Accelerator for Power Platform käyttää JSON-muotoisia määritystiedostoja ratkaisujen käyttöönoton automatisoinnissa. Ne määrittävät yhteysviittauksia, ympäristön muuttujia ja oikeuksia, jakavat pohjaan perustuvia sovelluksia ja päivittyvät ratkaisun osien omistajuuksia, kuten Power Automate -työnkulkuja, kun ratkaisuja otetaan käyttöön tuotantoympäristöissä.
Tämän artikkelin määritystiedostojen avulla voit määrittää sen ympäristön kohteet, johon ratkaisu on otettu käyttöön. Tarvittavat määritystiedostot ja tässä artikkelissa tarvittavat vaiheet määräytyvät sen mukaan, mitä osia ratkaisuputkissa käytetään. Jos ratkaisu sisältää esimerkiksi vain Dataverse-taulukoita ja mallipohjaisia sovelluksia, joihin ei tarvita ympäristökohtaisia määrityksiä tai tietoja, jotkin näistä vaiheista voidaan ohittaa.
Olemme antaneet esimerkkimääritystiedostoja kohteen ALMAcceleratorSampleSolution käyttöönottoasetuksissa ja mukautetuissa käyttöönottoasetuksissa.
Ennen aloittamista
Tässä artikkelissa on vaiheittainen opas käyttöönottomääritystiedostojen määrittämiseen manuaalisesti. Siinä on tietoja ALM Accelerator -sovelluksen ja putkien suorittamista toiminnoista ja niiden kontekstista. Asiakirjassa on tietoja järjestelmänvalvojille, jotka haluavat tietää prosessin eri vaiheet.
On kuitenkin suositeltavaa määrittää käyttöönottoasetukset ALM Accelerator -sovelluksessa.
Käyttöönottoasetusten JSON-tiedoston luominen
Kun customDeploymentSettings.json-tiedosto tallennetaan config-hakemiston pääkansioon, sama määritys koskee kaikkia ympäristöjä. Olettaen, että käytät tiedostomuunnosten tai tunnuksen korvaamisen putkitehtäviä tietyille ympäristöille ominaisten tietojen saamiseksi, voit määrittää ympäristökohtaiset arvot putkimuuttujiisi.
Voit kuitenkin myös luoda ympäristökohtaisia mukautettuja customDeploymentSettings.json-tiedostoja. Tallenna ne ympäristösi mukaan nimettyyn config-hakemiston alihakemistoon. Kansion nimen on vastattava EnvironmentName-muuttujaa, jonka loit putken määrittämisen yhteydessä tarkistus-, testaus- ja tuotantoympäristöille. Jos ympäristökohtaista käyttöönottoasetusten JSON-tiedostoa ja hakemistoa ei löydy, putket palaavat config-hakemiston pääkansion määrityksiin.
Voit myös luoda käyttäjäkohtaisia määritystiedostoja, kuten edeltävän kuvan JohannaDev-hakemiston. Kehittäjät voivat niiden avulla valita tietyn määrityksen tuodessaan hallitsemattomia ratkaisuja lähteen ohjausobjektista.
Käyttöönottoasetusten JSON-tiedoston avulla määritetään yhteysviittaukset ja ympäristömuuttujat.
{
"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"
}
]
}
Kopioi yllä oleva JSON-koodinäyte uuteen deploymentSettings.json-nimiseen tiedostoon.
Tallenna tiedosto config-kansioon Gitissä.
Yhteysviitteen JSON-tiedoston luominen
Ominaisuus ConnectionReferencescustomDeploymentConfiguration.json-tiedostossa määrittää yhteysviittaukset ratkaisussasi sen jälkeen, kun ratkaisu on tuotu ympäristöön.
ConnectionReferences Ota työnkulut käyttöön myös ratkaisun tuonnin jälkeen muuttujassa määritetyn yhteyden omistajan perusteella.
Luo yhteydet manuaalisesti kohdeympäristöissä.
Kopioi yhteyksien tunnukset.
Yhteysviittauksen looginen nimi saadaan ratkaisun yhteysviite-osasta.
Yhteystunnus voidaan saada yhteyden URL-osoitteesta sen luomisen jälkeen. Esimerkiksi jos URL-osoite on 'https://.../connections/shared_commondataservice/9f66d1d455f3474ebf24e4fa2c04cea2/details', yhteyden tunnus on 9f66d1d455f3474ebf24e4fa2c04cea2.
Muokkaa customDeploymentSettings.json-tiedostoa ja liitä tunnukset
ConnectionReferences-ominaisuuteen kuten alla olevassa esimerkkikoodissa:"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" } ]Jos käytät Korvaa tunnukset -laajennusta ja lisäät tunnuksia määrityksissä kuten edellä olevassa esimerkissä, avaa ratkaisun putki ja valitse sitten Muokkaa>Muuttujat.
Luo Putkimuuttujat-näytössä yhteys <connection_reference_logicalname>. Tässä esimerkissä putkimuuttuja on nimeltään
connection.cat_CDS_Current.Määritä arvoksi aiemmin löytäsi yhteystunnus.
Jos haluat varmistaa, että arvoa ei tallenneta pelkkänä tekstinä, valitse Pidä tämä arvo salassa.
Toista tarvittaessa nämä vaiheet kullekin luotavalle ratkaisulle ja putkelle.
Ympäristön muuttujan JSON luominen käyttöönottomääritystiedostossa
Ominaisuus EnvironmentVariablescustomDeploymentConfiguration.json-tiedostossa määrittää Dataversen ympäristömuuttujat sen jälkeen, kun ratkaisu on tuotu ympäristöön.
Tärkeää
Kun lähdekoodihallittuja ratkaisuja viedään, ympäristömuuttujien arvot viedään ratkaisun mukana. Tämä voi olla tietoturvariski silloin, kun ympäristömuuttujat sisältävät luottamuksellisia tietoja. Ympäristömuuttujiin ei ole suositeltavaa tallentaa luottamuksellisia tietoja. Yksi tapa varmistaa, että ympäristömuuttujien arvot eivät ole lähteen hallinnassa, on luoda ratkaisu erityisesti ympäristömuuttujien arvoille kehitysympäristöissä ja määrittää niiden arvo kyseisessä ratkaisussa. Näin arvoja ei voi viedä ratkaisun mukana ja tallenneta lähteenhallintaan.
Kopioi ympäristömuuttujan rakennenimi ratkaisun ympäristömuuttuja-osasta.
Muokkaa customDeploymentSettings.json-tiedostoa ja liitä nimi
EnvironmentVariables-ominaisuuteen kuten alla olevassa esimerkkikoodissa:{ "EnvironmentVariables": [ { "SchemaName": "cat_TextEnvironmentVariable", "Value": "#{variable.cat_TextEnvironmentVariable}#" }, { "SchemaName": "cat_DecimalEnvironmentVariable", "Value": "#{variable.cat_DecimalEnvironmentVariable}#" }, { "SchemaName": "cat_JsonEnvironmentVariable", "Value": "{\"name\":\"#{variable.cat_JsonEnvironmentVariable.name}#\"}" } ] }Jos käytät Korvaa tunnukset -laajennusta ja lisäät tunnuksia määrityksissä kuten edellä olevassa esimerkissä, avaa ratkaisun putki ja valitse sitten Muokkaa>Muuttujat.
Luo Putkimuuttujat -näytössä putkimuuttuja kullekin määrityksen tunnukselle, esimerkiksi variable.cat_TextEnvironmentVariable.
Määritä arvoksi ympäristön muuttujan arvo.
Jos haluat varmistaa, että arvoa ei tallenneta pelkkänä tekstinä, valitse Pidä tämä arvo salassa.
Toista tarvittaessa nämä vaiheet kullekin luotavalle ratkaisulle ja putkelle.
Mukautetun käyttöönottoasetusten JSON-tiedoston luominen
Mukautettujen käyttöönottoasetusten JSON-tiedosto sisältää asetuksia, jotka aktivoivat työnkulkuja käyttäjän puolesta, määrittävät kulujen omistajuuden, jakavat pohjaan perustuvia sovelluksia Microsoft Entra -ryhmien kanssa ja luovat Dataverse-ryhmätiimejä käyttöönoton jälkeen.
{
"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}#"
]
}
]
}
Kopioi yllä oleva JSON-koodinäyte uuteen customDeploymentSettings.json-nimiseen tiedostoon.
Tallenna tiedosto config-kansioon Gitissä.
Ympäristön oletusmuuttujan JSON luominen mukautetussa käyttöönottomääritystiedostossa
Ominaisuutta DefaultEnvironmentVariables tiedostossa customDeploymentConfiguration.json käytetään vientiputkessa Dataversen oletusympäristömuuttujien määritykseen, kun ratkaisu viedään ja tallennetaan lähdeohjaustiedostoon.
Muistiinpano
Ympäristön oletusmuuttuja-asetuksia käytetään vain, jos vientiputki on määritetty putkimuuttujan VerifyDefaultEnvironmentVariableValues = True avulla.
Kopioi ympäristömuuttujan rakennenimi ratkaisun ympäristömuuttuja-osasta.
Muokkaa customDeploymentSettings.json-tiedostoa ja liitä nimi
DefaultEnvironmentVariables-ominaisuuteen kuten alla olevassa esimerkkikoodissa:{ "DefaultEnvironmentVariables": [ [ "cat_TextEnvironmentVariable", "#{defaultvariable.cat_TextEnvironmentVariable}#" ], [ "cat_DecimalEnvironmentVariable", "#{defaultvariable.cat_DecimalEnvironmentVariable}#" ], [ "cat_jsonEnvironmentVariable", "{\"name\":\"#{defaultvariable.cat_jsonEnvironmentVariable.name}#\"}" ] ] }Jos käytät Korvaa tunnukset -laajennusta ja lisäät tunnuksia määrityksissä kuten edellä olevassa esimerkissä, avaa ratkaisun putki ja valitse sitten Muokkaa>Muuttujat.
Luo Putkimuuttujat -näytössä putkimuuttuja kullekin määrityksen tunnukselle, esimerkiksi defaultvariable.cat_TextEnvironmentVariable.
Toista tarvittaessa nämä vaiheet kullekin luotavalle ratkaisulle ja putkelle.
Microsoft Entra -ryhmän pohjan määrityksen JSON-tiedoston luominen
Ominaisuus AadGroupCanvasConfiguration tiedostossa customDeploymentConfiguration.json jakaa ratkaisun pohjasovelluksia tiettyjen Microsoft Entra -ryhmien kanssa sen jälkeen, kun ratkaisu on tuotu ympäristöön.
Kopioi pohjaan perustuvan sovelluksen ja Microsoft Entra -ryhmän tunnukset.
Pohjasovelluksen rakennenimi saadaan ratkaisun pohjasovellus-osasta.
Hae Microsoft Entra -ryhmätunnus Azure-portaalin Ryhmä-sivulta.
Muokkaa customDeploymentSettings.json-tiedostoa ja liitä tunnukset
AadGroupCanvasConfiguration-ominaisuuteen kuten alla olevassa esimerkkikoodissa:{ "AadGroupCanvasConfiguration": [ { "aadGroupId": "#{canvasshare.aadGroupId}#", "canvasNameInSolution": "cat_devopskitsamplecanvasapp_c7ec5", "roleName": "#{canvasshare.roleName}#" } ] }roleNamevoi ollaCanView,CanViewWithSharejaCanEdit.Jos käytät Korvaa tunnukset -laajennusta ja lisäät tunnuksia määrityksissä kuten edellä olevassa esimerkissä, avaa ratkaisun putki ja valitse sitten Muokkaa>Muuttujat.
Luo Pipeline Variables-näytössä putkimuuttuja kullekin määrityksen tunnukselle, esimerkiksi
canvasshare.aadGroupId.Aseta arvo sen Microsoft Entra -ryhmätunnuksen arvoksi, jolle sovellus on jaettava tiettyä ympäristöä varten.
Jos haluat varmistaa, että arvoa ei tallenneta pelkkänä tekstinä, valitse Pidä tämä arvo salassa.
Toista tarvittaessa nämä vaiheet kullekin luotavalle ratkaisulle ja putkelle.
Microsoft Entra -ryhmän ja -tiimin määrityksen JSON-tiedoston luominen
Ominaisuus AadGroupTeamConfigurationcustomDeploymentConfiguration.json-tiedostossa määrittää Dataversen ryhmät ja roolit Microsoft Entra -ryhmiin ratkaisussa, kun ratkaisu on tuotu ympäristöön.
Käyttöoikeusroolit on lisättävä ratkaisuun, jos niitä ei luoda manuaalisesti kohdeympäristössä. Ryhmälle voidaan ottaa käyttöön yksi tai useita rooleja. Nämä roolit antavat oikeudet ryhmän käyttäjien tarvitsemia ratkaisun osia varten.
Dataverse-ryhmän nimi voi olla mikä tahansa aiemmin luotu ryhmä tai uusi ryhmä, joka voidaan luoda Dataversessa ja yhdistää Microsoft Entra -ryhmään sen jälkeen, kun ratkaisu on tuotu.
Dataverse-roolit voivat olla mitä tahansa käyttöoikeusrooleja Dataversessa, joita sovelletaan ryhmään ratkaisun tuomisen jälkeen. Rooleilla on oltava oikeudet ratkaisun edellyttämiin resursseihin, kuten taulukoihin ja prosesseihin.
Hae Microsoft Entra -ryhmätunnus Azure-portaalin Ryhmä-sivulta kuten edellisessä osassa.
Muokkaa customDeploymentSettings.json-tiedostoa ja liitä JSON
AadGroupTeamConfiguration-ominaisuuteen kuten alla olevassa esimerkkikoodissa:{ "AadGroupTeamConfiguration": [ { "aadGroupTeamName": "alm-accelerator-sample-solution", "aadSecurityGroupId": "#{team.aadSecurityGroupId}#", "dataverseSecurityRoleNames": [ "ALM Accelerator Sample Role" ] } ] }Jos käytät Korvaa tunnukset -laajennusta ja lisäät tunnuksia määrityksissä kuten edellä olevassa esimerkissä, avaa ratkaisun putki ja valitse sitten Muokkaa>Muuttujat.
Luo Pipeline Variables-näytössä putkimuuttuja kullekin määrityksen tunnukselle, esimerkiksi
team.aadSecurityGroupId.Määritä Microsoft Entra -ryhmän tunnukselle arvo, joka liitetään ryhmään Dataversessa.
Jos haluat varmistaa, että arvoa ei tallenneta pelkkänä tekstinä, valitse Pidä tämä arvo salassa.
Toista tarvittaessa nämä vaiheet kullekin luotavalle ratkaisulle ja putkelle.
Ratkaisun osan omistuksen JSON-tiedoston luominen
Ominaisuus SolutionComponentOwnershipConfiguration tiedostossa customDeploymentConfiguration.json määrittää ratkaisun osien omistajuuden Dataversen käyttäjille, kun ratkaisu on tuotu ympäristöön. Omistuksen määrittäminen on hyödyllistä osille, kuten työnkuluille, jotka palvelun pääkäyttäjä omistaa oletusarvoisesti, kun putki tuo ratkaisun, ja organisaatiot haluavat delegoida ne uudelleen tuonnin jälkeen.
Ominaisuus SolutionComponentOwnershipConfiguration ottaa käyttöön myös työnkulut, joilla ei ole yhteysviittauksia. Määritetty käyttäjä ottaa työnkulun käyttöön, kun työnkulkua varten ei löydy yhteysviittauksia.
Muistiinpano
Nykyinen putki ottaa käyttöön vain mahdollisuuden määrittää työnkulkujen omistajuus.
Ratkaisun osan tyyppikoodi perustuu ratkaisun osan EntityType Web API -viittauksessa määritettyihin komponenttityyppeihin. Esimerkiksi Power Automate -työnkulku on osan tyyppi 29. Osatyyppi on määritettävä kokonaislukuarvona (ilman lainausmerkkejä).
Hae Power Automate -työnkulun osan yksilöllinen nimi pakkaamattomasta ratkaisusta.
Työnkulut eivät edellytä yksilöllisiä nimiä niiden luomisen aikana. Työnkulun ainoa todellinen yksilöllinen tunnus on sisäinen tunnus, jonka avulla järjestelmä määrittää sen ratkaisussa.
Omistajan sähköpostiosoitteen voi kerätä käyttäjän tietueesta Dataversessa tai Microsoft 365:ssä.
Muokkaa customDeploymentSettings.json-tiedostoa ja liitä JSON
AadGroupTeamConfiguration-ominaisuuteen kuten alla olevassa esimerkkikoodissa:{ "SolutionComponentOwnershipConfiguration": [ { "solutionComponentType": 29, "solutionComponentUniqueName": "00000000-0000-0000-0000-00000000000", "ownerEmail": "#{owner.ownerEmail}#" }, { "solutionComponentType": 29, "solutionComponentUniqueName": "00000000-0000-0000-0000-00000000000", "ownerEmail": "#{owner.ownerEmail}#" } ] }Jos käytät Korvaa tunnukset -laajennusta ja lisäät tunnuksia määrityksissä kuten edellä olevassa esimerkissä, avaa ratkaisun putki ja valitse sitten Muokkaa>Muuttujat.
Luo Pipeline Variables-näytössä putkimuuttuja kullekin määrityksen tunnukselle, esimerkiksi
owner.ownerEmail.Määritä arvo komponentin omistajan sähköpostiosoitteeseen.
Jos haluat varmistaa, että arvoa ei tallenneta pelkkänä tekstinä, valitse Pidä tämä arvo salassa.
Toista tarvittaessa nämä vaiheet kullekin luotavalle ratkaisulle ja putkelle.
Tietojen tuominen putkesta
Kannattaa ehkä tuoda määritys- ja lähtötietoja Dataverse-ympäristöön heti, kun ratkaisu on otettu käyttöön kohdeympäristössä. Putket on määritetty tuomaan tietoja käyttämällä määritysten siirtotyökalua, joka on käytettävissä NuGetin kautta. Lue lisää määritystietojen hallinnasta.
Kun määritystiedot tallennetaan config-hakemiston pääkansioon, samat määritystiedot otetaan käyttöön kaikissa ympäristöissä. Voit luoda ympäristökohtaisia määritysdatatiedostoja. Tallenna ne ympäristösi mukaan nimettyyn config-hakemiston alihakemistoon. Kansion nimen on vastattava EnvironmentName-muuttujaa, jonka loit putken määrittämisen yhteydessä tarkistus-, testaus- ja tuotantoympäristöille. Jos ympäristökohtaisia määritystietoja ja hakemistoa ei löydy, putket palaavat config-hakemiston pääkansion määritystietoihin.
Kloonaa Azure DevOps-säilö, jossa ratkaisu on lähteen hallinnassa ja johon loit ratkaisuputken YAML-tiedoston paikalliseen tietokoneeseesi.
Jos et ole vielä tehnyt niin, luo config-niminen hakemisto ratkaisukansion config-kansioon.
Asenna Määrityksen siirtotyökalu. Noudata ohjeita, jotka ovat kohdassa Lataa työkalut NuGetista.
Avaa määritysten siirtotyökalu, valitse Luo rakenne ja valitse sitten Jatka.
Kirjaudu sisään vuokraajaan, josta haluat viedä määritystiedot.
Valitse ympäristösi.
Valitse vietävät taulukot ja sarakkeet.
Valitse Tallenna ja vie. Tallenna tiedot hakemistopolkuun config\ConfigurationMigrationData paikallisessa Azure DevOps -säilössä sen ratkaisun kansioon, jota varten tiedot tuodaan.
Muistiinpano
Putki etsii tätä tiettyä kansiota tietojen tuomiseksi ratkaisun tuonnin jälkeen. Varmista, että kansion nimi ja sijainti ovat täsmälleen tässä annettuja.
Kun ohjelma pyytää viemään tiedot, valitse Kyllä.
Valitse viedyille tiedoille sama sijainti, valitse Tallenna ja valitse sitten Vie tiedot.
Kun vienti on valmis, pura tiedostot data.zip-tiedostosta ConfigurationMigrationData-hakemistoon. Poista data.zip- ja SampleData.xml-tiedostot.
Vahvista tietojen muutokset Azure DevOpsiin.