สร้างแอป Fabric แรกของคุณ

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

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

เปิดใช้งานแอป Fabric ในการตั้งค่าผู้ดูแลระบบผู้เช่า

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

  1. ลงชื่อเข้าใช้พอร์ทัลผู้ดูแลระบบ Fabric
  2. ไปที่ การตั้งค่าผู้เช่า
  3. ภายใต้ Fabric apps (preview) ให้สลับการตั้งค่าเป็น Enabled
  4. เลือกว่าจะเปิดใช้งานสําหรับทั้งองค์กรหรือกลุ่มความปลอดภัยเฉพาะ
  5. เลือก นำไปใช้

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

จากศูนย์สู่แอปที่ใช้งานได้จริง

สร้างและรันแอป Fabric ด้วยคําสั่งสี่คําสั่ง Rayfin จะติดตั้ง backend ของคุณไปยัง Microsoft Fabric และคุณจะรัน frontend ของคุณกับมันในเครื่อง คุณไม่ได้รันระบบหลังบ้านในเครื่อง

npm create @microsoft/rayfin@latest my-app
cd my-app
npx rayfin up
npm run dev

รัน npx rayfin up status เพื่อยืนยันการติดตั้งแบ็กเอนด์

ให้เอเจนต์สร้างแอป

คัดลอกพรอมต์ต่อไปนี้ไปยัง GitHub Copilot หรือเอเจนต์โค้ดอื่นที่สามารถเข้าถึงเทอร์มินัลได้:

Set up a new Rayfin app for me, end to end.

Rayfin is a backend platform for TypeScript developers on Microsoft Fabric. Before writing
any code, read https://rayfin.ai/docs/reference/agent-rules.md. Every page on that site is
available as raw Markdown by appending .md to its URL.

Then do the work yourself rather than printing steps for me:
1. Scaffold a project with `npm create @microsoft/rayfin@latest my-app` and install dependencies.
2. Sign in with `npx rayfin login`.
3. Deploy with `npx rayfin up` and confirm it with `npx rayfin up status`.
4. Start the frontend with `npm run dev` and tell me the URL to open.

ตรวจสอบไฟล์ที่สร้างขึ้นและผลลัพธ์คําสั่งก่อนที่คุณจะติดตั้งแอป

สร้างแอปจากพอร์ทัล

เปิด Fabric ในเบราว์เซอร์ของคุณและลงชื่อเข้าใช้ด้วย บัญชี Microsoft ของคุณ

เลือกพื้นที่ทำงาน

หลังจากลงชื่อเข้าใช้แล้ว ให้เลือกพื้นที่ทํางานจากแผงการนําทางด้านซ้าย หากคุณไม่มีพื้นที่ทํางานอยู่แล้ว ให้สร้างพื้นที่ทํางานขึ้นมาใหม่:

  1. เลือก พื้นที่ทํางาน ในการนําทางด้านซ้าย
  2. เลือก พื้นที่ทํางานใหม่
  3. ป้อนชื่อสําหรับพื้นที่ทํางาน และเลือก ความจุ Fabric

สร้างแอป Fabric ใหม่

  1. ในมุมมองพื้นที่ทํางาน ให้เลือก รายการใหม่
  2. ค้นหา แอพในรายการ ประเภทรายการหรือเลื่อนเพื่อค้นหา
  3. เลือก รายการ แอป เพื่อเปิดกล่องโต้ตอบการสร้าง
  4. ป้อนชื่อแอป Fabric ของคุณ (เช่น my-rayfin-app)
  5. เลือก สร้าง

เปิด แก้ไข และปรับใช้แอปของคุณ

คุณสามารถพัฒนาในเครื่องโดยใช้ Rayfin CLI

  1. เปิดเทอร์มินัลที่คุณเลือก

  2. ใช้สคริปต์คําสั่ง CLI ที่แสดงในพอร์ทัลและเรียกใช้ในเทอร์มินัลของคุณเพื่อดาวน์โหลดแอปในเครื่อง

    ตัวอย่าง

    npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>
    
  3. ไปที่ไดเรกทอรีโครงการ

    cd <your project directory>
    
  4. ปรับแต่งแอปของคุณโดยแก้ไขโค้ดโดยตรงหรือด้วยความช่วยเหลือของ GitHub Copilot

  5. ทดสอบการเปลี่ยนแปลงภายในเครื่องด้วยแบ็กเอนด์ Fabric ของคุณด้วยคําสั่ง

    npm run dev
    
  6. เผยแพร่การเปลี่ยนแปลงของคุณด้วย:

    npx rayfin up 
    

    เมื่อต้องการปรับใช้กับพื้นที่ทํางานอื่น คุณสามารถระบุ --workspace พารามิเตอร์ได้

    npx rayfin up --workspace <workspacename>
    

    หากต้องการสลับไปมาระหว่างพื้นที่ทํางานทั้งสองนี้ ให้เรียกใช้npx rayfin switch --workspace <workspace>

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