แชร์ผ่าน

รายการปริมาณงานใน Extensibility Toolkit

รายการปริมาณงาน (WorkloadManifest.xml) คือการกําหนดค่าระดับปริมาณงานสําหรับปริมาณงานของคุณ มันบอก Fabric ว่าปริมาณงานของคุณคือใครและจะเข้าถึงส่วนหน้าของคุณได้อย่างไร เพื่อให้โฮสต์สามารถบูตสแตรปได้อย่างปลอดภัย โดยจะเสริม แต่ไม่ได้แทนที่คําจํากัดความของผลิตภัณฑ์และสินค้า:

  • ข้อมูลเมตาของผลิตภัณฑ์ (สําหรับการค้นพบและการเผยแพร่) อยู่ใน Product.json
  • ประเภทรายการและลักษณะการทํางานจะอยู่ในรายการรายการและไฟล์ JSON

สิ่งที่รายการปริมาณงานกําหนด

  • ข้อมูลประจําตัวของปริมาณงาน: WorkloadName ([องค์กร].[ WorkloadId]) และ Version (เวอร์ชันความหมาย)
  • รูปแบบโฮสติ้ง: HostingType (ใช้ FERemote)
  • แอป Microsoft Entra ส่วนหน้า: AADFEApp>AppId
  • ปลายทางส่วนหน้า: ServiceEndpoint รายการที่มี Name (เช่น Frontend) ( Url localhost ในนักพัฒนา โดเมนที่ใช้งานจริงต้องเป็นโดเมนย่อยของโดเมน Entra ที่ยืนยันแล้วของคุณ) และIsEndpointResolutionService ดู ข้อกําหนดทั่วไปในการเผยแพร่ สําหรับข้อจํากัดของโดเมน
  • การผ่อนคลายแซนด์บ็อกซ์เสริม: EnableSandboxRelaxation เฉพาะเมื่อจําเป็นต้องมีความสามารถพิเศษของ iFrame (เช่น การเริ่มต้นการดาวน์โหลดไฟล์)

แนวทางปฏิบัติที่ดีที่สุด

  • รักษาเวอร์ชันให้สอดคล้องกันในแอปและรายการของคุณ
  • ประกาศสิทธิ์ขั้นต่ําที่จําเป็น (หลักการของสิทธิ์ขั้นต่ํา)
  • ตรวจสอบความถูกต้องของรายการเป็นส่วนหนึ่งของ CI

โครงสร้าง

องค์ประกอบสําคัญในรายการและความหมาย:

  • องค์ประกอบรูทที่มีเวอร์ชันสคีมา (เช่น SchemaVersion="2.0.0")
  • Workload โหนดที่มีแอตทริบิวต์เช่น:
    • WorkloadName — ตัวระบุเฉพาะในแบบฟอร์ม [Organization].[WorkloadId] (เช่น Org.MyWorkload) หากคุณไม่ต้องการเผยแพร่ไปยังผู้เช่ารายอื่น คุณสามารถใช้ Org.[WorkloadId]. สําหรับการเผยแพร่ข้ามผู้เช่า ให้ลงทะเบียน WorkloadName แบบเต็มกับ Fabric
    • HostingType — ระบุการโฮสต์ปริมาณงาน ใช้ FERemote.
  • Version node — เวอร์ชันความหมายของแพ็คเกจปริมาณงานของคุณ
  • RemoteServiceConfiguration > CloudServiceConfiguration ประกอบ ด้วย:
    • Cloud (ตัวอย่างเช่น Public)
    • AADFEApp > AppId — มีรหัสแอปพลิเคชัน Microsoft Entra ส่วนหน้า
    • EnableSandboxRelaxation — ตั้งค่าเป็น true หากคุณต้องการความสามารถพิเศษของ iFrame (เช่น การเริ่มต้นการดาวน์โหลดไฟล์) เก็บไว้ false ตามค่าเริ่มต้นเพื่อความปลอดภัย
    • Endpoints > ServiceEndpoint ผลงานที่มี:
      • Name (ตัวอย่างเช่น Frontend)
      • Url — ที่โฮสต์ส่วนหน้า ใช้เพื่อ https://localhost:port การพัฒนา ในการผลิต โดเมนต้องเป็นโดเมนย่อยของโดเมน Entra ที่ได้รับการยืนยันแล้ว ดู ข้อกําหนดทั่วไปในการเผยแพร่ สําหรับข้อจํากัดโดเมนที่สมบูรณ์
      • IsEndpointResolutionService

สร้างผลลัพธ์และตัวยึดตําแหน่ง

ใน Starter-Kit จะเติมตัวยึดทุกครั้งที่มีการสร้างรายการตามการกําหนดค่าในไฟล์สภาพแวดล้อม รายการสุดท้ายที่เสร็จสมบูรณ์จะถูกสร้างขึ้นในไดเรก build/Manifest ทอรี การใช้ตัวยึดตําแหน่งและการเติมข้อมูลจากสภาพแวดล้อมช่วยให้คุณสามารถสร้างสภาพแวดล้อมที่แตกต่างกันได้โดยไม่ต้องเปลี่ยนไฟล์หรือสคริปต์ เอาต์พุตบิลด์ถูกใช้โดย:

  • DevGateway: ลงทะเบียนอินสแตนซ์การพัฒนาภายในเครื่องของคุณกับ Fabric เพื่อให้แอปของคุณสามารถโหลดภายในพอร์ทัล Fabric ระหว่างการพัฒนา
  • DevServer: ซึ่งให้ข้อมูลแก่ Fabric
  • พอร์ทัลผู้ดูแลระบบ: สําหรับการทดสอบและการผลิต ให้อัปโหลดแพคเกจรายการผ่านพอร์ทัลผู้ดูแลระบบ Fabric ซึ่งเป็นส่วนหนึ่งของการเผยแพร่ ดู เผยแพร่ปริมาณงานของคุณ

เรียนรู้เพิ่มเติม

เนื้อหาที่เกี่ยวข้อง

  • Last updated on