เริ่มต้นใช้งานด่วน: เรียกใช้ตัวอย่างปริมาณงาน (ตัวอย่าง)

คู่มือเริ่มต้นด่วนนี้แสดงวิธีการสร้างและเรียกใช้ปริมาณงาน Microsoft Fabric โดยใช้ปริมาณงานตัวอย่าง

ข้อกำหนดเบื้องต้น

ก่อนที่คุณจะเริ่มต้น ตรวจสอบให้แน่ใจว่า คุณมีการติดตั้งต่อไปนี้บนระบบของคุณ:

• การเข้าถึงผู้เช่า Fabric ด้วยคุณลักษณะปริมาณงานและโหมดนักพัฒนาซอฟต์แวร์ที่เปิดใช้งาน ดู แนะนําปริมาณ งาน สําหรับข้อมูลเพิ่มเติม
• Node.js
• npm.
• รันไทม์ .NET 6.0
• ASP.NET Core Runtime 6.0
• Visual Studio 2022
• เวิร์กโหลดผ้า DevGateway

คำแนะนำทีละขั้นตอน

เปิดใช้งานปริมาณงานแบบกําหนดเอง

กําหนดค่าพอร์ทัลผู้ดูแลระบบดังนี้:

1. เข้าสู่ระบบ Fabric ด้วยบัญชีผู้ดูแลระบบ

2. จาก การตั้งค่า ไปที่ พอร์ทัลผู้ดูแลระบบ

   

3. ในส่วน ปริมาณงานเพิ่มเติม (ตัวอย่าง) ให้เปิดใช้งานผู้ดูแลระบบความจุและผู้สนับสนุนสามารถเพิ่มและลบการตั้งค่าผู้เช่าปริมาณงานเพิ่มเติมได้ คุณสามารถเปิดใช้งานสําหรับทั้งองค์กรหรือกลุ่มเฉพาะ

ตั้งค่าโครงการตัวอย่าง

1. ลอกแบบที่เก็บ: ลอกแบบที่เก็บที่พบที่นี่: ตัวอย่างไดเรกทอรีโครงการ

2. ติดตั้งการขึ้นต่อกัน: นําทางไปยัง Frontend ไดเรกทอรีในที่เก็บข้อมูลที่ถูกโคลน และดําเนินการคําสั่งต่อไปนี้:

   npm install
   

3. เริ่มเซิร์ฟเวอร์ภายในเครื่อง: เปิดใช้เซิร์ฟเวอร์ Node.js ภายในเครื่องโดยใช้ webpack โดยการเรียกใช้:

   npm start
   

   โดยทั่วไปแล้ว เซิร์ฟเวอร์จะทํางานบนพอร์ต60006 ยืนยันว่าเซิร์ฟเวอร์สามารถใช้งานได้โดยการเข้าถึง 127.0.0.1:60006/manifests และตรวจสอบไฟล์ การกําหนดค่า .env.dev ในโฟลเดอร์ front-end

4. เปิดใช้งานโหมดนักพัฒนา frontend: ในการตั้งค่าผู้เช่าในพอร์ทัลผู้ดูแลระบบ ภายใต้ส่วนปริมาณงานเพิ่มเติม (ตัวอย่าง) และเปิดใช้งานผู้ดูแลระบบความจุสามารถพัฒนาการตั้งค่าผู้เช่าเพิ่มเติมได้ การตั้งค่านี้อนุญาตการเชื่อมต่อกับเซิร์ฟเวอร์ภายในเครื่องของคุณและยังคงอยู่ในเซสชันเบราว์เซอร์

เรียกใช้ปริมาณงานตัวอย่าง

เมื่อเซิร์ฟเวอร์ภายในเครื่องกําลังทํางานและ เปิดใช้งานโหมด นักพัฒนา ปริมาณงานตัวอย่างใหม่จะปรากฏในเมนู

1. เข้าถึงปริมาณงานตัวอย่าง: เมื่อต้องการเริ่มต้น ประสบการณ์การสร้าง ให้นําทางไปยังโฮมเพจปริมาณงานตัวอย่าง

เตรียมสภาพแวดล้อมการพัฒนา

1. โคลนหม้อน้ํา: โคลนโครงการต้นแบบที่พบที่นี่: ไดเรกทอรีโครงการตัวอย่าง

2. เปิดโซลูชัน: เปิดโซลูชันใน Visual Studio 2022 เพื่อให้แน่ใจว่าสามารถเข้ากันได้กับ net7

3. การลงทะเบียนแอป: ทําตามคําแนะนํา การรับรองความถูกต้อง เพื่อตั้งค่าการรับรองความถูกต้องของ Microsoft Entra ID สําหรับการโต้ตอบที่ปลอดภัยภายในสถาปัตยกรรม

4. อัปเดต URL พื้นฐาน OneLake DFS: ปรับเปลี่ยน EnvironmentConstants.cs ไฟล์ใน src/Constants/ โฟลเดอร์เพื่อให้ตรงกับสภาพแวดล้อมของคุณ

5. กําหนดค่าการตั้งค่าปริมาณงาน: อัปเดต src/Config/workload-dev-mode.json และมี src/appsettings.json รายละเอียดการกําหนดค่าเฉพาะของคุณ:

   • คัดลอก workload-dev-mode.json จาก src/Config ไปยัง C:\ และอัปเดตเขตข้อมูลต่อไปนี้เพื่อให้ตรงกับการกําหนดค่าของคุณ:

   หมายเหตุ

   คุณสามารถคัดลอกไปยังเส้นทางอื่น ๆ และตั้งค่าอาร์กิวเมนต์บรรทัดคําสั่ง "-DevMode:LocalConfigFilePath" ในโครงการของคุณเพื่อระบุเส้นทาง

   • CapacityGuid: ID ความจุของคุณสามารถพบได้ในพอร์ทัล Fabric ภายใต้การตั้งค่าความจุของพอร์ทัลผู้ดูแลระบบ

   • ManifestPackageFilePath: ตําแหน่งที่ตั้งของแพคเกจรายชื่อแฟ้ม เมื่อคุณสร้างโซลูชัน จะบันทึกแพคเกจรายชื่อแฟ้มภายใน src\bin\Debug รายละเอียดเพิ่มเติมเกี่ยวกับแพคเกจรายชื่อแฟ้มสามารถพบได้ในขั้นตอนต่อไป

   • WorkloadEndpointURL: URL จุดสิ้นสุดปริมาณงาน

   • ในไฟล์ src/appsettings.json ให้อัปเดตเขตข้อมูลต่อไปนี้เพื่อให้ตรงกับการกําหนดค่าของคุณ:

     • PublisherTenantId: ID ของผู้เช่าของผู้เช่าผู้เผยแพร่ปริมาณงาน
     • ClientId: ID ไคลเอ็นต์ (AppID) ของแอปพลิเคชัน Microsoft Entra ปริมาณงาน
     • ClientSecret: ข้อมูลลับสําหรับปริมาณงานแอปพลิเคชัน Microsoft Entra
     • ผู้ชม: ผู้ชมสําหรับโทเค็น Microsoft Entra ขาเข้าสามารถพบได้ในการลงทะเบียนแอปที่คุณสร้างขึ้นภายใต้ส่วน "เปิดเผย API" ซึ่งเรียกอีกอย่างว่า URI ID แอปพลิเคชัน

6. กําหนดค่าไฟล์ WorkloadManifest.xml: กําหนดค่า ไฟล์ WorkloadManifest.xml ด้วยรายละเอียดแอปพลิเคชัน Microsoft Entra ต่อไปนี้:

   • AppID
   • รหัสทรัพยากร
   • RedirectURI

7. สร้างแพคเกจรายชื่อแฟ้ม: สร้างโซลูชันเพื่อสร้างไฟล์แพคเกจรายชื่อแฟ้ม ซึ่งรวมถึงการตรวจสอบความถูกต้อง และบรรจุไฟล์ XML และ JSON ที่จําเป็น

   • ทริกเกอร์ Fabric_Extension_BE_Boilerplate_WorkloadManifestValidator.exe บน workloadManifest.xml ในแพคเกจ\manifest\files\ (คุณสามารถค้นหารหัสของกระบวนการตรวจสอบความถูกต้องในไดเรกทอรี \workloadManifestValidator) ถ้าการตรวจสอบล้มเหลว ไฟล์ข้อผิดพลาดจะถูกสร้างขึ้นเพื่อระบุการตรวจสอบที่ล้มเหลว
   • ถ้ามีไฟล์ข้อผิดพลาดอยู่ บิลท์จะล้มเหลวด้วย "ข้อผิดพลาดในการตรวจสอบความถูกต้องของ WorkloadManifest" คุณสามารถดับเบิลคลิกที่ข้อผิดพลาดใน VS studio และจะแสดงไฟล์ข้อผิดพลาดให้คุณ
   • หลังจากตรวจสอบความถูกต้องสําเร็จ ให้แพ็คไฟล์ WorkloadManifest.xml และ FrontendManifest.json ลงใน ManifestPackage.1.0.0.nupkg แพคเกจผลลัพธ์สามารถพบได้ใน src\bin\Debug

   คัดลอกไฟล์ ManifestPackage.1.0.0.nupkg ไปยังเส้นทางที่กําหนดไว้ในไฟล์การกําหนดค่า workload-dev-mode.json

8. เรียกใช้ DevGateway: ดําเนินการ 'Microsoft.Fabric.Workload.DevGateway.exe' และรับรองความถูกต้องในฐานะผู้ดูแลระบบความจุ

9. เริ่มต้นโครงการ: ตั้งค่าโครงการ 'Boilerplate' เป็นโครงการเริ่มต้นใน Visual Studio และเรียกใช้งาน

ขั้นตอนเพิ่มเติม

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

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

• Node.js
• npm