Microsoft Power Platform Naloge orodij za gradnjo

Razpoložljiva opravila za graditev so opisana v naslednjih razdelkih. Nato bomo predstavili nekaj primerov Azure DevOps cevovodov, ki uporabljajo te naloge. Za informacije o orodjih za gradnjo in o tem, kako jih prenesti, glejte Microsoft Power Platform Orodja za gradnjo za Azure DevOps.

Opravilo pomočnika

Razpoložljive naloge pomočnika so opisane spodaj.

Power Platform Namestitveni program orodja

To nalogo je treba dodati enkrat pred katero koli drugo nalogo Power Platform orodij za gradnjo v cevovodih za gradnjo in izdajo. Ta naloga namesti niz Power Platform– posebna orodja, ki jih agent potrebuje za izvajanje nalog gradnje Microsoft Power Platform. To opravilo pri dodajanju ne zahteva konfiguracij, vsebuje pa parametre za posebne različice vsakega orodja, ki se namešča.

Če želite, da se orodja sproti posodabljajo, se prepričajte, da ti parametri ustrezajo različicam orodij, ki so potrebna za pravilno delovanje prodajnega lijaka.

Izrezek YAML (namestitveni program)

# 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 (namestitveni program)

Power Platform WhoAmI

Preveri povezavo s storitvijo okolja Power Platform tako, da se poveže in naredi zahtevo WhoAmI. To opravilo je koristno v prodajnem lijaku vključiti zgodaj, da zagotovite povezavo še pred začetkom obdelave.

Izrezek YAML (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)

Preverjanje kakovosti

Spodaj so na voljo opravila za preverjanje kakovosti rešitve.

Power Platform Preverjevalnik

To opravilo izvaja preverjanje rešitev s statično analizo rešitev glede na nabor pravil za najboljše prakse, da prepozna morebitne problematične vzorce, ki bi jih morda nenamerno uvedli pri gradnji rešitve.

Izrezek YAML (preverjevalnik)

# 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 (preverjevalnik)

Opravila rešitve

Ta nabor opravil lahko avtomatizira dejanja rešitve. Naloge za okolje, opisane kasneje v tem razdelku, ki ustvarjajo, kopirajo ali obnavljajo okolje, bodo prepisale povezovalnike storitve z novo ustvarjenimi okolji. To omogoča izvajanje opravil rešitve v okoljih, ki so ustvarjena na zahtevo.

Power Platform Rešitev za uvoz

Uvozi rešitev v ciljno okolje.

Izrezek YAML (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 Uporabi nadgradnjo rešitve

Nadgradi rešitev, ki je bila uvožena kot zadrževalna rešitev.

Izrezek YAML (nadgradnja)

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 (nadgradnja)

Power Platform Rešitev za izvoz

Izvozi rešitev iz izvornega okolja.

Izrezek YAML (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 Razpakirajte rešitev

Vzame datoteko s stisnjeno rešitvijo in jo razstavi na več datotek XML in drugih datotek, da lahko sistem za upravljanje izvorne kode lažje prebere in upravlja te datoteke.

Izrezek YAML (razpakiranje)

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 (razpakiranje)

Power Platform Pack Solution

Zapakira rešitev, ki je prikazana v upravljanju izvorne kode, v datoteko solution.zip, ki jo je mogoče uvoziti v drugo okolje.

Izrezek YAML (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 Izbriši rešitev

Izbriše rešitev v ciljnem okolju.

Izrezek YAML (izbris)

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 (izbris)

Power Platform Objavi prilagoditve

Objavi vse prilagoditve v okolju.

Izrezek YAML (objava)

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

Parametri (objava)

Power Platform Nastavi različico rešitve

Posodobi različico rešitve.

Izrezek YAML (različica)

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 (različica)

Čeprav je številko različice mogoče trdo kodirati v cevovodu, je priporočljivo uporabiti spremenljivko cevovoda Azure DevOps, kot je BuildId. To ponuja možnosti za določitev natančne oblike številke različice v zavihku »Možnosti«, na primer: (leto: yyyy) $–(mesec: MM) $–(dan: dd) $–(rev: rr) $–3

To definicijo lahko nato uporabite v nalogi Nastavi različico rešitve tako, da nastavite lastnost Številka različice z: $(Build.BuildId) namesto trdega kodiranja 20200824.0.0.2.

Druga možnost je, da je izhodni skript vgrajenega opravila Powershell $(Get-Date -Format yyyy.MM.dd.HHmm) nastavljen na prazno spremenljivko z imenom SolutionVersion kot Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), nastavite rešitev Različica kot $(SolutionVersion).

Power Platform Paket za namestitev

Uvede paket v okolje. Uvajanje paketa vam v nasprotju z uvajanjem ene datoteke rešitve zagotavlja možnost, da v okolje uvedete več rešitev, podatkov in kode.

Izrezek YAML (uvajanje)

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 (uvajanje)

Opravila upravljanja okolja

Avtomatizirajte skupna opravila upravljanja življenjskega cikla okolja (ELM).

Power Platform Ustvari okolje

Ustvari novo okolje. Ustvarjanje novega okolja tudi samodejno ustvari BuildTools.EnvironmentUrl.

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

Parametri (Create-env)

Power Platform Izbriši okolje

Izbriše okolje.

Izrezek YAML (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 Varnostno okolje

Varnostno kopira okolje.

Izrezek YAML (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 Okolje za kopiranje

Kopira okolje v ciljno okolje. Na voljo sta dve vrsti kopij: polna in minimalna. Polna kopija vključuje podatke in metapodatke rešitve (prilagoditve), medtem ko minimalna kopija vključuje samo metapodatke rešitve in ne dejanskih podatkov.

Izrezek YAML (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)

Graditev in sprostitev prodajnih lijakov

Zdaj ko smo prepoznali, kaj je mogoče narediti z orodji za graditev, si oglejmo, kako lahko ta orodja uporabite za graditev in sprostitev prodajnih lijakov. Spodaj je prikazan konceptualni pregled. Oglejmo si nekaj podrobnosti uvajanja prodajnega lijaka z uporabo opravil orodij za graditev v podrazdelkih, ki sledijo.

Če želite izvedeti več o ustvarjanju teh cevovodov in dejanskem ustvarjanju cevovodov z uporabo Microsoft Power Platform orodij za gradnjo, izpolnite zgraditi laboratorije za orodja, ki ga lahko prenesete z GitHuba.

Več informacij o cevovodih Azure DevOps: Uporabite Azure Pipelines

Prodajni lijak za graditev: Izvoz rešitve iz razvojnega okolja (DEV)

Naslednja slika prikazuje opravila orodja za graditev, ki jih lahko dodate v prodajni lijak, ki izvozi rešitev iz razvojnega okolja.

Prodajni lijak za graditev: Graditev upravljane rešitve

Naslednja slika prikazuje opravila orodja za graditev, ki jih lahko dodate v prodajni lijak, ki zgradi upravljano rešitev.

Sprostitev prodajnega lijaka: Uvedba v produkcijsko okolje (PROD)

Naslednja slika prikazuje opravila orodja za graditev, ki jih lahko dodate v prodajni lijak, ki uvaja v produkcijsko okolje.

Glejte tudi

Microsoft Power Platform Orodja za gradnjo za Azure DevOps