Tööriistade Microsoft Power Platform ülesanded

Saadaolevaid arendusülesanded kirjeldatakse järgmistes jaotistes. Seejärel tutvustame mõningaid näiteid torujuhtmete Azure DevOps, mis neid ülesandeid kasutavad. Lisateavet ehitustööriistade ja nende allalaadimise kohta leiate teemast Microsoft Power Platform Azure DevOps tööriistade koostamine.

Abilise tööülesanne

Saadaolevaid abilise ülesandeid kirjeldatakse allpool.

Power Platform tööriista paigaldaja

See ülesanne tuleb lisada üks kord enne mis tahes muud Power Platform build tools ülesandeid ehitada ja vabastada torujuhtmed. See ülesanne installib Power Platform – konkreetseid tööriistu, mida agent vajab ülesannete Microsoft Power Platform käitamiseks. See toiming ei nõua lisamist rohkem konfigureerimist, kuid sisaldab iga installitud tööriistade konkreetsete versioonide parameetreid.

Selleks et tööriista versioonid püsiksid ajakohasena veenduge, et need parameetrid vastavad tööriistade versioonidele, mis on vajalikud konveieri õigeks käitamiseks.

YAML lõigendi (Installer)

# 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

Parameetrid (Installer)

Power Platform WhoAmI

Kontrollib Power Platform keskkonnateenuse ühendust, ühendades ja esitades WhoAmI taotluse. See ülesanne võib olla kasulik konveierisse varaseks kaasamiseks, et kontrollida ühenduvust enne töötlemise algust.

YAML lõigend (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'

Parameetrid (WhoAmI)

Kvaliteedikontroll

Allpool on toodud lahenduse kvaliteedi kontrollimiseks saadaolevad ülesanded.

Power Platform Kabe

See ülesanne käivitab teie lahenduste staatilise analüüsi parimate tavade reeglitele vastavuse kontrollimiseks, et tuvastada mis tahes problemaatilised mustrid, mida olete kogemata oma lahenduse koostamisel kasutusele võtnud.

YAML lõigend (Kontrollija)

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

Parameetrid (Kontrollija)

Lahenduse ülesanded

See toimingute kogum saab automatiseerida lahenduse toiminguid. Selles jaotises hiljem välja toodud keskkonnatoimingud, mis loovad, kopeerivad või taastavad keskkonda, kirjutavad teenuseühendused äsja loodud keskkondadega üle. Nii on võimalik sooritada lahenduse tööülesandeid nõudmisel loodud keskkondade suhtes.

Power Platform impordi lahendus

Impordib lahenduse sihtkeskkonda.

YAML lõigend (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

Parameetrid (Import)

Power Platform rakenda lahendusetäiendust

Täiendab lahendust, mis on imporditud hoidmislahenduseks.

YAML lõigend (Täiendus)

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

Parameetrid (Täiendus)

Power Platform ekspordilahendus

Ekspordib lahenduse lähtekeskkonnast.

YAML lõigend (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

Parameetrid (Eksport)

Power Platform lahtipakkimise lahendus

Viib tihendatud lahenduse faili ja pöörab need tagasi mitmesse XML-faili, et neid faile saaks lähtekeskkonna juhtimissüsteemi kaudu hõlpsamalt lugeda ja hallata.

YAML lõigend (Avama)

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

Parameetrid (Avama)

Power Platform pakendi lahendus

Lähtekeskkonna juhtimises esitatud lahendus pakitakse faili solution.zip, mida saab importida teise keskkonda.

YAML lõigend (Pakkima)

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

Parameetrid (Pakkima)

Power Platform kustuta lahendus

Kustutage lahendus sihtkeskkonnast.

YAML lõigend (Kustutamine)

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'

Parameetrid (Kustutamine)

Kohanduste Power Platform avaldamine

Avaldab kõik kohandused keskkonnas.

YAML lõigend (Avalda)

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

Parameetrid (Avalda)

Power Platform lahenduseversiooni Power Platform

Värskendab lahenduse versiooni.

YAML lõigend (Versioon)

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

Parameetrid (Versioon)

Kuigi versiooninumbrit saab konveieris kõva kodeerida, on soovitatav kasutada Azure DevOps torujuhtme muutujat nagu BuildId. See pakub suvandeid versiooninumbri täpse kuju määratlemiseks vahekaardil "Suvandid", näiteks: $(Aasta:yyyy)-$(Kuu:MM)-$(Päev:dd)-$(rev:r)-3

Seda määratlust saab seejärel kasutada ülesandes Lahenduse versiooni määramine, seades atribuudi Versiooninumber kõva kodeerimise asemel: $(Build.BuildId), selle asemel, et 20200824.0.0.2.

Teise võimalusena powershell inline ülesanne script $(Get-Date -Format yyyy.MM.dd. HHmm) väljund seatud tühi muutuja nimega SolutionVersion kui Write-Host ("##vso[task.setvariable variable=SolutionVersion;] $version"), määrake lahenduse versiooniks $(SolutionVersion).

Power Platform juurutamispakett

Juurutab paketi keskkonda. Paketi juurutamine ühe lahendusefaili asemel võimaldab teil juurutada mitut lahendust, andmeid ja koodi keskkonda.

YAML lõigend (Kasutusele võtmine)

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

Parameetrid (Kasutusele võtmine)

Keskkonnahalduse ülesanded

Saate automatiseerida ühise keskkonna elutsükli haldamise (ELM) ülesanded.

Power Platform Keskkonna loomine

Loob uue keskkonna. Uue keskkonna loomine loob automaatselt BuildTools.EnvironmentUrl-i.

YAML lõigend (Loo-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

Parameetrid (Loo-env)

Power Platform kustuta keskkond

Kustutab keskkonna.

YAML lõigend (Kustuta-env)

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

Parameetrid (Kustuta-env)

Power Platform varunduskeskkond

Varundab keskkonna.

YAML lõigend (Varukoopia-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)'

Parameetrid (Varukoopia-env)

Power Platform kopeeri keskkond

Kopeerib keskkonna sihtkeskkonda. Saadaval on kahte tüüpi koopiaid: täielik ja minimaalne. Täielik koopia sisaldab nii andmeid kui ka lahenduse metaandmeid (kohandusi), samas kui minimaalne koopia sisaldab ainult lahenduse metaandmeid, mitte tegelikke andmeid.

YAML lõigend (Kopeeri-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

Parameetrid (Kopeeri-env)

Konveierite loomine ja väljaandmine

Nüüd, kui oleme kindlaks teinud, mida saab arendustööriistade abil teha, vaatame, kuidas rakendada neid vahendeid oma järku ja anda välja konveierid. Allpool on esitatud kontseptuaalne ülevaade. Tutvume mõningate konveieri rakendamise üksikasjadega, kasutades arendustööriista ülesandeid järgnevates alamjaotistes.

Nende torujuhtmete loomise kohta lisateabe saamiseks ja Microsoft Power Platform build tools abil praktilise torujuhtme autoreerimiseks täitke ehitustööriistade laborid, mida saate alla laadida GitHubist.

Lisateave Azure DevOps torujuhtmete kohta: Azure Pipelinesi kasutamine

Konveieri loomine: lahenduse eksportimine arenduskeskkonnast (DEV)

Järgmisel joonisel on kujutatud arendustööriista tööülesandeid, mida võite lisada konveierisse, mis ekspordib lahenduse arenduskeskkonnast.

Konveieri loomine: hallatava lahenduse loomine

Järgmisel joonisel on kujutatud arendustööriista tööülesandeid, mida võite lisada konveierisse, mis loob hallatava lahenduse.

Väljalaske konveier: tootmiskeskkonda (PROD) juurutamine

Järgmisel joonisel on kujutatud arendustööriista tööülesandeid, mida võite lisada konveierisse, mis juurutab arenduskeskkonda.

Vt ka

Microsoft Power Platform Azure DevOps tööriistad