งานเครื่องมือการสร้างของ Microsoft Power Platform

งานสร้างที่ใช้งานได้ อธิบายไว้ในส่วนต่อไปนี้ หลังจากนั้นเราจะแสดงตัวอย่างไปป์ไลน์ Azure DevOps ในการใช้ประโยชน์จากงานเหล่านี้ สำหรับข้อมูลเกี่ยวกับเครื่องมือการสร้างและวิธีดาวน์โหลด ดูที่ เครื่องมือการสร้าง Microsoft Power Platform สำหรับ Azure DevOps

งานตัวช่วย

งานผู้ช่วยที่พร้อมใช้งานมีการอธิบายไว้ด้านล่าง

ตัวติดตั้งเครื่องมือ Power Platform

งานนี้จำเป็นต้องเพิ่มหนึ่งครั้งก่อนงานเครื่องมือการสร้างอื่นๆ ของ Power Platform และนำขั้นตอนออกใช้ งานนี้ติดตั้งชุดเครื่องมือเฉพาะ Power Platform–ที่ตัวแทนต้องการเพื่อเรียกใช้งานสร้าง Microsoft Power Platform งานนี้ไม่ต้องการการตั้งค่าคอนฟิกเพิ่มเติมเมื่อเพิ่ม แต่มีพารามิเตอร์สำหรับเวอร์ชันเฉพาะของเครื่องมือแต่ละรายการที่ติดตั้ง

หากต้องการทราบข้อมูลล่าสุดเกี่ยวกับรุ่นของเครื่องมือเมื่อเวลาผ่านไป ให้ตรวจสอบให้แน่ใจว่าพารามิเตอร์เหล่านี้สอดคล้องกับเวอร์ชันของเครื่องมือที่จำเป็นสำหรับขั้นตอนเพื่อให้ทำงานได้อย่างถูกต้อง

ส่วนย่อย YAML (ตัวติดตั้ง)

# 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

พารามิเตอร์ (ตัวติดตั้ง)

Power Platform WhoAmI

ตรวจสอบการเชื่อมต่อบริการสภาพแวดล้อมของ Power Platform โดยการเชื่อมต่อและสร้างคำขอ WhoAmI งานนี้มีประโยชน์ในการรวมก่อนหน้าในขั้นตอน เพื่อตรวจสอบการเชื่อมต่อก่อนเริ่มการประมวล

ส่วนย่อย 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'

พารามิเตอร์ (WhoAmI)

ตรวจสอบคุณภาพ

ด้านล่างนี้เป็นงานที่ใช้ได้สำหรับการตรวจสอบคุณภาพของโซลูชัน

ตัวตรวจสอบ Power Platform

ภารกิจนี้รันการตรวจสอบการวิเคราะห์แบบคงที่บนโซลูชันของคุณกับชุดของแนวปฏิบัติที่ดีที่สุดเพื่อระบุรูปแบบปัญหาใดๆ ที่คุณอาจนำมาใช้โดยไม่ได้ตั้งใจเมื่อสร้างโซลูชันของคุณ

ส่วนย่อย YAML (ตัวตรวจสอบ)

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

พารามิเตอร์ (ตัวตรวจสอบ)

งานโซลูชัน

ชุดของงานนี้สามารถดำเนินการโซลูชันโดยอัตโนมัติ งานสภาพแวดล้อมที่สรุปไว้ในภายหลังในส่วนนี้ซึ่งสร้าง คัดลอก หรือคืนค่าสภาพแวดล้อม จะเขียนทับการเชื่อมต่อบริการด้วยสภาพแวดล้อมที่สร้างขึ้นใหม่ ทำให้สามารถดำเนินการโซลูชันกับสภาพแวดล้อมที่สร้างขึ้นตามความต้องการ

โซลูชันการนำเข้าของ Power Platform

นำเข้าโซลูชันไปยังสภาพแวดล้อมเป้าหมาย

ส่วนย่อย YAML (นำเข้า)

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

พารามิเตอร์ (นำเข้า)

นำการอัปเกรดโซลูชันไปใช้ของ Power Platform

อัปเกรดโซลูชันที่นำเข้าเป็นโซลูชันการครอบครอง

ส่วนย่อย YAML (อัปเกรด)

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

พารามิเตอร์ (อัปเกรด)

โซลูชันการส่งออกของ Power Platform

ส่งออกโซลูชันจากสภาพแวดล้อมต้นทาง

ส่วนย่อย YAML (ส่งออก)

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

พารามิเตอร์ (ส่งออก)

โซลูชันการแยกของ Power Platform

นำไฟล์โซลูชันที่ถูกบีบอัดและย่อยไฟล์ไปเป็นไฟล์ XML และไฟล์อื่นๆ หลายไฟล์ เพื่อจะได้อ่านและจัดการไฟล์เหล่านี้ได้โดยง่ายผ่านระบบควบคุมต้นทาง

ส่วนย่อย YAML (แยก)

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

พารามิเตอร์ (แยก)

แพ็คโซลูชัน Power Platform

แพคโซลูชันที่แสดงในระบบควบคุมต้นทางลงในไฟล์ solution.zip ที่สามารถนำเข้าสู่สภาวะแวดล้อมอื่น

ส่วนย่อย YAML (บรรจุ)

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

พารามิเตอร์ (บรรจุ)

ลบโซลูชันของ Power Platform

ลบโซลูชันในสภาพแวดล้อมเป้าหมาย

ส่วนย่อย YAML (ลบ)

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'

พารามิเตอร์ (ลบ)

การกำหนดเองของการเผยแพร่ Power Platform

เผยแพร่การกำหนดเองทั้งหมดในสภาพแวดล้อม

ส่วนย่อย YAML (เผยแพร่)

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

พารามิเตอร์ (เผยแพร่)

รุ่นโซลูชันการตั้งค่า Power Platform

อัปเดตเวอร์ชันของโซลูชัน

ส่วนย่อย YAML (เวอร์ชัน)

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

พารามิเตอร์ (เวอร์ชัน)

แม้ว่าหมายเลขเวอร์ชันจะเป็นแบบฮาร์ดโค้ดในไปป์ไลน์ได้ ขอแนะนำให้ใช้ตัวแปรไปป์ไลน์ Azure DevOps เช่น BuildId ซึ่งจะมีตัวเลือกในการกำหนดรูปแบบที่แน่นอนของหมายเลขเวอร์ชันภายใต้แท็บ "ตัวเลือก" ตัวอย่างเช่น: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

จากนั้นคำจำกัดความนี้สามารถใช้ในงาน Set Solution Version โดยตั้งค่าคุณสมบัติ Version Number ด้วย: $(Build.BuildId) แทนที่จะเข้ารหัสยาก 20200824.0.0.2

อีกวิธีหนึ่งคือ ผลลัพธ์สคริปต์งานอินไลน์ของ powershell $(Get-Date -Format yyyy.MM.dd.HHmm) ที่ตั้งค่าเป็นตัวแปรว่างที่ชื่อ SolutionVersion เป็น Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version") ตั้งค่าเวอร์ชันโซลูชันเป็น $(SolutionVersion)

แพ็กเกจการปรับใช้งาน Power Platform

ปรับใช้แพ็กเกจกับสภาพแวดล้อม การปรับใช้ แพ็กเกจ เทียบกับกับไฟล์โซลูชันไฟล์เดียวแล้ว ให้คุณมีตัวเลือกในการปรับใช้โซลูชัน ข้อมูล และรหัสหลายอย่างในสภาพแวดล้อม

ส่วนย่อย YAML (ปรับใช้)

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

พารามิเตอร์ (ปรับใช้)

งานการจัดการสภาพแวดล้อม

การจัดการวงจรการใช้งานของสภาพแวดล้อมทั่วไป (ELM) โดยอัตโนมัติ

สภาพแวดล้อมการสร้างของ Power Platform

สร้างสภาพแวดล้อมใหม่ การสร้างสภาพแวดล้อมใหม่จะสร้าง BuildTools.EnvironmentUrl โดยอัตโนมัติเช่นกัน

ส่วนย่อย YAML (สร้างสภาพแวดล้อม)

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

พารามิเตอร์ (สร้างสภาพแวดล้อม)

ลบสภาพแวดล้อม Power Platform

ลบสภาพแวดล้อม

ส่วนย่อย YAML (ลบสภาพแวดล้อม)

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

พารามิเตอร์ (ลบสภาพแวดล้อม)

สภาพแวดล้อมการสำรองข้อมูล Power Platform

สำรองข้อมูลสภาพแวดล้อม

ส่วนย่อย YAML (สำรองข้อมูลสภาพแวดล้อม)

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

พารามิเตอร์ (สำรองข้อมูลสภาพแวดล้อม)

สภาพแวดล้อมการคัดลอก Power Platform

คัดลอกสภาพแวดล้อมไปยังสภาพแวดล้อมเป้าหมาย มีการคัดลอกสองประเภท: แบบเต็มและแบบขั้นต่ำ การคัดลอก แบบเต็ม มีทั้งข้อมูลและเมทาดาทาโซลูชัน (การปรับแต่ง) ในขณะที่การคัดลอก ขั้นต่ำ จะรวมเฉพาะข้อมูลเมตาของโซลูชันและไม่ใช่ข้อมูลจริง

ส่วนย่อย YAML (คัดลอกสภาพแวดล้อม)

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

พารามิเตอร์ (คัดลอกสภาพแวดล้อม)

ไปป์ไลน์การสร้างและการปล่อย

ตอนนี้เราได้ระบุสิ่งที่สามารถทำได้โดยใช้เครื่องมือสร้าง ลองมาดูกันว่าคุณอาจใช้เครื่องมือเหล่านี้กับไปป์ไลน์การสร้างและการปล่อยของคุณได้อย่างไร ภาพรวมแนวคิดแสดงอยู่ด้านล่าง ตอนนี้เรามาดูรายละเอียดของการใช้งานไปป์ไลน์ โดยใช้งานเครื่องมือการสร้างในส่วนย่อยที่ตามมา

หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับการสร้างไปป์ไลน์เหล่านี้ และทำการเขียนไปป์ไลน์จริงโดยใช้เครื่องมือการสร้าง Microsoft Power Platform ให้ สร้างห้องปฏิบัติการเครื่องมือ ให้เสร็จสมบูรณ์ ซึ่งคุณสามารถดาวน์โหลดได้จาก GitHub

ข้อมูลเพิ่มเติมเกี่ยวกับไปป์ไลน์ Azure DevOps: ใช้ Azure Pipelines

สร้างไปป์ไลน์: ส่งออกโซลูชันจากสภาพแวดล้อมการพัฒนา (DEV)

รูปต่อไปนี้แสดงงานเครื่องมือสร้าง ที่คุณอาจเพิ่มไปยังไปป์ไลน์ที่ส่งออกโซลูชันจากสภาพแวดล้อมการพัฒนา

สร้างไปป์ไลน์: สร้างโซลูชันที่มีการจัดการ

รูปต่อไปนี้แสดงงานเครื่องมือสร้าง ที่คุณอาจเพิ่มไปยังไปป์ไลน์ที่สร้างโซลูชันที่มีการจัดการ

ไปป์ไลน์การปล่อย: ปรับใช้กับสภาพแวดล้อมการใช้งานจริง (PROD)

รูปต่อไปนี้แสดงงานเครื่องมือสร้าง ที่คุณอาจเพิ่มไปยังไปป์ไลน์ที่ปรับใช้กับสภาพแวดล้อมการใช้งานจริง

ดูเพิ่มเติม

Microsoft Power Platform Build Tools สำหรับ Azure DevOps