Zadaci alata za izgradnju Microsoft Power Platform

Dostupni zadaci alata za izradu opisani su u sljedećim odjeljcima. Nakon toga ćemo predstaviti neki primjer Azure DevOps cjevovoda koji koriste ove zadatke. Informacije o alatima za izradu i načinu njihova preuzimanja potražite u odjeljku Microsoft Power Platform Alati za izradu za Azure DevOps.

Zadatak pomoćnika

Dostupni zadaci pomoćnika opisani su u nastavku.

Instalacijski program za Power Platform alat

Ovaj je zadatak potrebno dodati jednom prije bilo kojeg drugog zadatka alata za izgradnju Power Platform u izgradnji i otpuštanju cjevovoda. Ovaj zadatak instalira skup Power Platform – određenih alata potrebnih agentu za pokretanje Microsoft Power Platform izgradnju zadataka. Ovaj zadatak ne zahtijeva dodatnu konfiguraciju kada se doda, ali sadrži parametre za određene verzije svakog od alata koji se instaliraju.

Kako biste uvijek bili u tijeku s verzijama alata, provjerite odgovaraju li ovi parametri verzijama alata koje su potrebni da bi kanal pravilno radio.

YAML isječak (instalater)

# 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

Parametri (instalater)

Power Platform WhoAmI

Provjerava vezu Power Platform usluge okruženja povezivanjem i upućivanjem WhoAmI zahtjeva. Ovaj zadatak može biti korisno uključiti rano u kanal kako bi se provjerila povezivost prije nego što započne obrada.

YAML isječak (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'

Parametri (WhoAmI)

Provjera kvalitete

U nastavku se nalaze zadaci za provjeru kvalitete rješenja.

Power Platform provjera

Ovaj zadatak pokreće provjeru statičke analize vaših rješenja u odnosu na skup pravila najbolje prakse kako bi se identificirali svi problematični obrasci koje biste mogli nenamjerno uvesti prilikom izrade rješenja.

YAML isječak (provjeritelj)

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

Parametri (provjeritelj)

Zadaci rješenja

Ovaj skup zadataka može automatizirati radnje rješenja. Zadaci okruženja navedeni u nastavku u ovom odjeljku koji stvaraju, kopiraju ili vraćaju okruženje prebrisat će veze usluge s novostvorenim okruženjima. To omogućuje izvršavanje zadataka rješenja u okruženjima koja se stvaraju na zahtjev.

Power Platform rješenje za uvoz

Uvozi rješenje u ciljno okruženje.

YAML isječak (uvoz)

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

Parametri (uvoz)

Power Platform primijeni nadogradnju rješenja

Nadograđuje rješenje koje je uvezeno kao spremljeno rješenje.

YAML isječak (nadogradnja)

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

Parametri (nadogradnja)

Power Platform rješenje za izvoz

Izvozi rješenje iz izvornog okruženja.

YAML isječak (izvoz)

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

Parametri (izvoz)

Power Platform raspakirajte rješenje

Uzima komprimiranu datoteku rješenja i rastavlja je u više datoteka XML tako da sustav kontrole izvora može jednostavnije čitati i upravljati tim datotekama.

YAML isječak (raspakiranje)

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

Parametri (raspakiranje)

Rješenje paketa za Power Platform

Pakira rješenje predstavljeno u kontroli izvora u datoteku rješenje.zip koja se može uvesti u drugo okruženje.

YAML isječak (pakiranje)

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

Parametri (pakiranje)

Power Platform brisanje rješenja

Briše rješenje u ciljnom okruženju.

YAML isječak (brisanje)

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'

Parametri (brisanje)

Power Platform objavljivanje prilagodbi

Objavljuje sva prilagođavanja u okruženju.

YAML isječak (objavljivanje)

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

Parametri (objavljivanje)

Power Platform postavite verziju rješenja

Ažurira verziju rješenja.

YAML isječak (verzija)

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

Parametri (verzija)

Iako se broj verzije može tvrdo kodirati u cjevovodu, preporučuje se korištenje varijable Azure DevOps cjevovoda kao što je BuildId. Ovo pruža mogućnosti za definiranje točnog oblika broja verzije na kartici "Mogućnosti", na primjer: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

Ta se definicija zatim može koristiti u zadatku Postavljanje verzije rješenja postavljanjem svojstva Broj verzije s: $(Build.BuildId) umjesto tvrdim kodiranjem 20200824.0.0.2.

Alternativno powershell umetnuta skripta zadatka $(Get-Date -Format yyyy.MM.dd. HHmm) izlaz postavljen na praznu varijablu pod nazivom SolutionVersion as Write-Host ("##vso[task.setvariable variable=SolutionVersion;] $version"), postavite verziju rješenja kao $(SolutionVersion).

Paket za implementaciju Power Platform

Uvodi paket u okruženje. Uvođenje paketa, za razliku od jedne datoteke rješenja, pruža mogućnost uvođenja više rješenja, podataka i koda u okruženje.

YAML isječak (uvođenje)

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

Parametri (uvođenje)

Zadaci upravljanja okruženjem

Automatizirajte zajedničke zadatke upravljanja životnim ciklusom okruženja (ELM).

Power Platform stvoriti okruženje

Stvara novo okruženje. Stvaranje novog okruženja također automatski stvara BuildTools.EnvironmentUrl.

YAML isječak (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

Parameteri (Create-env)

Power Platform brisanje okruženja

Briše okruženje.

YAML isječak (Delete-env)

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

Parametri (Delete-env)

Power Platform okruženje sigurnosnog kopiranja

Sigurnosno kopira okruženje.

YAML isječak (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)'

Parametri (Backup-env)

Power Platform kopiranje okruženja

Kopira okruženje u ciljno okruženje. Dostupne su dvije vrste kopija: potpuna i minimalna. Potpuna kopija uključuje podatke i metapodatke rješenja (prilagodbe), a minimalna kopija uključuje samo metapodatke rješenja, a ne stvarne podatke.

YAML isječak (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

Parametri (Copy-env)

Kanali za izgradnju i izdavanje

Sada kada smo utvrdili što se može učiniti pomoću alata za izgradnju, pogledajmo kako te alate možete primijeniti na kanale za izgradnju i izdavanje. Konceptualni pregled prikazan je u nastavku. Pogledajmo neke detalje implementacije kanala koristeći zadatke alata za izgradnju u sljedećim pododjeljcima.

Da biste saznali više o stvaranju tih cjevovoda i zapravo praktično autorstvo cjevovoda pomoću alata za izgradnju Microsoft Power Platform, dovršite laboratorije za izradu alata, koje možete preuzeti s GitHub-a.

Dodatne informacije o Azure DevOps cjevovodima: Korištenje cjevovoda Azure

Izgradnja kanala: Izvezite rješenje iz razvojnog okruženja (DEV)

Sljedeća slika prikazuje zadatke alata za izradu koje možete dodati kanalu koji izvozi rješenje iz razvojnog okruženja.

Izradite kanal: Izradite upravljano rješenje

Sljedeća slika prikazuje zadatke alata za izradu koje možete dodati kanalu koji izrađuje upravljano rješenje.

Izdavanje kanala: Uvedite u proizvodno okruženje (PROD)

Sljedeća slika prikazuje zadatke alata za izradu koje možete dodati kanalu koji se primjenjuje na proizvodno okruženje.

Također pogledajte

Microsoft Power Platform izraditi alate za Azure DevOps