Microsoft Power Platform Buid Tools

De tillgängliga versionsuppgifterna beskrivs i följande avsnitt. Därefter presenterar vi några exempel på Azure DevOps pipelines som gör det enklare att använda dessa uppgifter. Mer information om Buid Tools och hur du hämtar dem finns i Microsoft Power Platform Buid Tools för Azure DevOps.

Assistentuppgift

De tillgängliga hjälpuppgifterna beskrivs nedan.

Installationsprogram för Power Platform-verktyg

Den här uppgiften krävs för att läggas till en gång före alla andra uppgifter för Power Platform-versionsverktyg och verionspipelines. Denna uppgift installerar en uppsättning Power Platform–-specifika verktyg som krävs av agenten för att köra Microsoft Power Platform-versionsuppgifter. För den här uppgiften krävs ingen ytterligare konfiguration när den läggs till, men innehåller parametrar för de specifika versionerna av varje verktyg som installeras.

Du kan hålla dig uppdaterad om verktygsversionen över tid genom att se till att dessa parametrar motsvarar de versioner av verktygen som krävs för att pipelinen ska kunna köras korrekt.

YAML kodavsnitt (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

Parametrar (installationsprogram)

Power Platform WhoAmI

Verifierar en serviceanslutning till en Power Platform-miljö genom att ansluta till och göra en WhoAmI-förfrågan. Denna uppgift kan vara bra att ta med tidigt i pipelinen i syfte att bekräfta anslutningen innan bearbetningen påbörjas.

YAML kodavsnitt (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'

Parametrar (WhoAmI)

Kvalitetskontroll

Nedan visas de tillgängliga uppgifterna för att kontrollera kvaliteten i en lösning.

Power Platform-kontroll

Med den här uppgiften körs en statisk analyskontroll av dina lösningar mot en uppsättning regler för att identifiera eventuella problematiska mönster som du av misstag har introducerat när lösningen skapades.

YAML kodavsnitt (kontroll)

# 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'

Parametrar (kontroll)

Lösningsuppgifter

Denna uppsättning uppgifter kan automatisera lösningsåtgärder. Miljöuppgifterna som beskrivs längre fram i det här avsnittet beskriver hur du skapar, kopierar eller återställer en miljö skriver över tjänstanslutningarna till de nyskapade miljöerna. Detta gör det möjligt att utföra lösningsuppgifter mot miljöer som skapas på begäran.

Importlösning i Power Platform

Importerar en lösning till en målmiljö.

YAML kodavsnitt (Importera)

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

Parametrar (Importera)

Power Platform Tillämpa uppgradering av lösning

Uppgraderar en lösning som har importerats som en förvaringslösning.

YAML kodavsnitt (uppgradering)

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

Parametrar (uppgradering)

Exportlösning i Power Platform

Exportera en lösning från en källmiljö.

YAML kodavsnitt (Exportera)

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

Parametrar (Export)

Uppackningslösning i Power Platform

Tar en komprimerad lösningsfil och delar upp den i flera olika XML- och andra filer så att dessa filer kan läsas och hanteras lättare av ett källkontrollsystem.

YAML kodavsnitt (Packa upp)

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

Parametrar (packa upp)

Paketlösning i Power Platform

Packar en lösning som visas i källkontrollen i en lösnings-zip-fil som kan importeras till en annan miljö.

YAML kodavsnitt (Packa)

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

Parametrar (packa)

Power Platform Ta bort en lösning

Tar bort en lösning i målmiljön.

YAML kodavsnitt (Ta bort)

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'

Parametrar (Ta bort)

Publicera anpassningar i Power Platform

Publicerar alla anpassningar i en miljö.

YAML kodavsnitt (publicera)

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

Parametrar (publicera)

Ange lösningsversion i Power Platform

Uppdaterar versionen av en lösning.

YAML kodavsnitt (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

Innehållsversion för parametrar

Även om versionsnumret kan hårdkodade i pipelinen, bör du använda en Azure DevOps pipelinevariabel som BuildId. Det här innehåller alternativ för att definiera den exakta formen på versionsnumret under fliken Alternativ, till exempel: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

Definitionen kan sedan användas i aktiviteten Ange lösningsversion genom att ange versionsnummer egenskapen med: $(Build.BuildId) i stället för hårdkodning 20200824.0.0.2.

Alternativt ett powershell infogat uppgiftsskript $(Get-Date -Format yyyy.MM.dd.HHmm) utdata satt till tom variabel med namnet SolutionVersion som skriv värd ("##vso[task.setvariable variable=SolutionVersion;]$version"), ange lösningsversion som $(SolutionVersion).

Distribuera paket i Power Platform

Distribuerar ett paket till en miljö. Distribuerar ett paket istället för en enskild lösningsfil kan du välja att distribuera flera lösningar, data och kod till en miljö.

YAML kodavsnitt (distribuera)

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

Parametrar (distribuera)

Miljöhanteringsuppgifter

Automatisera vanliga uppgifter för livscykelhantering av miljö (ELM).

Skapa miljö i Power Platform

Skapar en ny miljö. När du skapar en ny miljö skapas också automatiskt BuildTools.EnvironmentUrl.

YAML kodavsnitt (Skapa-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

Parametrar (Skapa-env)

Ta bort en miljö i Power Platform

Tar bort en miljö.

YAML kodavsnitt (Ta bort-env)

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

Parametrar (Ta bort-env)

Säkerhetskopierad Power Platform-miljö

Säkerhetskopierar en miljö.

YAML kodavsnitt (Säkerhetskopia-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)'

Parametrar (Säkerhetskopia-env)

Kopiera miljö i Power Platform

Kopierar en miljö till en målmiljö. Det finns två typer av kopia: fullständig och minimal. En fullständig kopia innehåller både data och lösningsmetadata (anpassningar), medan en minimal kopia endast innehåller metadata för lösningen, inte själva informationen.

YAML kodavsnitt (Kopiera-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

Parametrar (Kopiera-env)

Versions- och utgivningspipelines

Nu när vi har identifierat vad som kan göras med hjälp av framställningsverktygen ska vi ta oss en titt på hur du kan använda verktygen i pipelines för version och utgivning. En konceptöversikt visas nedan. Vi ska nu ta oss en titt på några detaljer som berör implementeringen av pipeline med hjälp av uppgifter i Buid Toolset i underavdelningarna nedan.

Om du vill lära dig mer om hur du skapar dessa pipelines och faktiskt utför praktisk redigering av pipelines med hjälp av Microsoft Power Platform Build Tools, slutför Build Tools-labbar, som du kan hämta från GitHub.

Mer information om Azure DevOps-pipelines: Använd Azure-pipelines

Versionspipeline: Exportera en lösning från en utvecklingsmiljö (DEV)

I bilden nedan visas uppgifter i framställningsverktyget som du kan lägga till i en pipeline som exporterar en lösning från en utvecklingsmiljö.

Versionspipeline: Bygg en hanterad lösning

I bilden nedan visas uppgifter i framställningsverktyget som du kan lägga till i en pipeline som bygger en hanterad lösning.

Utgivningspipeline: Distribuera till en produktionsmiljö (PROD)

I bilden nedan visas de uppgifter i framställningsverktyget som du kan lägga till i en pipeline som distribuerar en produktionsmiljö.

Se även

Microsoft Power Platform Build Tools för Azure DevOps