ข้อกําหนดแผนการปรับใช้

บทความนี้มีการแบ่งย่อยของโครงสร้างข้อกําหนดสําหรับรายการแผนการปรับใช้ แผนการปรับใช้จะควบคุมลําดับที่มีการปรับใช้รายการและกําหนดการดําเนินการที่จะเรียกใช้ก่อนหรือหลังการปรับใช้รายการ

ส่วนคําจํากัดความ

ตารางนี้แสดงรายการส่วนข้อกําหนดแผนการปรับใช้

เส้นทางของส่วนข้อกําหนด Type จำเป็นต้องระบุ คำอธิบาย
plan.yml DeploymentPlan (YAML) ✅ อธิบายแผนการปรับใช้
.platform PlatformDetails (JSON) ❌ อธิบายเมตาดาต้าของรายการ

DeploymentPlan

อธิบายแผนการปรับใช้

ชื่อ Type จำเป็นต้องระบุ คำอธิบาย
$schema String ✅ URL ของสคีมา JSON สําหรับข้อกําหนดแผนการปรับใช้
version String ✅ เวอร์ชันข้อกําหนดของแผนการปรับใช้
groups DeploymentGroup[] ✅ คอลเลกชันของกลุ่มการปรับใช้งาน

DeploymentGroup

อธิบายกลุ่มการปรับใช้ที่แสดงรายการที่ระบุโดยlogicalId

ชื่อ Type จำเป็นต้องระบุ คำอธิบาย
name String ✅ ชื่อของกลุ่มการปรับใช้
logicalId สตริง (Guid) ✅ ID ทางตรรกะของรายการที่ถูกปรับใช้
dependsOn GroupDependency [] ❌ การขึ้นต่อกันของกลุ่มการปรับใช้
preActions การดําเนินการปรับใช้[] ❌ การดําเนินการที่จะเรียกใช้ก่อนที่จะมีการปรับใช้รายการ
postActions การดําเนินการปรับใช้[] ❌ การดําเนินการที่จะเรียกใช้หลังจากที่มีการปรับใช้รายการ

GroupDependency

อธิบายการขึ้นต่อกันของกลุ่มการปรับใช้

ชื่อ Type จำเป็นต้องระบุ คำอธิบาย
groupName String ✅ ชื่อของกลุ่มที่กลุ่มนี้ใช้อยู่

การปรับใช้การดําเนินการ

อธิบายการดําเนินการปรับใช้

ชื่อ Type จำเป็นต้องระบุ คำอธิบาย
name String ✅ ชื่อของการดําเนินการ
job DeploymentJob ✅ งานที่จะเรียกใช้สําหรับการดําเนินการ

DeploymentJob

อธิบายงานการปรับใช้

ชื่อ Type จำเป็นต้องระบุ คำอธิบาย
type String ✅ ประเภทงานการเชื่อมต่อสาธารณะที่ได้รับการสนับสนุนโดยรายการที่อ้างอิงโดยlogicalId สําหรับการดําเนินการหน่วยข้อมูลมาตรฐาน ให้ใช้Execute การบริการจะแก้ไขเป็นการใช้งานงานภายในของชนิดสินค้า ชนิดของงานที่ไม่สนับสนุนทําให้การดําเนินการปรับใช้ล้มเหลว สําหรับชนิดหน่วยข้อมูลที่ได้รับการสนับสนุน ดู ชนิดหน่วยข้อมูลที่คุณสามารถเรียกใช้เป็นการดําเนินการได้
logicalId สตริง (Guid) ✅ รหัสตรรกะของสินค้าที่มีการรันงาน

ตัวอย่าง plan.yml

$schema: https://developer.microsoft.com/json-schemas/fabric/item/deploymentPlan/definition/plan/1.0.0/schema.json
version: 1.0.0
groups:
  - name: group1
    logicalId: aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
    preActions:
      - name: preAction1
        job:
          type: Execute
          logicalId: bbbbbbbb-1111-2222-3333-cccccccccccc
    postActions:
      - name: postAction1
        job:
          type: Execute
          logicalId: dddddddd-3333-4444-5555-eeeeeeeeeeee
  - name: group2
    logicalId: cccccccc-2222-3333-4444-dddddddddddd
    dependsOn:
      - groupName: group1

ข้อควรพิจารณาและข้อจำกัด

ตัวอย่างข้อกําหนด

{
  "parts": [
    {
      "path": "plan.yml",
      "payload": "<base64 encoded string>",
      "payloadType": "InlineBase64"
    },
    {
      "path": ".platform",
      "payload": "<base64 encoded string>",
      "payloadType": "InlineBase64"
    }
  ]
}