ALM Acceleratorin manuaalinen määrittäminen (vanhentunut)

Voit määrittää ALM Accelerator for Power Platformin osat joko mukana tulevan hallintasovelluksen avulla tai manuaalisesti. Tämä artikkeli opastaa järjestelmänvalvojan sovelluksen määrittämisessä manuaalisesti, ja se on rakenteeltaan seitsemän osiota:

• Edellytykset
• Perustavanlaatuinen asennus
• Kehitysprojektin asetukset
• Ratkaisun määritys
• Ratkaisun tuominen ja sovelluksen määrittäminen
• Määritä tekijät käyttämään ALM Accelerator -sovellusta

Edellytykset

Ennen kuin asennat ALM Accelerator for Power Platformin, varmista, että olet täyttänyt seuraavat edellytykset.

• ALM Accelerator on asennettava Power Platform -ympäristöön, jossa on Microsoft Dataverse-tietokanta. Kaikki ympäristöt, joissa käytät ALM Acceleratoria ratkaisujen käyttöönottoon, vaativat myös Dataverse-tietokannan.

  Muistiinpano

  ALM Accelerator ei tällä hetkellä ole yhteensopiva Dataverse for Teamsin kanssa. Sekä ALM Accelerator -sovellus että siihen liitetyt putket olettavat, että Dataversen täyttä versiota käytetään kaikissa ympäristöissä.

  ALM Accelerator kannattaa asentaa samaan ympäristöön kuin muutkin CoE Starter Kit -ratkaisut. Lisätietoja organisaation parhaan strategian määrittämisestä:

  • Ympäristöstrategian luominen Microsoft Power Platform
  • ALM:n ympäristöstrategia

• ALM Accelerator käyttää Azure DevOps lähdekoodin hallintaan ja käyttöönottoihin. Jos sinulla ei ole Azure DevOps organisaatiota, rekisteröidy ilmaiseksi jopa viidelle käyttäjälle Azure DevOps-sivustossa.

• Tämän osion vaiheiden suorittaminen edellyttää seuraavia käyttäjiä ja käyttöoikeuksia Azure, Azure DevOps ja Power Platformissa:

  • Lisensoitu Azure käyttäjä, jolla on oikeudet luoda ja tarkastella Microsoft Entra ryhmiä, luoda sovelluksen rekisteröinteja ja antaa järjestelmänvalvojan suostumus sovellusten rekisteröinneille Microsoft Entra ID
  • Lisensoitu Azure DevOps käyttäjä, jolla on oikeudet luoda ja hallita putkia, palveluyhteyksiä, säilöjä ja laajennuksia
  • Lisensoitu Power Platform -käyttäjä, jolla on sovelluksen käyttäjien luontioikeudet ja oikeudet myöntää järjestelmänvalvojaoikeudet.

• Seuraavien yhdistinten on oltava käytettävissä yhdessä käyttöympäristössä, johon ALM Accelerator -ratkaisu tuodaan:

  • Dataverse (vanha)
  • HTTP
  • Power Apps for Makers
  • HTTP ja Microsoft Entra ID (päätepisteen käyttö https://graph.microsoft.com)
  • ALM Accelerator Custom DevOps (tämä yhdistin luodaan accelerator-ratkaisun tuonnin yhteydessä)
  • Office 365 Users
  • HTTP

• Asenna Creator Kit ympäristöön, johon asennat ALM Acceleratorin.

Perustavanlaatuinen asennus

Nämä seuraavat vaiheet ovat yleisiä ALM Acceleratorin toiminnoille, eivät projekti- tai ratkaisukohtaisia.

Sovelluksen rekisteröinnin luominen Microsoft Entra ympäristössä

Luo sovelluksen rekisteröinti ALM Acceleratorille, jotta voit myöntää sovellukselle ja siihen liittyville putkille käyttöoikeudet, joita tarvitaan toimintojen suorittamiseen Azure DevOps ja Power Apps tai Dataversessa. Se on tehtävä vain kerran.

Seuraavissa vaiheissa näytetään, miten voit luoda yksittäisen sovelluksen rekisteröinnin, jolla on oikeudet sekä Dataverseen että Azure DevOps. Voit kuitenkin luoda erilliset sovelluksen rekisteröinnit jakamaan vastuualueet. Ota huomioon, miten erilliset sovelluksen rekisteröinnit vaikuttavat sekä ylläpitoon että tietoturvaan, ennen kuin päätät sovelluksen rekisteröintistrategian.

Sovelluksen rekisteröinnin luominen

1. Kirjaudu sisään Azure-portaaliin.

2. Valitse Microsoft Entra ID>App registrations.

3. Valitse + Uusi rekisteröinti ja anna rekisteröinnille nimi, kuten ALMAcceleratorServicePrincipal.

4. Jätä kaikki muut vaihtoehdot oletusasetuksiksi ja valitse sitten Rekisteröi.

Käyttöoikeuksien lisääminen sovelluksen rekisteröintiin

1. Valitse vasemmanpuoleisessa sivupaneelissa Ohjelmointirajapinnan käyttöoikeudet.

2. Valitse + Lisää oikeus.

3. Valitse Dynamics CRM ja valitse sitten Delegoidut käyttöoikeudet ja user_impersonation.

4. Valitse Lisää käyttöoikeudet lisätäksesi Dynamics CRM -ohjelmointirajapinnan user_impersonation oikeuden sovelluksen rekisteröintiin.

5. Valitse uudelleen + Lisää käyttöoikeus.

6. Valitse Oman organisaation käyttämät ohjelmointirajapinnat -välilehti. Etsi ja valitse PowerApps-Advisor ja valitse Delegoidut käyttöoikeudet ja Analysis.All (järjestelmänvalvojan hyväksyntä ei ole pakollinen).

   Tämä oikeus tarvitaan staattisen analyysin suorittamiseen sovelluksen tarkistustoiminnon kautta.

7. Valitse Lisää käyttöoikeudet lisätäksesi PowerApps-Advisor-ohjelmointirajapinnan Analysis.All-käyttöoikeus sovelluksen rekisteröintiin.

8. Valitse uudelleen + Lisää käyttöoikeus.

9. Organisaation käyttämät Microsoft-ohjelmointirajapinnat-välilehti tai OHJELMOINTI-ohjelmointirajapinnat, jota organisaationi käyttää -välilehdessä valitse Azure DevOps ja valitse sitten Valtuutettuja käyttöoikeuksia ja user_impersonation.

   Tämä käyttöoikeus vaaditaan yhteyden muodostamiseen Azure DevOps mukautetun liittimen kautta ALM Accelerator -sovelluksessa.

10. Jos olet lisännyt Azure DevOps-käyttöoikeuden organisaationi käyttämistä APIs -välilehdestä, kopioi Application (asiakas) -tunnus käytettäväksi myöhemmin tässä prosessissa.

    Tätä käytetään DevOps Application (client) ID -tunnuksena, joka eroaa myöhemmin tässä menetelmässä kopioitavasta Application (client) ID -tunnuksesta.

    

    Jos et löydä Azure DevOps -käyttöoikeutta organisaationi käyttämiin APIs -välilehteen, saat DevOps Application (asiakas) -tunnuksen seuraavasti:

    1. Avaa yksityinen selainikkuna ja siirry kohtaan https://dev.azure.com/<your devops organization>/_apis.
    2. Kopioi kirjautumissivulla URL-osoitteeseen client_id-parametrin arvo.

    

11. Valitse Lisää käyttöoikeudet lisätäksesi Azure DevOps ohjelmointirajapinnan user_impersonation oikeuden sovelluksen rekisteröintiin.

12. Valitse Myönnä järjestelmänvalvojan suostumus <vuokraajalle>.

Asiakkaan salaisuuden ja uudelleenohjaavan URI-osoitteen määrittäminen

1. Valitse vasemmassa sivupaneelissa Varmenteet ja salasanat.

2. Valitse + Uusi asiakasohjelman salasana.

3. Valitse vanhenemispäivä ja valitse Lisää.

4. Kopioi asiakasohjelman salasanan arvo myöhempää käyttöä varten. Tämä on ainoa kerta, kun voit kopioida arvon. Muista tehdä se, ennen kuin poistut sivulta.

5. Valitse vasemmanpuoleisessa sivupaneelissa Yleiskatsaus.

6. Kopioi arvot Sovelluksen (asiakasohjelman) tunnus- ja Hakemiston (vuokraajan) tunnus -arvot.

7. Valitse Määritä.

Anna sovelluksen rekisteröinnille Power Appin hallintaoikeus

Myönnä sovelluksen rekisteröinnille Power Appin hallintaoikeudet, jotta putket voivat suorittaa tarvittavat toiminnot käyttöympäristöissäsi. Voit tehdä tämän suorittamalla seuraavan PowerShellin cmdlet-komennon vuorovaikutteisena käyttäjänä, jolla on Power Apps järjestelmänvalvojan oikeudet. Tämä komento täytyy suorittaa vain kerran, kun olet luonut sovelluksen rekisteröinnin.

Install-Module -Name Microsoft.PowerApps.Administration.PowerShell
Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobber
New-PowerAppManagementApp -ApplicationId <the Application (client) ID you copied when you created the app registration>

Asenna Azure DevOps-laajennukset

ALM Accelerator käyttää useita Azure DevOps-laajennuksia, kuten joitakin kolmannen osapuolen laajennuksia, jotka ovat saatavilla Azure DevOps Marketplacessa. Lisäksi jokainen kolmannen osapuolen laajennuksen verkkosivu ja linkki niiden lähdekoodiin on esitetty alla olevissa ohjeissa. Lue lisää Marketplace-laajennuksen julkaisijan arvioinnista.

1. Kirjaudu sisään kohtaan Azure DevOps.

2. Valitse Organisaation asetukset.

3. Valitse Yleiset>Laajennukset.

4. Hae ja asenna seuraavat laajennukset:

   • Power Platform Koontityökalut (pakollinen): Tämä laajennus sisältää Microsoftin koontitehtävät Power Platform. (https://marketplace.visualstudio.com/items?itemName=microsoft-IsvExpTools.PowerPlatform-BuildTools)

   • Korvaa tunnukset (pakollinen): Putket käyttävät tätä laajennusta korvaamaan tunnukset määritystiedostoissa ja tallentamaan suojatut arvot putkelle määritettyihin yksityisiin muuttujiin. (https://marketplace.visualstudio.com/items?itemName=qetza.replacetokens | https://github.com/qetza/vsts-replacetokens-task)

   • SARIF SAST -tarkistukset -välilehti (valinnainen): Tämän laajennuksen avulla voit visualisoida SARIF-tiedostot, jotka ratkaisun tarkistus luo koontiversion aikana. (SARIF SAST Scans Tab – Visual Studio Marketplace)

     

Kloonaa YAML-putket GitHub Azure DevOps-esiintymään

1. Siirry kohtaan https://aka.ms/coe-alm-accelerator-templates-latest-release ja kopioi uusimman version URL-osoite.

2. Kirjaudu sisään kohtaan Azure DevOps.

3. Luo projekti tai valitse olemassa oleva projekti.

4. Valitse Repos ja valitse sitten säilöluettelosta Tuo säilö.

5. Liitä vaiheessa 1 kopioitu URL-osoite kloonattuna URL-osoitteena ja valitse sitten Tuo.

6. Vahvista, että säilön oletushaara on pää. Valitse Repos ja Branches ja varmista, että main haara on merkitty oletukseksi.

   Jos se ei ole, valitse pää-haaraa vastaavat kolme pystysuuntaista pistettä (⋮) ja valitse Lisää vaihtoehtoja -valikosta Aseta oletushaaraksi.

   Muistiinpano

   Tämä repo on, jonne ratkaisuputkimallit ja vienti- ja tuontiputket ajetaan. Myöhemmin, kun luot putket ratkaisuja varten, sinun on ehkä viitattava tähän projektiin ja säilöön, jos päätät käyttää toista säilöä ratkaisujen lähteenhallintaa varten.

Putkien luominen ratkaisujen tuontia, poistoa ja vientiä varten

Luo tuonti-, poisto- ja vientiputkia, jotka perustuvat YAML-tiedostoihin Azure DevOps -koodivarastossa. Nämä putkistot suoritetaan, kun suoritat toimenpiteitä kuten tallennat muutoksia Gitiin, tuot ratkaisun tai poistat ratkaisun.

Seuraavassa taulukossa on esitetty säilön YAML-tiedoston ja siihen liittyvän putken välinen kirjeenvaihto.

1. Siirry Azure DevOps kohtaan Pipelines>Luo uusi putki.

2. Valitse koodisäilön kohdalla Azure Repos Git ja osoita sitten aiemmassa vaiheessa luomaasi Azure DevOps-säilöön, jonka kylvit putkimallien avulla.

3. Valitse Määritä putki-sivu, valitse Laajenna Azure Pipelines YAML-tiedosto ja osoita kohteeseen /Pipelines/export-solution-to-git.yml, /Pipelines/import-unmanaged-to-dev-environment.yml tai /Pipelines/delete-unmanaged-solution-and-components.yml.

4. Valitse Jatka ja valitse sitten Tallenna.

5. Valitse Lisää-valikko (…) Suorita putki -kohdan vierestä ja valitse sitten Nimeä uudelleen / Siirrä.

6. Muuta putken nimeksi export-solution-to-git, import-unmanaged-to-dev-environment tai delete-unmanaged-solution-and-components.

7. Valitse Tallenna.

Vientiputkimuuttujien luominen (valinnainen)

Voit määrittää export-solution-to-git -putkeen joitakin putkimuuttujia, jotka ohjaavat, mitä tietoja lähdekoodin hallinnassa säilytetään. Jos haluat käyttää näitä asetuksia yleisesti, aseta muuttujat export-solution-to-git-putkeen. Jos haluat ottaa asetukset käyttöön vietäessä tiettyjä ratkaisuja, luo ratkaisulle vientiputki edellä olevassa muistiinpanossa kuvatulla tavalla ja määritä putken muuttujat.

Voit varmistaa, että ympäristön muuttujien nykyiset arvot eivät ole koskaan sidottu lähdeohjausta varten vientiprosessin aikana, luomalla DoNotExportCurrentEnvironmentVariableValues-muuttujan export-solution-to-git-putkessa ja asettamalla sen arvoksi Tosi.

Voit varmistaa, että ympäristön tiettyjen oletusmuuttujien arvot määritetään ratkaisun viennin aikana, luomalla VerifyDefaultEnvironmentVariableValues-muuttujan export-solution-to-git-putkessa ja asettamalla sen arvoksi Tosi. Aseta oletusympäristömuuttujien arvot customDeploymentSettings.json-määrityksessä käyttöönoton määritysoppaassa kuvatulla tavalla.

1. Valitse Azure DevOps Pipelines>Library>Luo uusi muuttujaryhmä.

2. Anna uudelle muuttujaryhmälle nimeksi alm-accelerator-variable-group, joka on täsmälleen tässä annettu.

   Putkissa viitataan tähän tiettyyn muuttujaryhmään, joten sen nimi on oltava täsmälleen se, mikä on näkyvissä. Jos päätät käyttää muuttujaryhmälle eri nimeämiskäytäntöä, muokkaa putken/putkien osia niin, että siinä käytetään kyseistä nimeä.

3. Lisää muuttujaryhmään seuraavat muuttujat:

   Name	Kuvaus	Arvo
   AADHost	Microsoft Entra valtuutuksen päätepiste	Käytä julkisia pilviä varten login.microsoftonline.com. Jos käytössä on julkinen pilvi, käytä asianmukaista valtuutuksen URL-osoitetta.
   ProcessCanvasApps	Puretaanko pohjaan perustuvia sovelluksia viennin aikana vai pakataanko koonnin aikana	Jos arvo on epätosi, pohjaan perustuvia sovelluksia ei pureta viennin aikana tai pakata koonnin aikana. Pohjaan perustuvan sovelluksen purku- ja pakkaustoiminto on esiversiossa, eikä sitä suositella käytettäväksi tuotantoympäristöissä tällä hetkellä. Et voi kuitenkaan tarkastella kaavion lähdekoodia lähdeohjausobjektin avulla, ellet määritä tämän muuttujan arvoksi Tosi.

4. (Valinnainen) Kun käytät pohjastudion testien automatisointia putkissa, lisää seuraavat muuttujat muuttujaryhmään:

   Name	Arvo
   TestAutomationLoginMethod	CloudIdentity
   TestAutomationMakerPortalUrl	Power Apps maker portalin URL-osoite, yleensä *https://make.powerapps.com*
   TestAutomationUsername	Käyttäjätili, jolla automatisoidut testit suoritetaan
   TestAutomationPassword	Käyttäjätunnus käyttäjätilille, jolla automatisoidut testit suoritetaan

5. (Valinnainen) Yleiset muuttujia rajoitetaan oletusarvoisesti, ja kunkin putken käyttöoikeus on määritettävä. Voit yksinkertaistaa tätä ja sallia minkä tahansa putken käytön. Kohdassa Muuttujaryhmä (Putket>Kirjasto>alm-accelerator-variable-group) valitse Putken oikeudet ylävalikossa, valitse (…) ja valitse sitten Avoin käyttöoikeus.

Projektin koontipalvelun käyttöoikeuksien määrittäminen

1. Valitse Azure DevOps Projektiasetukset.

2. Valitse Säilöt>Suojaus.

3. Kohdassa Käyttäjät etsi ja valitse Projektikokoelman koontipalvelu (oman organisaation nimi).

   Muistiinpano

   Organisaatiosi nimeä ei ehkä näy Projektikokoelman koontipalvelu -käyttäjän jälkeen. Se voi olla vain yksilöllinen tunniste. Etsi tällöin käyttäjä hakutoiminnolla ja valitse se.

4. Määritä seuraavat koontipalvelun käyttäjän oikeudet:

   Käyttöoikeus	Arvo
   Osallistu	Salli
   Osallistu pull-pyyntöihin	Salli
   Luo haara	Salli
   Muokkaa käytäntöjä	Salli

5. Kohdassa Käyttäjät etsi ja valitse Projektin nimi Koontipalvelu (oman organisaation nimi).

6. Määritä samat arvot kuin vaiheessa 4.

7. Valitse Putket, valitse oikeasta yläkulmasta kolme pistettä (...) ja valitse sitten Suojauksen hallinta.

8. Määritä seuraavat Projektin nimi Koontipalvelu (Organisaation nimi) -käyttäjän oikeudet:

   Käyttöoikeus	Arvo
   Muokkaa koontiputkea	Salli
   Muokkaa koontiversion laatua	Salli
   Koontijonon hallinta	Salli
   Ohita sisäänkuittauksen tarkistus buildilla	Salli
   Päivitä koontiversion tiedot	Salli
   Koontiputken tarkastelu	Salli
   Näytä koontiversiot	Salli

9. Valitse Projektiasetukset>Toimijapoolit ja valitse sitten Suojaus ja lopuksi Lisää.

10. Etsi ja valitse Projektin nimi Koontipalvelu (oman organisaation nimi).

11. Määritä rooliksiLukija.

12. Valitse Lisää.

13. (Valinnainen) Oletusarvoisesti kunkin säilön putken käyttöoikeudet ovat rajoitettuja, ja ne on määritettävä yksitellen. Voit yksinkertaistaa tätä ja sallia minkä tahansa putken käytön. Valitse kohdassa Projektiasetukset>Yksityiset säilöt kukin säilö vuorollaan. Valitse yläreunan valikosta Suojaus. Etsi Putken oikeudet -lohko, valitse (…) ja valitse sitten Avoin käyttö.

Kehitysprojektin asetukset

Seuraavassa osassa opastetaan vaiheittain, kuinka määrittää kunkin tukemanne kehitysprojektin tarvitsema kokoonpano. Tässä yhteydessä kehitysprojekti käsittää infrastruktuurin ja konfiguraation, joka tukee tervettä sovellusten elinkaaren hallintaa (ALM), mukaan lukien itse ALM-prosessia tukevan Dataverse-ympäristön konfiguroinnin.

Palveluyhteyksien luominen Power Platformia Azure DevOps varten

Jokaisella Dataverse-ympäristöllä – kehitykselle, vahvistukselle, testaukselle ja tuotannolle – on oltava Power Platform -palveluyhteys Azure DevOps. Suorita seuraavat vaiheet kullekin ympäristölle.

1. Kirjaudu sisään Azure DevOps ja valitse sitten projektisi.

2. Valitse Projektiasetukset>Palveluyhteydet ja valitse sitten Luo palveluyhteys.

3. Hae ja valitse Power Platformin palveluyhteyden tyyppi.

4. Valitse Seuraava.

5. Syötä kohtaan Palvelimen URL-osoite ympäristösi URL-osoite, esimerkiksi https://myorg.crm.dynamics.com/.

   Tärkeää

   URL-osoitteen perässä on oltava kauttaviiva (/), tässä esimerkissä .com jälkeen.

6. Kirjoita palveluyhteyden nimeen sama URL-osoite, jonka kirjoitit vaiheessa 4, mukaan lukien kauttaviiva (/).

7. Anna Tenant ID, Application (asiakas) -tunnus ja Client Secret jonka kopioit Microsoft Entra, kun kehitit sovelluksen rekisteröinnin.

8. Valitse Myönnä kaikkien putkien käyttöoikeudet.

9. Valitse Tallenna.

Palveluyhteyksien on annettava käyttäjille oikeudet kaikissa ympäristöissä, joita käyttäjien on voitava käyttää sovelluksesta (esimerkiksi valmistajaympäristöt).

1. Valitse Palveluyhteydet-luettelosta palveluyhteys, joka jaetaan käyttäjien kanssa.

2. Valitse oikeasta yläkulmasta Lisää (...) ja valitse sitten Suojaus.

3. Valitse Käyttäjä tai ryhmä -luettelosta ryhmä tai käyttäjä, jolle haluat antaa käyttöoikeudet.

4. Valitse Käyttäjä, sitten Rooli ja valitse sitten Lisää.

Toista nämä vaiheet kehitys-, tarkistus-, testaus- ja tuotantoympäristöille.

Projektien muodostaminen -palvelun käyttöoikeuksien määrittäminen palveluyhteyksien käyttöä varten

1. Valitse Azure DevOps Projektiasetukset>Service connections.

2. Valitse (…) oikeassa yläkulmassa Suojaus ja valitse sitten Lisää.

3. Etsi ja valitse Projektin nimi Koontipalvelu (oman organisaation nimi).

4. Määritä rooliksiJärjestelmänvalvoja ja valitse sitten Lisää.

Luo sovelluskäyttäjä Dataverse-ympäristöissäsi

Luo ympäristöön sovelluksen käyttäjä, jotta putket voivat muodostaa yhteyden kohteeseen Dataverse. Tee tämä jokaisessa ympäristössä, jossa aiot käyttää ALM Acceleratoria.

1. Kirjaudu Power Platform -hallintakeskukseen.

2. Valitse kehitysympäristö ja valitse sitten Asetukset.

3. Valitse Käyttäjät ja oikeudet>Sovelluskäyttäjät.

4. Valitse + Uusi sovelluskäyttäjä.

5. Valitse + Lisää sovellus, valitse aiemmin luomasi sovelluksen rekisteröinti ja valitse sitten Lisää.

6. Valitse oma liiketoimintayksikkö.

7. Valitse käyttöoikeusroolien oikealla puolella oleva kynäkuvake ja valitse sitten sovelluksen käyttäjälle käyttöoikeusroolit.

   Suosittelemme, että annat sovelluksen käyttäjälle järjestelmänvalvojan käyttöoikeusroolin oikeudet, jotta hän voi suorittaa tarvittavat toiminnot kussakin ympäristössä.

8. Valitse Luo.

Toista nämä vaiheet tarkistus-, testi- ja tuotantoympäristöissä.

Ratkaisun määritys

Kun luot ratkaisun Dataversessä, sinun täytyy luoda juuri tätä ratkaisua varten putkia. Seuraavat esimerkkiputket sisältyvät Putket-hakemistoon coe-alm-templates-säilössä:

• https://github.com/microsoft/coe-alm-accelerator-templates/blob/main/Pipelines/build-deploy-validation-SampleSolution.yml
• https://github.com/microsoft/coe-alm-accelerator-templates/blob/main/Pipelines/build-deploy-test-SampleSolution.yml
• https://github.com/microsoft/coe-alm-accelerator-templates/blob/main/Pipelines/build-deploy-prod-SampleSolution.yml

Esimerkkiputkien avulla organisaatiot voivat joustavasti tallentaa putkimallinsa erilliseen projektiin tai säilöön tietyn ratkaisuputken YAML-tiedostosta. Määritä ratkaisuputki tässä osassa kuvattujen vaiheiden mukaisesti. Toista nämä vaiheet jokaisen sellaisen ratkaisun osalta, jota varten käytät lähteen ohjausobjektin ALM Acceleratoria.

Ratkaisun koonti- ja käyttöönottoputkien luominen

Ratkaisuputkien avulla voidaan koostaa ja ottaa käyttöön lähdeohjattuja ratkaisuja vuokraajasi ympäristöihin. Näyteputkissa oletetaan vain kolme ympäristöä: tarkistus, testi ja tuotanto. Voit kuitenkin luoda organisaation ympäristöstrategian mukaisesti niin monta ratkaisuputkea kuin tarvitset.

Käyttöönottoputket käynnistyvät haaran (eli testin ja tuotannon) muutoksilla tai osana Azure DevOps haarakäytäntöä (eli vahvistusta). Lue lisää haarakäytäntöjen määrittämisestä pull-pyynnön vahvistusta varten. Voit suorittaa putkia myös manuaalisesti ilman käynnistintä.

Tämän osan vaiheiden mukaisesti voit luoda käyttöönottoputkia YAML-esimerkkiputkesta. Seuraavassa taulukossa on kuvattu putkimääritykset.

Putkitiedoston luominen

1. Siirry Azure DevOps säilöön, joka sisältää käyttämäsi pipelines-kansion, ja valitse sitten Pipelines -kansio.

2. Avaa yksi kolmesta käyttöönottoputkesta ja kopioi YAML uuteen putkeen.

3. Pane merkille putkistossa käytettävän repositorion nimi.

4. Siirry säilöön, jossa haluat ratkaisun lähdekoodia hallita.

5. Luo haara oletushaaran perusteella ja anna ratkaisulle nimi. Esimerkiksi MyNewSolution.

   Tämä haara on ratkaisun seuraavan version (v-next) haara. Kaikki kehitystyöt on haaroitettava tästä haarasta sovelluskehittäjien omiin työhaaroihin, ja ne on sitten yhdistettävä v-next-haaraan, jotta koodi voidaan työntää tarkistus- ja testausympäristöön. Kun julkaisu on myöhemmin valmis, v-next-haara voidaan yhdistää main-haaraan tai oletushaaraan.

6. Valitse ylhäällä valikossa Uusi ja valitse sitten Kansio.

7. Anna uudelle kansiolle sama nimi kuin ratkaisullasi.

8. Anna uudelle putken YAML-tiedostolle nimi, kuten build-deploy-validation-SampleSolution.yml, build-deploy-test-SampleSolution.yml tai build-deploy-prod-SampleSolution.yml.

9. Valitse Luo.

Tiedoston päivittäminen ja tallentaminen

1. Liitä edellisessä osassa vaiheessa 2 kopioitu YAML uuteen putkitiedostoon.

2. Muuta uuden putken YAML-tiedostoon seuraavat arvot:

   • Muuta Resurssit>Säilöt>Nimi sen säilön nimeksi, joka sisältää putkimallit.

     Tässä esimerkissä säilön nimi on coe-alm-accelerator-templates, ja se on samassa projektissa kuin MyNewSolution-säilö. Jos mallisäilösi on eri Azure DevOps projektissa, käytä muotoa ProjectName/RepoName. Voit myös määrittää haaran, jossa mallit ovat, käyttämällä tarvittaessa ref-parametria.

   • Muuta mikä tahansa arvo, joka viittaa kohteeseen SampleSolutionName ratkaisun yksilölliseen nimeen, esimerkiksi MyNewSolution.

3. Tallenna muutokset valitsemalla Vahvista.

4. Siirry Azure DevOps kohtaan Pipelines ja valitse sitten Luo uusi putki.

5. Valitse koodisäilöksi Azure Repos Git.

6. Valitse DevOps-säilö, joka sisältää käyttöönottoputken YAML:n.

7. Valitse Putken määrittäminen-sivu, valitse Seuraava Azure Pipelines YAML-tiedosto ja osoita aiemmin luomassasi säilössä olevaa YAML-tiedostoa ja valitse sitten Continue.

8. Valitse Tallenna, valitse Suorita putki -kohdan vieressä ... ja valitse sitten Nimeä uudelleen/siirrä.

9. Muuta putken nimeksi deploy-validation-MyNewSolution, deploy-test-MyNewSolution tai deploy-prod-MyNewSolution, jossa MyNewSolution on ratkaisun nimi.

10. Valitse Tallenna.

11. Jos uutta putkea ei ole luotu varaston oletushaarassa: Valitse putkesta Muokkaa. Valitse oikeasta yläkulmasta (...) ja valitse sitten Käynnistimet. Valitse YAML-välilehti ja valitse sitten Hae lähteet. Muuta Oletushaara manuaalisille ja ajoitetuille koonneille osoittamaan ratkaisun haaraan. Lue lisää putken käynnistimien määrittämisestä.

12. Luo (toistamalla edellä olevat vaiheet) käyttöönottoputki jokaiselle ympäristölle, joka viittaa käyttöönottoputken YAML-esimerkkimalliin coe-alm-accelerator-templates-säilössä (deploy-validation-SampleSolution.yml, deploy-test-SampleSolution.yml ja deploy-prod-SampleSolution.yml).

13. Valitse Tallenna ja siirrä jonoon ja valitse sitten Tallenna.

Ratkaisun käyttöönottoputken luominen (valinnainen)

Kuten edellä on mainittu, edellisen osan vaiheessa voit luoda putkia, jotka luovat ja ottavat käyttöön tarkistus-, testi- ja tuotantoympäristöille. Voit kuitenkin luoda erillisen ratkaisun käyttöönottoputken, jos haluat rakentaa ja ottaa käyttöön vain tarkistusta ja testiä varten ja ottaa sitten artefaktit käyttöön testiympäristöstä tuotantoon.

Tämän osan vaiheiden mukaisesti voit luoda ratkaisun käyttöönottoputken YAML-esimerkkiputkesta. Seuraavassa taulukossa on kuvattu putkimääritykset.

1. Siirry Azure DevOps säilöön, joka sisältää käyttämäsi pipelines-kansion ja valitse Pipelines-kansio.

2. Avaa esimerkkikäyttöönottoputki (deploy-prod-pipelineartifact-SampleSolution.yml) ja kopioi YAML käytettäväksi uudessa putkessa.

3. Pane merkille putkistossa käytettävän repositorion nimi.

4. Siirry säilöön, jossa haluat ratkaisun lähdekoodia hallita.

5. Valitse ylhäällä valikossa Uusi ja valitse sitten Tiedosto.

6. Anna uuden putken YAML-tiedostolle nimi; esimerkiksi deploy-prod-MyNewSolution.yml, jossa MyNewSolution on ratkaisun nimi.

7. Valitse Luo.

8. Liitä vaiheessa 2 kopioitu YAML uuteen putkitiedostoon.

9. Muuta uuden putken YAML-tiedostoon seuraavat arvot:

   • Muuta Käynnistin>Haarat>Sisällytä haaroille, joiden muutokset käynnistävät käyttöönoton tuotantoympäristöön.

   • Muuta Resurssit>Säilöt>Nimi sen säilön nimeksi, joka sisältää putkimallit.

     Tässä esimerkissä säilön nimi on coe-alm-accelerator-templates, ja se on samassa projektissa kuin MyNewSolution-säilö. Jos mallisäilösi on eri Azure DevOps projektissa, käytä muotoa ProjectName/RepoName. Voit myös määrittää haaran, jossa mallit ovat, käyttämällä tarvittaessa ref-parametria.

   • Päivitä Resurssit>Putket>Lähde määrittääksesi koontiputken, joka sisältää putken käyttöönotettavat artefaktit. Tässä tapauksessa otetaan käyttöön artefaktit aiemmin luodusta testiputkesta, joka koosti ja otti käyttöön ratkaisun testiympäristössä.

   • Muuta mikä tahansa arvo, joka viittaa kohteeseen SampleSolutionName ratkaisun yksilölliseen nimeen, esimerkiksi MyNewSolution.

10. Toista samat vaiheet 11–20, jotka tehtiin edellisessä osassa tiedostoille deploy-validation-ALMAcceleratorSampleSolution ja deploy-test-ALMAcceleratorSampleSolution luodaksesi putken uuden tuotantoputken YAML-tiedostosta nimeltä deploy-prod-ALMAcceleratorSampleSolution.

Käyttöönottoputken muuttujien määritys

Jokaiselle aiemmin määritetylle käyttöönottoputkelle on määritettävä muuttujien EnvironmentName ja ServiceConnection arvot sen ympäristön mukaan, jossa putki otetaan käyttöön. Voit myös määrittää EnableFlows-muuttujan poistamaan Power Automate työnkulut käytöstä käyttöönoton osana.

Ympäristön ja palveluyhteyden muuttujien luominen (pakollinen)

Jokainen käyttöönottoputki edellyttää ympäristömuuttujaa EnvironmentName ja palveluyhteyden muuttujaa ServiceConnection.

• EnvironmentName määrittää Azure DevOps-ympäristön joka otetaan käyttöön käyttöönottohistorian seurantaa varten ja määrittämään käyttöönoton käyttöoikeudet ja hyväksynnät tiettyihin ympäristöihin. Aseta tämän arvoksi Tarkistaminen, Testi tai Tuotanto.

• ServiceConnection Määrittää, miten käyttöönottoputki muodostaa yhteyden Power Platform. Sallitut arvot ovat aiemmin luotujen palveluyhteyksien nimiä.

1. Valitse kussakin käyttöönottoputkissa Muokkaa.

2. Valitse käyttöönoton putkimäärityksessä Muuttujat. Tämä toiminto avaa Muuttujat-editorin.

3. Lisää muuttuja valitsemalla (+). Kirjoita muuttujan nimi ja asianmukainen arvo.

Luo muuttujat EnvironmentName ja ServiceConnection toistamalla nämä vaiheet.

EnableFlows-muuttujan luominen (valinnainen)

Voit määrittää EnableFlows -nimisen putkimuuttujan arvoksi False, jos haluat ohittaa Power Automate työnkulut automaattisesti osana käyttöönottoa. EnableFlows-muuttujan oletusarvona on Tosi.

Aseta haaran käytännöt vetopyynnön validointia varten

Luo haarakäytäntö, joka toteuttaa aiemmin luomasi putken, kun hakupyyntö luodaan.

1. Siirry Azure DevOps kansioon Repos ja valitse sitten kansio Branches.

2. Etsi haara, jolle haluat luoda hakupyyntökäytännön. Valitse haaran oikealla puolella (...) ja valitse sitten Haaran käytännöt.

3. Valitse Haarakäytännöt-sivulla Koontiversion vahvistaminen.

4. Jos haluat lisätä uuden haarakäytännön, valitse +.

5. Valitse avattavasta Koontijakso-luettelosta luomasi putki.

6. Määritä polkusuodatin, jos tarpeen, jotta voit varmistaa, että vain määritettyyn polkuun tehdyt muutokset käynnistävät putken hakupyynnölle.

7. Määritä Käynnistin-arvoksi Automaattinen.

8. Määritä Käytännön pakollisuus -arvoksi Pakollinen.

9. Aseta koontiversion vanhentumisen arvoksi Heti.

10. Aseta haarakäytännölle Näyttönimi, esimerkiksi PR Build Validation.

11. Valitse Tallenna.

Resurssin käyttöoikeuksien määrittäminen putkia varten

Putkien käyttö edellyttää tarvittavien resurssien, kuten varastojen, muuttujaryhmien ja palveluyhteyksien, käyttöä. Käyttö sallitaan kolmella eri vaihtoehdolla.

Käyttöoikeuden myöntäminen ensimmäisen suorituksen aikana

Voit sallia pakollisen resurssin käytön putken ensimmäisen suorituksen aikana.

1. Laukaise putki ja avaa putken ajo Azure DevOpsissa.
2. Valitse Näytä käyttöoikeus tarvitaan -ilmoituspalkissa.
3. Valitse kullekin pakolliselle resurssille Salli.

Anna eksplisiittinen oikeus

Voit antaa putkelle nimenomaisen käyttöoikeuden tarvittavien säilöjen käyttöön.

1. Avaa Azure DevOps Projektiasetukset.
2. Valitse Säilöt ja valitse sitten säilö.
3. Valitse Käyttöoikeudet-välilehti.
4. Vieritä alaspäin kohtaan Pipeline-oikeudet ja valitse +.
5. Valitse putki, jolle haluat antaa säilön käyttöoikeuden.

Voit antaa putkelle nimenomaisen käyttöoikeuden tarvittavien muuttujaryhmien käyttöön.

1. Valitse Azure DevOps Pipelines>Library ja valitse sitten muuttujaryhmä.
2. Valitse Putkiston oikeudet.
3. Valitse + ja valitse sitten putki, jolle haluat antaa muuttujaryhmän käyttöoikeudet.

Voit antaa putkelle nimenomaisen käyttöoikeuden tarvittavien palveluyhteyksien käyttöön.

1. Avaa Azure DevOps Projektiasetukset.
2. Valitse Palveluyhteydet ja valitse sitten palveluyhteys.
3. Valitse Lisää toimintoja (…) ja sitten Suojaus.
4. Vieritä alaspäin kohtaan Pipeline-oikeudet ja valitse +.
5. Valitse putki, jolle haluat antaa pääsyn palveluyhteyteen.

Kaikkien putkien käyttöoikeuksien myöntäminen

Voit antaa kaikille putkille, sekä niille, jotka sinulla on nyt, että kaikille, jotka luot tulevaisuudessa, oikeuden käyttää vaadittuja säilöjä.

1. Avaa Azure DevOps Projektiasetukset.
2. Valitse Säilöt ja valitse sitten säilö.
3. Valitse Käyttöoikeudet-välilehti.
4. Selaa alas kohtaan Käyttöoikeudet putkistoon.
5. Valitse Lisää toimintoja (...), valitse Avoin käyttöoikeus ja vahvista pyydettäessä.

Voit antaa kaikkien putkien käyttää pakollisia muuttujaryhmiä.

1. Valitse Azure DevOps Pipelines>Library ja valitse sitten muuttujaryhmä.
2. Valitse Putkiston oikeudet.
3. Valitse Lisää toimintoja (...), valitse Avoin käyttöoikeus ja vahvista pyydettäessä.

Voit antaa kaikkien putkien käyttää pakollisia palveluyhteyksiä.

1. Avaa Azure DevOps Projektiasetukset.
2. Valitse Palveluyhteydet ja valitse sitten palveluyhteys.
3. Valitse Lisää toimintoja (…) ja sitten Suojaus.
4. Valitse palveluyhteys, valitse Lisää toimintoja (...) ja valitse sitten Suojaus.
5. Selaa alas kohtaan Käyttöoikeudet putkistoon.
6. Valitse Lisää toimintoja (...), valitse Avoin käyttöoikeus ja vahvista pyydettäessä.

Määritä Työn valtuutuksen vaikutusalue

Työvaltuutuksen laajuus voidaan määrittää koko Azure DevOps organisaatiolle tai tietylle projektille. Poista käytöstä nykyisen projektin Limit-työvaltuutusalue julkaisuputkia varten -asetus, jos valitset eri Azure DevOps projektin mallien asentamiseksi.

Työn valtuutuksen vaikutusalueen määrittäminen organisaatiotasolla kaikille projekteille

1. Valitse Azure DevOps Organisaation asetukset > Pipelines > Asetukset.
2. Poista käytöstä asetus Rajoita työn valtuutuksen vaikutusalue nykyiselle projektille putkien julkaisua varten.

Luo käyttöönoton määritys (valinnainen)

Sinun on luotava useita määrityksiä kohdeympäristöön, kun ratkaisu on otettu käyttöön. Nämä kokoonpanot ovat ympäristökohtaisia. Ne sisältävät yhteysviittauksia, ympäristömuuttujia ja käyttöoikeuksia Microsoft Entra ryhmille ja Dataverse-tiimeille sekä jakavat pohjaan perustuvia sovelluksia ja päivittävät ratkaisukomponenttien, kuten Power Automate työnkulkujen, omistajuuden. Näiden määritysten lisäksi ratkaisun Dataverse-taulukoihin liittyvät näyte- tai määritystiedot ovat usein pakollisia kohdeympäristössä, jotta ALM-käyttökokemus olisi mahdollisimman hyvä.

Jos ratkaisu edellyttää näitä muita määrityksiä tai tietoja, määritä putket käyttöönottoympäristön mukaan käyttöönotto-oppaan mukaisesti.

Ratkaisun tuominen ja sovelluksen määrittäminen

Tuo ALM Accelerator -pohjasovellus Power Platform -ympäristöösi ja määritä sitten sisällytetty mukautettu liitin Azure DevOps varten.

ALM Acceleratorin asentaminen Dataversessä

1. ALM Accelerator -ratkaisu riippuu Tekijäpaketista. Asenna Creator Kit nyt.

2. Lataa uusin hallittu ratkaisutiedosto osoitteesta GitHub. Vieritä alas Resurssit-kohtaan ja valitse CenterofExcellenceALMAccelerator_<latest version>_managed.zip.

3. Kirjaudu sisään Power Apps ja valitse sitten ympäristö, jossa haluat isännöidä ALM Accelerator -sovellusta.

4. Valitse vasemmanpuoleisessa sivupaneelissa Ratkaisut.

5. Valitse Tuo ratkaisu>Selaa ja etsi sitten lataamasi hallittu ratkaisu ja valitse tiedosto.

6. Valitse ensin Seuraava ja sitten uudestaan Seuraava.

7. Valitse Yhteydet-sivulla yhteys tai luo uusi yhteys, jossa muodostat yhteyden CDS DevOps -yhteyden Dataverseen.

   Kun luot HTTP-yhteyden Microsoft Entra kanssa, käytä molemmille parametreille Microsoft Graph-

8. Valitse Tuo.

Määritä mukautettu DevOps-yhdistin

1. Valitse Tiedot>Mukautetut yhdistimet>CustomAzureDevOps.

2. Valitse Muokkaa. Valitse Suojaus-sivulla Muokkaa ja määritä sitten seuraavat kentät:

   Name	Arvo
   Todennuksen tyyppi	OAuth 2.0
   Tunnistetietojen tarjoaja	Azure Active Directory
   Asiakkaan tunnus	Sovelluksen rekisteröinnin luonnin yhteydessä kopioitu Application (client) ID -tunnus
   Asiakasohjelman salasana	Sovelluksen rekisteröinnin luonnin yhteydessä kopioitu Application (client) Secret -arvo
   Vuokraajan tunnus	Jätä oletusarvoksi common
   Resurssin URL-osoite	DevOps Application (client) ID -tunnus, jonka kopioit lisätessäsi oikeuksia sovelluksen rekisteröintiin
   Uudelleenohjauksen URL-osoite	Luo automaattisesti. Jos huomaat Uudelleenohjaus-URL-osoitteen alapuolella olevaa Päivitä yksilölliseen uudelleenohjauksen URL-osoitteeseen -valintaruudun, valitse valintaruutu.

3. Valitse Päivitä yhdistin.

Lisää "Uudelleenohjauksen URL-osoite" "Uudelleenohjauksen URI" -arvoksi

Edellä olevan osan automaattisesti luotu "Uudelleenohjauksen URL-osoite" on lisättävä sovelluksen rekisteröintiin "Uudelleenohjauksen URI" -arvoksi.

1. Palaa luomaasi sovellusrekisteröintiin.

2. Valitse vasemmanpuoleisessa sivupaneelissa Yleiskatsaus.

3. Valitse Lisää uudelleenohjauksen URI-osoite.

4. Valitse ensin + Lisää ympäristö ja sitten Verkko.

5. Liitä Uudelleenohjauksen URI-osoitteet -tekstiruutuun edellä olevasta osasta kopioitu automaattisesti luotu "Uudelleenohjauksen URI".

6. Valitse Määritä.

Mukautetun yhdistimen testaaminen

1. Avaa Testaa-valikko.

2. Luo yhteys valitsemalla Uusi yhteys ja seuraamalla kehotteita.

3. Valitse Power Apps ympäristösi ja valitse sitten Dataverse>Custom Connectors>CustomAzureDevOps.

4. Valitse Muokkaa, siirry Testaa-sivulle ja etsi sitten GetOrganizations-toiminto.

5. Valitse Testaa toiminto.

6. Varmista, että palautettu >Response Status on 200 ja että Response Body on Azure DevOps organisaatiosi JSON-esitys.

   

Määritä tekijät käyttämään ALM Accelerator -sovellusta

• Käyttäjien käyttöoikeuksien määrittäminen tekijän tilille kohdassa Dataverse ja Azure DevOps.

• Määritä käyttöönoton käyttäjäasetukset sovelluksen käyttökokemuksen määrittämiseksi ja ratkaisujen ja käyttöönottoprofiilien käyttöoikeuksien myöntämiseksi.

Lue lisätietoja

• ALM Accelerator Power Platformille
• Käyttöönottoprofiilien määrittäminen
• Määritys ja tietojen käyttöönotto putkissa
• Määritys ja tietojen käyttöönotto putkissa
• Putken synkronoinnin määrittäminen