Microsoft Power Platform Build Tools görevleri

Kullanılabilir yapı görevleri aşağıdaki bölümlerde açıklanmaktadır. Daha sonra Bu görevlerin kullanıldığı bazı örnek Azure DevOps ardışık düzenleri göstereceğiz. Yapı araçları ve bunları karşıdan yükleme hakkında daha fazla bilgi için, bkz. Azure DevOps için Microsoft Power Platform Build Tools.

Yardımcı görev

Kullanılabilir yardımcı görevleri aşağıda açıklanmıştır.

Power Platform Aracı Yükleyicisi

Bu görevin derleme ve yayınlama ardışık düzenlerindeki tüm diğer Power Platform Build Tools görevlerinden önce bir kez eklenmesi gerekir. Bu görev, Microsoft Power Platform derleme görevlerini çalıştırmak için aracının gerektirdiği belirli Power Platform– araçlar kümesini yükler. Bu görev eklendiğinde daha fazla yapılandırma gerektirmez, ancak yüklenmekte olan araçların her birinin özel sürümleri için parametreler içerir.

Zaman içinde araç sürümlerinde güncel kalmak için, bu parametrelerin, ardışık düzenin düzgün çalışması için gerekli olan araçların sürümlerine uygun olduğundan emin olun.

YAML kod parçacığı (Yükleyici)

# 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

Parametreler (Yükleyici)

Power Platform WhoAmI

Bir WhoAmI isteğine bağlanarak ve böyle bir istek göndererek Power Platform ortam hizmeti bağlantısını doğrular. İşleme başlamadan önce bağlanabilirliği doğrulamak amacıyla bu görevin, ardışık düzenin erken aşamalarında eklenmesi yararlı olabilir.

YAML kod parçacığı (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'

Parametreler (WhoAmI)

Kalite denetimi

Aşağıda, bir çözümün kalitesini kontrol etmek için kullanılabilecek görevler yer almaktadır.

Power Platform Checker

Bu görev, çözümünüzü oluştururken istemeden sunulan sorunlu modelleri belirlemek için en iyi uygulama kuralları kümesine karşı çözümlerinizde statik bir çözümleme denetimi çalıştırır.

YAML kod parçacığı (Denetleyici)

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

Parametreler (Denetleyici)

Çözüm görevleri

Bu görevler kümesi, çözüm eylemlerini otomatikleştirebilir. Bir ortamı oluşturan, kopyalayan veya geri yükleyen, bu bölümde daha sonra özetlenen ortam görevleri, yeni oluşturulan ortamlara yönelik hizmet bağlantılarının üzerine yazılır. Bu, isteğe bağlı olarak oluşturulan ortamlarda çözüm görevleri gerçekleştirmeye olanak sağlar.

Power Platform Çözümü İçeri Aktar

Hedef ortama bir çözüm alır.

YAML kod parçacığı (İçeri aktarma)

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

Parametreler (İçeri aktarma)

Power Platform Çözüm Yükseltmesini Uygula

Bir saklama çözümü olarak alınmış bir çözümü yükseltir.

YAML kod parçacığı (Yükseltme)

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

Parametreler (Yükseltme)

Power Platform Çözümü Dışarı Aktar

Kaynak ortamdan bir çözümü verir.

YAML kod parçacığı (Dışarı aktarma)

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

Parametreler (Dışarı aktarma)

Power Platform Çözümü Çıkar

Sıkıştırılmış bir çözüm dosyasını alır ve birden çok XML dosyasına ve diğer dosyalara bu dosyaların bir kaynak denetim sistemi tarafından daha kolay yönetilebilmesi için bunları kaldırır.

YAML kod parçacığı (Paket açma)

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

Parametreler (Paket açma)

Power Platform Çözümü Paketle

Bu görev, kaynak denetimi tarafından temsil edilen bir çözümü başka bir ortama alınabilen bir çözüm .zip dosyası olarak paketler.

YAML kod parçacığı (Paketleme)

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

Parametreler (Paketleme)

Power Platform Çözüm Silme

Hedef ortamdaki bir çözümü siler.

YAML kod parçacığı (Sil)

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'

Parametreler (Sil)

Power Platform Özelleştirmeleri Yayımla

Tüm özelleştirmeleri bir ortamda yayımlar.

YAML kod parçacığı (Yayımla)

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

Parametreler (Yayımla)

Power Platform Çözüm Sürümü Belirle

Bir çözümün sürümünü güncelleştirir.

YAML kod parçacığı (Sürüm)

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

Parametreler (Sürüm)

Sürüm numarası ardışık düzen içinde kodlanabileceği için, BuildId gibi bir Azure DevOps ardışık düzeni değişkeni kullanılması önerilir. Bu, sürüm numarasının "Seçenekler" sekmesi altında tam biçimini tanımlamak için seçenekler sunar; örneğin:$(Yıl:yyyy)-$(Ay:AA)-$(Gün:gg)-$(rev:rr)-3

Bu tanım daha sonra, 20200824.0.0.2'nin sabit kodlanması yerine, Sürüm Numarası özelliğini $(Build.BuildId) ile ayarlayarak Çözüm Sürümünü Ayarla görevinde kullanılabilir.

Alternatif olarak PowerShell satır içi görev betiği $(Get-Date -Format yyyy.MM.dd.HHmm) çıkışı, SolutionVersion adlı boş değişkeni Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version") olarak ayarlayın, Çözüm Sürümünü $(SolutionVersion) olarak ayarlayın.

Power Platform Paketi Dağıt

Paketi bir ortama dağıtır. Bir paketi tek bir çözüm dosyasına karşıt olarak dağıtmak, bir ortama birden çok çözüm, veri ve kod dağıtma seçeneği sunar.

YAML kod parçacığı (Dağıt)

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

Parametreler (Dağıt)

Ortam yönetimi görevleri

Genel Ortam Yaşam Döngüsü Yönetimi (ELM) görevlerini otomatikleştirin.

Power Platform Ortam Oluştur

Yeni bir ortam oluşturur. Yeni bir ortam oluşturmak da otomatik olarak BuildTools.EnvironmentUrl oluşturur.

YAML kod parçacığı (Ortam oluştur)

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

Parametreler (Ortam oluştur)

Power Platform Ortamı Sil

Ortamı siler.

YAML kod parçacığı (Ortamı sil)

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

Parametreler (Ortamı sil)

Power Platform Ortamı Yedekle

Ortamı yedekler.

YAML kod parçacığı (Ortamı yedekle)

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

Parametreler (Ortamı yedekle)

Power Platform Ortamı Kopyala

Ortamı hedef ortama kopyalar. İki tür kopya kullanılabilir: tam ve en az. Tam kopya hem verileri hem de çözüm meta verilerini (özelleştirmeleri) içerir, en az kopya yalnızca çözüm meta verilerini içerir, gerçek verileri içermez.

YAML kod parçacığı (Ortamı kopyala)

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

Parametreler (Ortamı kopyala)

Derleme ve yayımlama hatları

Artık, yapı araçları kullanılarak neler yapılabileceğini tanımladığımız için bu araçları yapı ve bırakma ardışıklarınıza nasıl uygulayacağınıza bakalım. Kavramsal genel bakış aşağıda gösterilmiştir. Şimdi de izleyen alt bölümlerde yapı aracı görevlerini kullanarak potansiyel satış uygulamasının ayrıntılarını görelim.

Bu ardışık düzenleri oluşturmak ve Microsoft Power Platform Build Tools kullanarak ardışık düzen üzerinde çalışmak için build tools laboratuvarını tamamlayın, bunu GitHub'dan indirebilirsiniz.

Azure DevOps ardışık düzenleri hakkında daha fazla bilgi: Azure Pipelines kullan

Derleme ardışık düzeni: Bir çözümü bir geliştirme ortamınan dışa aktarmak (DEV)

Aşağıdaki şekil geliştirme ortamından bir çözüm veren bir ardışık düzene ekleyebileceğiniz yapı aracı görevlerini gösterir.

Yapı ardışık düzeni: yönetilen çözüm oluşturma

Aşağıdaki şekil, bir yönetilen çözüm derleyen bir ardışık düzene ekleyebileceğiniz derleme aracı görevlerini gösterir.

Yayın Kanalı: üretim ortamına dağıtma (PROD)

Aşağıdaki şekil, bir üretim ortamına dağıtan bir ardışık düzene ekleyebileceğiniz derleme aracı görevlerini gösterir.

Ayrıca bkz.

Azure DevOps için Microsoft Power Platform Build Tools