สร้างแอป Fabric ด้วย Rayfin CLI

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

ในบทช่วยสอนนี้ คุณ:

  • สร้างโปรเจ็กต์ Fabric Apps จากเทมเพลต
  • เริ่มแอปในเครื่อง
  • ลงชื่อเข้าใช้ Fabric จาก CLI
  • ปรับใช้แอปกับพื้นที่ทํางาน Fabric
  • ตรวจสอบสถานะการปรับใช้

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

  • เข้าถึง Fabric
  • พื้นที่ทํางาน Fabric ที่คุณมีสิทธิ์ ผู้สนับสนุน สมาชิก หรือผู้ดูแลระบบ
  • ปริมาณงาน Fabric Apps ที่เปิดใช้งานในผู้เช่าของคุณ
  • ติดตั้ง Node.js และ npm

สร้างแอปที่มีพรอมต์ AI

ใช้พรอมต์ต่อไปนี้ร่วมกับ GitHub Copilot หรือเอเจนต์โค้ดอื่น ๆ เพื่อสร้าง สํารวจ รัน ปรับแต่ง และปรับใช้แอป Fabric:

Set up a new Fabric App project called "rayfin-app-ws".

1. Run: npm create @microsoft/rayfin@latest
2. Open the scaffolded project directory.
3. Explore the project structure and understand the Rayfin app framework.
4. Run: npm run dev
5. Make changes to the app based on my instructions.
6. When ready, deploy with: npx rayfin up

เอเจนต์จะรันคําสั่งแบบโต้ตอบและขอการตั้งค่าโครงการหรือพื้นที่ทํางานที่จําเป็น ตรวจสอบไฟล์ที่สร้างขึ้นและผลลัพธ์คําสั่งก่อนการติดตั้ง หากยังไม่ได้เปิดใช้งาน Fabric Apps ให้ขอให้ผู้ดูแลระบบ Fabric เปิดใช้งาน Fabric Apps (ตัวอย่าง) ใน OneLake> catalogGovern>>Configurations Workloads

สร้างแอปใหม่จาก CLI

หากต้องการนั่งร้านแอปใหม่จากเทมเพลต ให้ใช้ npm create:

npm create @microsoft/rayfin@latest -- my-app --workspace <workspacename>

คําสั่งนี้จะสร้างโฟลเดอร์โครงการใหม่ที่มีเทมเพลต rayfin แอป การตั้งค่าคอนฟิก และซอร์สโค้ดส่วนหน้า

ไปที่ไดเรกทอรีโครงการ:

cd my-app

Tip

หากคุณมีโฟลเดอร์โปรเจ็กต์ว่างหรือซอร์สโค้ดที่มีอยู่แล้ว ให้ใช้npx rayfin initแทนnpm create

npx rayfin init .

ตรวจสอบโครงการที่สร้างขึ้น

หลังจากนั่งร้านแล้วโครงการจะรวมไฟล์ที่คุณต้องเริ่มพัฒนา:

  • rayfin/rayfin.yml จัดเก็บบริการแอปและการตั้งค่าการปรับใช้
  • rayfin/.env เก็บค่าสภาพแวดล้อมที่ใช้โดย CLI
  • rayfin/data/ มีไฟล์แบบจําลองข้อมูลของคุณ
  • แอปส่วนหน้าของคุณอยู่ในโครงสร้างโครงการรากที่สร้างโดยเทมเพลตที่เลือก

สําหรับรายละเอียดแบบไฟล์ต่อไฟล์ โปรดดู ทําความเข้าใจโครงสร้างโครงการ

เรียกใช้แอปภายในเครื่อง

เริ่มสภาพแวดล้อมการพัฒนาในท้องถิ่น:

npx rayfin dev

คําสั่งนี้เริ่มต้นเซิร์ฟเวอร์การพัฒนาส่วนหน้าสําหรับแอปนั่งร้าน และปรับใช้แบ็กเอนด์ไปยัง Fabric หากต้องการยืนยันว่าแอปเริ่มทํางานอย่างถูกต้อง ให้เปิด URL ในเครื่องที่แสดงในเทอร์มินัล

ปรับใช้แอปไปยัง Fabric

สร้างคุณสมบัติเพิ่มเติมในแอปพลิเคชันของคุณ หลังจากที่คุณทดสอบการเปลี่ยนแปลงแล้ว ให้ปรับใช้กับ Fabric อีกครั้ง

npx rayfin up

หากต้องการดูตัวอย่างการปรับใช้โดยไม่ทําการเปลี่ยนแปลง ให้เรียกใช้:

npx rayfin up --dry-run

ตรวจสอบการปรับใช้

ตรวจสอบสถานะการปรับใช้ปัจจุบัน:

npx rayfin up status

สําหรับการตอบสนองที่เครื่องอ่านได้ ให้ใช้เอาต์พุต JSON:

npx rayfin up status --json

หลังจากปรับใช้สําเร็จ CLI จะพิมพ์ URL ของแอปที่เป็นโฮสต์และลิงก์พอร์ทัล Fabric สําหรับรายการที่ปรับใช้

ปรับใช้เฉพาะเนื้อหาฐานข้อมูลหรือเนื้อหาแบบคงที่

หากคุณเปลี่ยนเฉพาะแบบจําลองข้อมูล ให้ใช้การเปลี่ยนแปลงฐานข้อมูลโดยไม่ต้องปรับใช้ใหม่ทั้งหมด:

npx rayfin up db apply

หากคุณเปลี่ยนเฉพาะโค้ดส่วนหน้า ให้ปรับใช้เนื้อหาแบบคงที่อีกครั้ง:

npx rayfin up staticapp deploy

เพิ่มฟังก์ชัน

ฟังก์ชันคือฟังก์ชัน TypeScript ที่ทํางานบนเซิร์ฟเวอร์ภายในแอป Fabric ของคุณ ใช้ฟังก์ชันสําหรับตรรกะที่ไม่ควรทํางานในเบราว์เซอร์ เช่น การทํางานกับความลับ การเข้าถึงข้อมูลที่มีสิทธิพิเศษ และการเรียกบริการปลายทางแทนผู้ใช้ที่ลงชื่อเข้าใช้

npx rayfin functions init

GitHub Copilot สามารถสร้างและอัปเดตไฟล์และส่วนประกอบที่จําเป็นได้ คุณยังสามารถขอให้เอเจนต์รันแอป ดีบักฟังก์ชันในเครื่อง และติดตั้งแอปได้ ตัวอย่างเช่น คุณสามารถใช้พรอมต์ต่อไปนี้เพื่อสร้างผู้ช่วยตรวจสอบคําขอดึงของ AI โดยใช้ฟังก์ชันต่าง ๆ:

Build an app that lets me view all pull requests for the repository
<repoURL>, chat with my Azure AI Foundry agent <agentName> to review
pull requests, and post review comments. Use functions with delegated
authentication to connect to Azure AI Foundry and Azure DevOps.

แก้ปัญหาทั่วไป

การลงชื่อเข้าใช้ล้มเหลวหรือการปรับใช้ส่งกลับ 401 หรือ 403

เรียกใช้ npx rayfin login อีกครั้งแล้วลอง npx rayfin upอีกครั้ง

คุณต้องตรวจสอบว่า CLI จะทําอะไร

ก่อนปรับใช้การเปลี่ยนแปลง ให้เรียกใช้npx rayfin up --dry-run

แอปปรับใช้ แต่คุณเปลี่ยน Schema เท่านั้น

หากต้องการผลักดันการเปลี่ยนแปลงสคีมาอย่างอิสระ ให้ใช้npx rayfin up db apply ถ้าคุณทําการเปลี่ยนแปลงที่ทําลายล้าง เช่น การเปลี่ยนชนิดของคอลัมน์ หรือการลบคอลัมน์ คําสั่งนี้จะล้มเหลว หากต้องการบังคับให้ทําการเปลี่ยนแปลง ให้ใช้ --force ค่าสถานะ การกระทํานี้อาจเป็นการเปลี่ยนแปลงที่ทําลายได้

ขั้นตอนถัดไป

  • อัปเดตล่าสุดเมื่อ