ตั้งค่าโหมดคลาวด์ของปริมาณงาน

ในบทความนี้ คุณจะได้เรียนรู้ข้อกําหนดสําหรับการปรับใช้ปริมาณงานที่ทํางานบนเซิร์ฟเวอร์ระยะไกลที่มีการเข้าถึงอินเทอร์เน็ตใน Microsoft Fabric

การปรับใช้มีสองส่วนหลัก:

• รหัสไคลเอ็นต์ของปริมาณงาน: โค้ด Frontend ที่ฝังเป็น iFrame ใน Microsoft Fabric UI
• Backend ของปริมาณงาน: คอมโพเนนต์ backend และฝั่งเซิร์ฟเวอร์ที่ประมวลผลปริมาณงานของคุณ

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

เมื่อต้องการทํางานกับปริมาณงานของคุณในโหมดคลาวด์ คุณต้องกําหนดค่าข้อมูลแอปและโดเมนของคุณอย่างถูกต้อง

รูปแบบรหัสทรัพยากรของแอป Microsoft Entra ID

ค่าแอป resourceId Microsoft Entra ID ควรอยู่ในรูปแบบต่อไปนี้:

https://<ISV's tenant verified domain>/<workload frontend server>/<workload backend server>/<workload id>/<optional string>

• โดเมนที่ผ่านการตรวจสอบของผู้เช่า ISV: ตรงกับโดเมนที่ได้รับการยืนยันในผู้เช่าของผู้เผยแพร่โดยไม่มีคํานําหน้าหรือโดเมนย่อย เรียนรู้วิธีการเพิ่มโดเมนแบบกําหนดเองไปยัง Microsoft Entra
• เซิร์ฟเวอร์ Frontend ของปริมาณงาน: ชื่อเซิร์ฟเวอร์ frontend ตามที่ปรากฏใน URL frontend (ส่วนย่อยใน URL frontend ที่ด้านบนสุดของโดเมนที่ผ่านการตรวจสอบ)
• เซิร์ฟเวอร์ Backend ปริมาณงาน: ชื่อเซิร์ฟเวอร์ Backend ตามที่ปรากฏใน URL Backend (ส่วนย่อยใน URL backend ด้านบนของโดเมนที่ผ่านการตรวจสอบ)
• รหัสปริมาณงาน: ID ปริมาณงานที่ปรากฏในรายการปริมาณงาน
• รหัสทรัพยากร: สตริงที่เลือกได้สามารถเพิ่มลงในส่วนท้ายของ resourceId ค่าได้

หมายเหตุ

• *.onmicrosoft โดเมนย่อยไม่ได้รับอนุญาตใน URL
• สตริงที่เลือกได้ต้องมีอักขระตัวอักษรและตัวเลข (อังกฤษ) หรือเครื่องหมายยัติภังค์เท่านั้น และต้องมีความยาวไม่เกิน 36 อักขระ

โดเมน Frontend และ Backend

• URL ส่วนหน้าและส่วนหลังต้องเป็นโดเมนย่อยของ resourceId ค่า โดยมีเซกเมนต์พิเศษสูงสุดหนึ่งเซกเมนต์
• โดเมนโฮสต์ URL ตอบกลับควรเหมือนกับโดเมนโฮสต์ frontend

ตัวอย่าง

• ค่าแอป resourceId Microsoft Entra ID: https://datafactory.contoso.com/feserver/beserver/Fabric.WorkloadSample/123
• โดเมน Frontend: https://feserver.datafactory.contoso.com
• โดเมน Backend: https://beserver.datafactory.contoso.com
• เปลี่ยนเส้นทาง URI: https://feserver.datafactory.contoso.com/close

กําหนดค่าจุดสิ้นสุดของปริมาณงาน

วิธีการกําหนดค่าจุดสิ้นสุดปริมาณงาน:

1. เพิ่ม URL backend ของปริมาณงานไปยังCloudServiceConfigurationส่วน ในรายชื่อแฟ้มและตั้งชื่อWorkload

2. เพิ่ม URL frontend ของปริมาณงานไปยังCloudServiceConfigurationส่วน ในรายชื่อแฟ้มและตั้งชื่อFrontend

ตัวอย่างมีดังนี้:

<CloudServiceConfiguration>
    <Cloud>Public</Cloud>
    ...
    <Endpoints>
        <ServiceEndpoint>
        <Name>Workload</Name>
        <Url>https://beserver.datafactory.contoso.com/workload</Url>
        </ServiceEndpoint>
        <ServiceEndpoint>
        <Name>Frontend</Name>
        <Url>https://feserver.datafactory.contoso.com</Url>
        </ServiceEndpoint>
    </Endpoints>
</CloudServiceConfiguration>

กําหนดค่าแอปพลิเคชันของคุณใน Microsoft Entra ID

วิธีการกําหนดค่าแอปพลิเคชันของคุณใน Microsoft Entra:

1. URL การเปลี่ยนเส้นทางควรชี้ไปยัง URL frontend ของคุณต่อท้ายด้วย/close ตัวอย่างเช่น: feserver.datafactory.contoso.com/close
2. URI ID แอปพลิเคชันควรตรงกับโดเมนที่ผ่านการตรวจสอบของแอปพลิเคชันของคุณ

หมายเหตุ

การกําหนดค่าแอปพลิเคชันอื่น ๆ ทั้งหมดใน Microsoft Entra ID จะเหมือนกับในโหมดนักพัฒนา

กําหนดค่าปริมาณงานของคุณ (Backend)

1. ในตัวอย่าง Backend เปิด src/appsettings.json และกําหนดค่าการตั้งค่าต่อไปนี้:

   • สําหรับ PublisherTenantId เลือก ID ผู้เช่าของผู้เผยแพร่
   • สําหรับ ClientId ให้ป้อน ID แอปพลิเคชันของคุณ (พบได้ใน ภาพรวม ID Microsoft Entra)
   • สําหรับ ClientSecret ใส่ข้อมูลลับที่คุณสร้างขึ้นเมื่อคุณกําหนดค่าแอป Microsoft Entra ID
   • สําหรับ ผู้ชม ให้ป้อน ID URI ที่คุณกําหนดค่าไว้ในแอป Microsoft Entra ID

2. เปิด src/Packages/manifest/WorkloadManifest.xml

3. ภายใต้ AADAppตั้งค่า AppId, redirectUriและ ResourceId (ID URI)

หมายเหตุ ข้อกําหนดที่ระบุไว้ใน ไฟล์ XSD และ ภาพรวมของรายการ backend

กําหนดค่าแอป frontend ของคุณ

ใน ไฟล์ .env.test ให้ตั้งค่า WORKLOAD_BE_URL เป็น URL backend ของปริมาณงานของคุณ (ตัวอย่างเช่น ตั้งค่าเป็น beserver.datafactory.contoso.com)

ตัวอย่างมีดังนี้:

WORKLOAD_NAME=Fabric.WorkloadSample
WORKLOAD_BE_URL=beserver.datafactory.contoso.com