Opplæring: Konfigurere et utgivelsessamlebånd for finans- og driftsapper ved hjelp av Azure DevOps

Når en samlet power platform-pakke produseres hver natt, trenger du en strukturert utgivelsessamlebånd for å promotere denne pakken gjennom miljøene dine. Et godt utformet utgivelsessamlebånd bruker trinnvise distribusjoner med tidsporter og godkjenningskontroller for å sikre at koden valideres før den når produksjon.

I denne opplæringen lærer du hvordan du kan gjøre følgende:

  • Opprett et flertrinns utgivelsessamlebånd med test, førproduksjon og produksjonsfaser
  • Distribuere automatisk til et testmiljø når et nytt bygg fullføres
  • Gate pre-produksjon miljøer bak en 24-timers forsinkelse og en enkeltperson godkjenning
  • Planlegge produksjonsdistribusjoner for et lørdagsvedlikeholdsvindu med godkjenning
  • Bruk arbeidsbelastningsidentitetsforbundet for tjenestetilkoblinger (ingen klienthemmeligheter)

Som et eksempel på dette scenarioet har en kunde en nattlig bygg som kompilerer X++-kode og produserer en enhetlig pakke. Hver kveld distribueres den nyeste pakken til testmiljøet. Etter 24 timer med validering hever en angitt godkjenner pakken til førproduksjon. Følgende lørdag klokken 03:00 UTC, etter endelig godkjenning, distribueres pakken til produksjon.

Viktig!

Selvbetjente Windows-agenter anbefales. Oppgaven PowerPlatformPackageDeploy krever en Windows-agent , og distribusjon av oppdateringer for økonomi og drift tar vanligvis over en time å fullføre. Microsoft-vertsbaserte agenter har et standard tidsavbrudd for jobben som kanskje ikke er tilstrekkelig for store distribusjoner. Bruk selvbetjente Windows-agenter med en utvidet tidsavbrudd for å unngå datasamlebåndsfeil under distribusjon. Hvis du bruker Microsoft-vertsbaserte agenter, angir du timeoutInMinutes til minst 180 på hver distribusjonsjobb og overvåker for tidsavbruddsproblemer.

Notat

Overvåk og observerbarhet. Dataverse overvåkingslogger registrerer alle pakkedistribusjoner til enhetlige miljøer, noe som gir en fullstendig logg over hva som ble distribuert, når og av hvem. Du kan eventuelt videresende disse revisjonsloggene til Microsoft Purview for sentralisert samsvarsrapportering, full sporbarhet på tvers av miljøer og integrering med organisasjonens bredere verktøy for styring og overholdelse.

Før du starter

Tjenestetilkoblinger

Opprett en Power Platform-tjenestetilkobling for hvert målmiljø ved hjelp av arbeidsbelastningsidentitetsforbundet. For hver tilkobling legger du til en tilsvarende legitimasjon for forbund på samme appregistrering i Microsoft Entra ID, der emneidentifikatoren samsvarer med tilkoblingsnavnet.

Tjenestetilkoblingsnavn URL-adresse for målmiljø Formål
PowerPlatform-Test https://yourtest.crm.dynamics.com Testdistribusjoner
PowerPlatform-PreProd https://yourpreprod.crm.dynamics.com Distribusjoner før produksjon
PowerPlatform-Prod https://yourprod.crm.dynamics.com Produksjonsutplasseringer

I Azure-portalen bruker hver forbundslegitimasjon:

  • Utsteder: https://vstoken.dev.azure.com/<AzureDevOpsOrganizationID>
  • Emneidentifikator: sc://<OrgName>/<ProjectName>/<ServiceConnectionName>

Hvis du vil ha detaljerte installasjonsinstruksjoner, kan du se veiledningen for tjenestetilkobling i opplæringen for miljøkopiering.

Trinn 1: Konfigurere Azure DevOps-miljøer og -godkjenninger

Azure DevOps-miljøer gir godkjenningsporter og sporing av distribusjonslogg. Opprett tre miljøer som samsvarer med Power Platform-miljøene dine.

  1. Gå til Pipelines>Environments i Azure DevOps-prosjektet.

  2. Velg Nytt miljø , og opprett følgende miljøer:

    Miljønavn Godkjenninger Andre kontroller
    Test Ingen (automatisk) Ingen
    PreProduction Én godkjenner kreves Minimum 24-timers forsinkelse via åpningstider gate
    Production Én godkjenner kreves Ingen (planlegging håndteres i datasamlebånd)

Konfigurer forhåndsproduksjonsgodkjenning og forsinkelse

  1. Velg PreProduction-miljøet , og velg deretter kebabmenyen (...)>Godkjenninger og kontroller.
  2. Velg Godkjenninger , og legg til brukeren eller gruppen som må godkjenne distribusjoner før produksjon. Angi minimum antall godkjenninger til 1.
  3. Velg Legg til sjekk>arbeidstid (eller Aktiver Azure Function for en egendefinert forsinkelse). Alternativt kan du bruke alternativet delayBeforeDeployment i datasamlebåndet YAML (vist nedenfor) for å gjennomføre en 24-timers ventetid etter at testmiljøet er fullført.

Konfigurer produksjonsgodkjenningen

  1. Velg produksjonsmiljøet , og velg deretter kebabmenyen (...)>Godkjenninger og kontroller.
  2. Velg Godkjenninger , og legg til brukeren eller gruppen som må godkjenne produksjonsdistribusjoner. Angi minimum antall godkjenninger til 1.

Trinn 2: Opprette utgivelsesforløpet

Opprett en fil med navnet release-pipeline.yml i repositoriet. Dette datasamlebåndet bruker den enhetlige pakkeartefakten fra den nattlige versjonen og distribuerer den gjennom tre faser.

Full pipeline YAML

trigger: none

# Automatically trigger when the nightly build completes
resources:
  pipelines:
    - pipeline: NightlyBuild
      source: 'nightly-build'  # Name of your build pipeline
      trigger:
        branches:
          include:
            - main

pool:
  name: 'Self-Hosted-Windows'  # Use your self-hosted Windows agent pool
  # If using Microsoft-hosted agents instead, uncomment the line below:
  # vmImage: 'windows-latest'

variables:
  - name: TestServiceConnection
    value: 'PowerPlatform-Test'
  - name: PreProdServiceConnection
    value: 'PowerPlatform-PreProd'
  - name: ProdServiceConnection
    value: 'PowerPlatform-Prod'
  - name: TestEnvironmentUrl
    value: 'https://yourtest.crm.dynamics.com'
  - name: PreProdEnvironmentUrl
    value: 'https://yourpreprod.crm.dynamics.com'
  - name: ProdEnvironmentUrl
    value: 'https://yourprod.crm.dynamics.com'

# =====================================================================
# STAGE 1: TEST
# Runs automatically each night when a new build artifact is available.
# =====================================================================
stages:
  - stage: DeployToTest
    displayName: 'Deploy to Test'
    jobs:
      - deployment: DeployTest
        displayName: 'Deploy unified package to Test'
        environment: 'Test'
        timeoutInMinutes: 180
        strategy:
          runOnce:
            deploy:
              steps:
                - download: NightlyBuild
                  artifact: 'UnifiedPackage'
                  displayName: 'Download unified package artifact'

                - task: PowerPlatformToolInstaller@2
                  displayName: 'Install Power Platform Build Tools'

                - task: PowerPlatformWhoAmI@2
                  displayName: 'Verify Test service connection'
                  inputs:
                    authenticationType: 'PowerPlatformSPN'
                    PowerPlatformSPN: '$(TestServiceConnection)'

                - task: PowerPlatformDeployPackage@2
                  displayName: 'Deploy unified package to Test'
                  inputs:
                    authenticationType: 'PowerPlatformSPN'
                    PowerPlatformSPN: '$(TestServiceConnection)'
                    PackageFile: '$(Pipeline.Workspace)/NightlyBuild/UnifiedPackage/UnifiedPackage.zip'
                    Environment: '$(TestEnvironmentUrl)'

# =====================================================================
# STAGE 2: PRE-PRODUCTION
# Requires:
#   - Test stage to succeed
#   - 24-hour delay after Test deployment
#   - 1 approval from a designated approver
# =====================================================================
  - stage: DeployToPreProd
    displayName: 'Deploy to Pre-Production'
    dependsOn: DeployToTest
    condition: succeeded()
    jobs:
      - job: WaitForValidation
        displayName: 'Wait 24 hours for Test validation'
        pool: server  # Agentless job for the delay
        timeoutInMinutes: 2880  # 48 hours max wait
        steps:
          - task: Delay@1
            displayName: 'Wait 24 hours before Pre-Production'
            inputs:
              delayForMinutes: 1440  # 24 hours

      - deployment: DeployPreProd
        displayName: 'Deploy unified package to Pre-Production'
        dependsOn: WaitForValidation
        environment: 'PreProduction'  # Triggers the approval gate
        timeoutInMinutes: 180
        strategy:
          runOnce:
            deploy:
              steps:
                - download: NightlyBuild
                  artifact: 'UnifiedPackage'
                  displayName: 'Download unified package artifact'

                - task: PowerPlatformToolInstaller@2
                  displayName: 'Install Power Platform Build Tools'

                - task: PowerPlatformWhoAmI@2
                  displayName: 'Verify Pre-Production service connection'
                  inputs:
                    authenticationType: 'PowerPlatformSPN'
                    PowerPlatformSPN: '$(PreProdServiceConnection)'

                - task: PowerPlatformDeployPackage@2
                  displayName: 'Deploy unified package to Pre-Production'
                  inputs:
                    authenticationType: 'PowerPlatformSPN'
                    PowerPlatformSPN: '$(PreProdServiceConnection)'
                    PackageFile: '$(Pipeline.Workspace)/NightlyBuild/UnifiedPackage/UnifiedPackage.zip'
                    Environment: '$(PreProdEnvironmentUrl)'

# =====================================================================
# STAGE 3: PRODUCTION
# Requires:
#   - Pre-Production stage to succeed
#   - Scheduled for Saturday at 3:00 AM UTC
#   - 1 approval from a designated approver
# =====================================================================
  - stage: DeployToProduction
    displayName: 'Deploy to Production'
    dependsOn: DeployToPreProd
    condition: succeeded()
    jobs:
      - job: WaitForMaintenanceWindow
        displayName: 'Wait for Saturday 3:00 AM UTC maintenance window'
        pool: server  # Agentless job for the delay
        timeoutInMinutes: 11520  # Up to 8 days max wait
        steps:
          - task: ManualValidation@1
            displayName: 'Confirm Saturday maintenance window'
            inputs:
              notifyUsers: 'admin@immglobal.com'
              instructions: |
                Production deployment is ready.
                This deployment should proceed during the Saturday 3:00 AM UTC
                maintenance window. Please confirm:

                1. Pre-Production validation is complete.
                2. The current time falls within the approved maintenance window.
                3. All stakeholders have been notified.

                Approve to proceed with the Production deployment.
              onTimeout: 'reject'
            timeoutInMinutes: 11520

      - deployment: DeployProd
        displayName: 'Deploy unified package to Production'
        dependsOn: WaitForMaintenanceWindow
        environment: 'Production'  # Triggers the approval gate
        timeoutInMinutes: 180
        strategy:
          runOnce:
            deploy:
              steps:
                - download: NightlyBuild
                  artifact: 'UnifiedPackage'
                  displayName: 'Download unified package artifact'

                - task: PowerPlatformToolInstaller@2
                  displayName: 'Install Power Platform Build Tools'

                - task: PowerPlatformWhoAmI@2
                  displayName: 'Verify Production service connection'
                  inputs:
                    authenticationType: 'PowerPlatformSPN'
                    PowerPlatformSPN: '$(ProdServiceConnection)'

                - task: PowerPlatformDeployPackage@2
                  displayName: 'Deploy unified package to Production'
                  inputs:
                    authenticationType: 'PowerPlatformSPN'
                    PowerPlatformSPN: '$(ProdServiceConnection)'
                    PackageFile: '$(Pipeline.Workspace)/NightlyBuild/UnifiedPackage/UnifiedPackage.zip'
                    Environment: '$(ProdEnvironmentUrl)'

Forstå forløpsfasene

Diagrammet nedenfor illustrerer flyten gjennom de tre fasene:

  Nightly Build completes
          |
          v
  +-----------------+
  | STAGE 1: TEST   |     Automatic - deploys every night
  +-----------------+
          |
     24-hour delay
          |
          v
  +----------------------+
  | STAGE 2: PRE-PROD    |     Requires 1 approval
  +----------------------+
          |
    Wait for Saturday
       3:00 AM UTC
          |
          v
  +----------------------+
  | STAGE 3: PRODUCTION  |     Requires 1 approval
  +----------------------+

Trinn 1: Test

  • Utløser: Automatisk når det nattlige byggeforløpet produserer en ny artefakt.
  • Godkjenninger: Ingen. Distribusjonen kjøres umiddelbart.
  • Formål: Valider det nyeste bygget i et miljø som gjenspeiler produksjonskonfigurasjonen. Funksjonelle testere og automatiserte testsuiter kjører daglig mot dette miljøet.

Trinn 2: Førproduksjon

  • Utløser: Etter at testmiljøet er vellykket, begynner en 24-timers forsinkelse. Denne forsinkelsen gir teamet en hel arbeidsdag for å validere distribusjonen av testmiljøet før pakken går videre.
  • Godkjenninger: Én angitt godkjenner må godkjenne før distribusjonen begynner. Godkjenneren mottar et varsel fra Azure DevOps når forsinkelsen fullføres og kan godkjenne eller avvise direkte fra varselet.
  • Formål: Endelig validering i et miljø som er så nær produksjon som mulig. Dette stadiet er hvor gå /no-go beslutninger er tatt.

Trinn 3: Produksjon

  • Utløser: Når miljøet før produksjonen lykkes, vil et manuelt valideringstrinn holde datasamlebåndet til godkjenneren bekrefter. Ventetiden for lørdag er konfigurert på miljøet ved hjelp av Åpningstider-porten.
  • Godkjenninger: Én angitt godkjenner må godkjenne distribusjonsporten for miljøet. Denne godkjenningen er atskilt fra det manuelle valideringstrinnet, noe som gir en bekreftelse på to lag før produksjonen endres.
  • Formål: Distribuer til produksjon under et vedlikeholdsvindu med lite trafikk med eksplisitt menneskelig godkjenning ved hvert kontrollpunkt.

Trinn 3: Legge til legitimasjon for forbund for hver tjenestetilkobling

Hvis du bruker én enkelt appregistrering for alle de tre tjenestetilkoblingene, trenger du tre legitimasjoner for forbund – én for hver tilkobling. Hver legitimasjon har en unik emneidentifikator.

  1. I Azure-portalen går du til sertifikater for appregistrering >og hemmeligheter> iforbundslegitimasjon.

  2. Legg til tre legitimasjoner:

    Navn Emne-identifikator
    azdo-test sc://<OrgName>/<ProjectName>/PowerPlatform-Test
    azdo-preprod sc://<OrgName>/<ProjectName>/PowerPlatform-PreProd
    azdo-prod sc://<OrgName>/<ProjectName>/PowerPlatform-Prod

    Alle tre bruker samme utsteder: https://vstoken.dev.azure.com/<AzureDevOpsOrganizationID>

  3. Sørg for at appregistreringen legges til som en programbruker med sikkerhetsrollen systemansvarlig i hvert av de tre Power Platform-miljøene.

Trinn 4: Registrere appbrukeren i hvert miljø

Du må opprette programbrukeren som er knyttet til appregistreringen i hvert målmiljø. Brukeren trenger tilstrekkelige tillatelser til å distribuere pakker.

  1. Gå til administrasjonssenteret for Power Platform.
  2. Velg Administrer i navigasjonsruten.
  3. I Administrer-ruten, velg Miljøer.
  4. På siden Miljøer , velg ditt miljø.
  5. Velg Innstillinger på kommandolinjen.
  6. Velg Brukere + tillatelser>Programbrukere.
  7. Velg Ny appbruker. Ruten Opprett en ny app-bruker vises.
  8. Velg + Legg til en app for å velge det registrerte Microsoft Entra-programmet som ble opprettet for brukeren, og velg deretter Legg til. Den valgte Microsoft Entra-appen vises under App. 1. Under Forretningsenhet velger du en forretningsenhet i rullegardinlisten.
  9. Velg ikonet Rediger sikkerhetsroller for å velge rollen systemansvarlig . Velg Lagre. Bekreft valget.
  10. Velg Opprett.
  11. Gjenta prosedyren for alle tre miljøene (test, førproduksjon, produksjon).

Hvis du vil ha mer informasjon, kan du se Opprette en appbruker.

Trinn 5: Kjøre og overvåke datasamlebåndet

  1. Når det nattlige bygget er fullført, utløses utgivelsessamlebåndet automatisk.
  2. Overvåk trinn 1 (test) i Azure DevOps. Distribusjonsjobben laster ned den enhetlige pakkeartefakten og distribuerer den ved hjelp PowerPlatformPackageDeploy@2av .
  3. Etter at testmiljøet er vellykket, begynner forsinkelsen på 24 timer . Datasamlebåndet viser statusen Venter.
  4. Når forsinkelsen er fullført, mottar den angitte godkjenneren et varsel. Etter godkjenning distribuerer trinn 2 (før produksjon) pakken.
  5. Når miljøet før produksjonen lykkes, holder det manuelle valideringstrinnet datasamlebåndet frem til vedlikeholdsvinduet lørdag. Godkjenneren bekrefter tidsberegningen og godkjenner.
  6. Godkjenningsporten for produksjonsmiljøet utløser. Etter at den angitte godkjenneren godkjenner, distribuerer trinn 3 (produksjon) pakken.

Vise distribusjonslogg

Spor hver distribusjon på to steder:

  • Azure DevOps: Miljøer-delen viser en fullstendig distribusjonslogg for hvert miljø, inkludert hvem som godkjente hver distribusjon og når.
  • Dataverse overvåkingslogger: Gå til miljøet i administrasjonssenteret for Power Platform, og velg deretterInnstillinger-overvåking> for å vise pakkeinstallasjonspostene. Disse loggene registrerer pakkenavnet, versjonen, distribusjonstiden og identiteten som utførte installasjonen.

Feilsøking

Problem Løsning
Distribusjonen blir tidsavbrutt på Microsoft-vertsbaserte agenter Bytt til selvbetjente Windows-agenter eller øk timeoutInMinutes til 240 eller høyere. Distribusjoner av finans- og driftspakker overskrider rutinemessig 60 minutter.
PowerPlatformPackageDeploy mislykkes med «OS som ikke støttes» Distribusjonsoppgaven krever en Windows-agent . Sørg for at agentutvalget bruker Windows-maskiner.
Godkjenning av tjenestetilkobling mislykkes Kontroller at emneidentifikatoren for hver forbundslegitimasjon samsvarer nøyaktig med tjenestetilkoblingsnavnet. Kontroller datasamlebåndloggene for forventede utsteder- og emneverdier.
Godkjenningsvarsel ikke mottatt Sørg for at godkjenneren er konfigurert i Azure DevOps-miljøet, ikke bare som en pipeline-variabel. Gå til Miljøer>, velg > og kontroller.
Pakkedistribusjoner til feil miljø Kontroller miljøinndataene for hver PowerPlatformPackageDeploy@2 oppgave samsvarer med riktig miljø-URL-variabel for dette stadiet.
Forsinkelsesjobben blir tidsavbrutt WaitForValidation-jobben har en timeoutInMinutes på 2880 (48 timer). Hvis godkjenningen ikke er gitt i dette vinduet, avbrytes datasamlebåndet. Øk tidsavbruddet eller konfigurer varslingspåminnelser for godkjennere.

Neste trinn