Microsoft Power Platform Build Tools-opgaver

De tilgængelige build-opgaver er beskrevet i følgende afsnit. Herefter vises nogle Azure DevOps-eksempel-pipelines, der gør brug af disse opgaver. Du kan finde oplysninger om Build Tools, og hvordan du downloader dem, under Microsoft Power Platform Build Tools til Azure DevOps.

Opgave i hjælp

De tilgængelige hjælpeopgaver er beskrevet nedenfor.

Power Platform-værktøjsinstallationsprogram

Denne opgave skal nødvendigvis tilføjes én gang inden alle andre Power Platform Build Tools-opgaver i build- og release-pipelines. Denne opgave installerer et sæt specifikke Power Platform–værktøjer, som helpdesk-medarbejderen skal bruge til at køre Microsoft Power Platform-build-opgaverne. Denne opgave kræver ikke flere konfigurationer, når den tilføjes, men indeholder parametre til de specifikke versioner af hvert af de værktøjer, der installeres.

Hvis du vil holde dig ajour med værktøjets versioner over tid, skal du sørge for, at disse parametre stemmer overens med de versioner af værktøjer, der skal bruges, for at pipelinen kan køre korrekt.

YAML-kodestykke (installationsprogram)

# Installs default Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@0
  displayName: 'Power Platform Tool Installer'

# Installs specific versions of the Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@0
  displayName: 'Power Platform Tool Installer'
  inputs:
    DefaultVersion: false
    XrmToolingPackageDeploymentVersion: 3.3.0.928

Parametre (installationsprogram)

Power Platform WhoAmI

Kontrollerer en tjenesteforbindelse i Power Platform-miljøer ved at oprette og lave en WhoAmI-anmodning. Det kan være nyttigt at inkludere denne opgave tidligt i pipelinen for at kontrollere forbindelsen, før processen starter.

YAML-kodestykke (WhoAmI)

# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@0
  displayName: 'Power Platform WhoAmI'

  inputs: 
#   Service Principal/client secret (supports MFA)
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'My service connection'

# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@0
  displayName: 'Power Platform WhoAmI'

  inputs:
#   Username/password (no MFA support)
    PowerPlatformEnvironment: 'My service connection'

Parametre (WhoAmI)

Kvalitetskontrol

Nedenfor kan du se de tilgængelige opgaver til kontrol af kvaliteten af en løsning.

Power Platform Checker

Denne opgave kører en statisk analysekontrol af løsningerne på baggrund af et sæt best practice-regler med henblik på at identificere problematiske mønstre, som kan opstå ved et uheld, når du bygger din løsning.

YAML-kodestykke (kontrol)

# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@0
  displayName: 'Power Platform Checker '
  inputs:
    PowerPlatformSPN: 'Dataverse service connection'
    RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'

# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@0
  displayName: 'Power Platform Checker '
  inputs:
    PowerPlatformSPN: 'Dataverse service connection'
    UseDefaultPACheckerEndpoint: false
    CustomPACheckerEndpoint: 'https://japan.api.advisor.powerapps.com/'
    FileLocation: sasUriFile
    FilesToAnalyzeSasUri: 'SAS URI'
    FilesToAnalyze: '**\*.zip'
    FilesToExclude: '**\*.tzip'
    RulesToOverride: 'JSON array'
    RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'

Parametre (kontrol)

Løsningsopgaver

Dette sæt opgaver kan automatisere løsningshandlinger. De miljøopgaver, der beskrives senere i dette afsnit, og som opretter, kopierer eller gendanner et miljø, overskriver tjenesteforbindelserne med de miljøer, du netop har oprettet. Det gør det muligt at udføre løsningsopgaver i miljøer, der oprettes efter behov.

Power Platform Importér løsning

Importerer en løsning til et målmiljø.

YAML kodestykke (import)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@0
  displayName: 'Power Platform Import Solution '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    HoldingSolution: true
    OverwriteUnmanagedCustomizations: true
    SkipProductUpdateDependencies: true
    ConvertToManaged: true

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@0
  displayName: 'Power Platform Import Solution '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    AsyncOperation: true
    MaxAsyncWaitTime: 60
    PublishWorkflows: false

Parametre (import)

Anvend løsningsopgradering i Power Platform

Opgraderer en løsning, der er importeret som en løsning i venteposition.

YAML kodestykke (opgradering)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.apply-solution-upgrade.PowerPlatformApplySolutionUpgrade@0
  displayName: 'Power Platform Apply Solution Upgrade '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionName: 'Contoso_sample'
    AsyncOperation: false

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.apply-solution-upgrade.PowerPlatformApplySolutionUpgrade@0
  displayName: 'Power Platform Apply Solution Upgrade '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    MaxAsyncWaitTime: 45

Parametre (opgradering)

Power Platform Eksportér løsning

Eksporterer en løsning fra et kildemiljø.

YAML-kodestykke (eksport)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@0
  displayName: 'Power Platform Export Solution '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionName: 'Contoso_sample'
    SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    Managed: true
    MaxAsyncWaitTime: 120

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@0
  displayName: 'Power Platform Export Solution '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    Managed: true
    MaxAsyncWaitTime: 120
    ExportAutoNumberingSettings: true
    ExportCalendarSettings: true
    ExportCustomizationSettings: true
    ExportEmailTrackingSettings: true
    ExportGeneralSettings: true
    ExportIsvConfig: true
    ExportMarketingSettings: true
    ExportOutlookSynchronizationSettings: true
    ExportRelationshipRoles: true
    ExportSales: true

Parametre (eksport)

Power Platform Udpak løsning

Tager en komprimeret løsningsfil og opdeler den i flere XML-filer, så disse filer nemmere kan læses og styres af et kildekontrolsystem.

YAML-kodestykke (pak ud)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.unpack-solution.PowerPlatformUnpackSolution@0
  displayName: 'Power Platform Unpack Solution '
  inputs:
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    SolutionTargetFolder: 'C:\Public'
    SolutionType: Both

Parametre (pak ud)

Power Platform Pak løsning

Pakker en løsning, der er repræsenteret i kildekontrollen, i en løsning.zip-fil, der kan importeres i et andet miljø.

YAML-kodestykke (pak)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.pack-solution.PowerPlatformPackSolution@0
  displayName: 'Power Platform Pack Solution '
  inputs:
    SolutionSourceFolder: 'C:\Public'
    SolutionOutputFile: 'Contoso_sample_1_0_0_1_managed.zip'
    SolutionType: Managed

Parametre (pak)

Slet løsning i Power Platform

Sletter en løsning i målmiljøet.

YAML-kodestykke (slet)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-solution.PowerPlatformDeleteSolution@0
  displayName: 'Power Platform Delete Solution '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'

Parametre (slet)

Power Platform Publicer tilpasninger

Publicerer alle tilpasninger i et miljø.

YAML-kodestykke (publicer)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.publish-customizations.PowerPlatformPublishCustomizations@0
  displayName: 'Power Platform Publish Customizations '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '

Parametre (publicer)

Power Platform Angiv løsningsversion

Opdaterer versionen af en løsning.

YAML-kodestykke (version)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.set-solution-version.PowerPlatformSetSolutionVersion@0
  displayName: 'Power Platform Set Solution Version '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    SolutionVersionNumber: 1.0.0.0

Parametre (version)

Mens versionsnummer kan hardcodes i pipelinen, anbefales det, at du bruger en Azure DevOps-pipelinevariabel som BuildId. Her kan du se indstillinger, hvor du kan definere den nøjagtige form for versionsnummer under fanen "Indstillinger", for eksempel $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

Denne definition kan derefter bruges i opgaven Angiv løsningsversion ved at angive egenskaben Versionsnummer med: $(Build.BuildId) i stedet for hardcoding 20200824.0.0.2.

Du kan også bruge et powershell-integreret opgavescript $(Get-Date -Format yyyy.MM.dd.HHmm) som output til tom variabel med navnet SolutionVersion som Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), Angiv løsningsversion som $(SolutionVersion).

Power Platform Installer pakke

Udruller en pakke i et miljø. Hvis du udruller en pakke i modsætning til en enkelt løsningsfil, får du mulighed for at udrulle flere løsninger, data og kode i et miljø.

YAML-kodestykke (udrul)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.deploy-package.PowerPlatformDeployPackage@0
  displayName: 'Power Platform Deploy Package '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    PackageFile: 'C:\Users\Public\package.dll'
    MaxAsyncWaitTime: 120

Parametre (udrul)

Miljøstyringsopgaver

Automatiser opgaver til generel administration af miljøers livscyklus (ELM).

Power Platform Opret miljø

Opretter et nyt miljø. Når du opretter et nyt miljø, oprettes der også automatisk BuildTools.EnvironmentUrl.

YAML-kodestykke (Create-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@0
  displayName: 'Power Platform Create Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    DisplayName: 'First Coffee test'
    DomainName: firstcoffee

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@0
  displayName: 'Power Platform Create Environment '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    DisplayName: 'First Coffee prod'
    EnvironmentSku: Production
    AppsTemplate: 'D365_CustomerService,D365_FieldService'
    LocationName: canada
    LanguageName: 1036
    CurrencyName: ALL
    DomainName: firstcoffee

Parametre (Create-env)

Power Platform Slet miljø

Sletter et miljø.

YAML-kodestykke (Delete-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-environment.PowerPlatformDeleteEnvironment@0
  displayName: 'Power Platform Delete Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'

Parametre (Delete-env)

Power Platform Miljøsikkerhedskopiering

Sikkerhedskopierer et miljø.

YAML-kodestykke (Backup-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.backup-environment.PowerPlatformBackupEnvironment@0
  displayName: 'Power Platform Backup Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    BackupLabel: 'Full backup - $(Build.BuildNumber)'

Parametre (Backup-env)

Power Platform Kopiér miljø

Kopierer et miljø til et målmiljø. Der findes to typer kopiering: fuld og minimal. En Fuldstændig kopi indeholder både data- og løsningsmetadata (tilpasninger), mens en Minimal kopiering kun indeholder løsningsmetadata og ikke de faktiske data.

YAML-kodestykke (Copy-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.copy-environment.PowerPlatformCopyEnvironment@0
  displayName: 'Power Platform Copy Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.copy-environment.PowerPlatformCopyEnvironment@0
  displayName: 'Power Platform Copy Environment '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'
    CopyType: MinimalCopy
    OverrideFriendlyName: true
    FriendlyName: 'Contoso Test'
    DisableAdminMode: false

Parametre (Copy-env)

Build og release-pipelines

Nu, hvor vi har identificeret, hvad der kan gøres ved hjælp af værktøjerne i build-værktøjerne, så lad os se på, hvordan du kan anvende disse værktøjer i dine build-og release-pipelines. Der vises en konceptuel oversigt nedenfor. Lad os se på nogle detaljer om pipeline-implementeringen ved hjælp af build-tool-opgaverne i de følgende underafsnit.

Hvis du vil vide mere om, hvordan du opretter disse pipelines, og hvordan du rent faktisk opretter pipelines ved hjælp af Microsoft Power Platform Build Tools, skal du fuldføre de Build Tools-labs, som du kan hente fra GitHub.

Flere oplysninger om Azure DevOps-pipelines: Brug Azure-pipelines

Build-pipeline: Eksporter en løsning fra et udviklingsmiljø (DEV)

I følgende illustration vises de build-værktøjsopgaver, du kan føje til en pipeline, der eksporterer en løsning fra et udviklingsmiljø.

Build-pipeline: Byg en administreret løsning

I følgende illustration vises de build-værktøjsopgaver, du kan føje til en pipeline, der bygger en administreret løsning.

Frigiv pipeline: Udrul i et produktionsmiljø (PROD)

I følgende illustration vises de build-værktøjsopgaver, du kan føje til en pipeline, der installerer et produktionsmiljø.

Se også

Microsoft Power Platform Build Tools til Azure DevOps