กําหนดค่าการผสานรวม Git สําหรับแอป Fabric ของคุณ

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

บทความนี้จะแสดงวิธีการกําหนดค่าการเชื่อมต่อ ทําความเข้าใจไฟล์แอปที่เขียนลงในที่เก็บข้อมูล และรักษา workspace กับ Git ให้สอดคล้องกัน

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

ก่อนที่คุณจะเริ่มต้น ให้แน่ใจว่าคุณมี:

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

ขั้นตอนในบทความนี้ใช้ Azure DevOps GitHub ก็รองรับเช่นกัน สําหรับคําแนะนําการเชื่อมต่อ GitHub ดูที่ เริ่มต้นใช้งาน Git integration

เชื่อมต่อพื้นที่ทํางานของคุณกับ Git

ตั้งค่าการผสานรวม Git สําหรับทั้งพื้นที่ทํางาน ไม่ใช่สําหรับแอปเดี่ยว การเชื่อมต่อนี้รวมถึงรายการอื่น ๆ ที่รองรับ ในพื้นที่ทํางาน

  1. เปิดพื้นที่ทํางานที่มีแอปของคุณ และเลือกการตั้งค่าพื้นที่ทํางาน

  2. ในบานหน้าต่างด้านซ้าย ให้เลือก Git integration

  3. เลือก Azure DevOps เป็นผู้ให้บริการ Git

  4. เลือกบัญชีที่มีอยู่ หรือเลือก เพิ่มบัญชี และอนุญาตให้เข้าถึง เลือก เชื่อมต่อ

  5. กําหนดค่าการเชื่อมต่อที่เก็บข้อมูล:

    การตั้งค่า สิ่งที่ควรเลือก
    การจัดองค์กร องค์กร Azure DevOps ที่เก็บคลังข้อมูลของคุณ
    Project โปรเจกต์ที่มีที่เก็บข้อมูลของคุณ
    ที่เก็บข้อมูล Git ที่เก็บข้อมูลที่คุณต้องการเก็บคําจํากัดความของแอป
    สาขา เลือก + สาขาใหม่ เพื่อแยกงานของคุณ หรือเลือกสาขาที่มีอยู่
    โฟลเดอร์ ป้อนชื่อโฟลเดอร์เพื่อใช้โฟลเดอร์ที่มีอยู่หรือสร้างโฟลเดอร์ใหม่ เว้นว่างช่องนี้เพื่อเก็บรายการในรากของที่เก็บข้อมูล
  6. เลือกเชื่อมต่อและซิงค์

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

โครงสร้างแอป Fabric ใน Git

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

<ItemName>.<ItemType>\
    connectors\
        <connectorName>\
            dab-config.json
    data\
        dab-config.json
    frontend\
        static-app.zip
    functions\
        functions-app.zip
        deploymetadata.json
    storage\
        storage-config.json
    .fabric-app-metadata.json
    .platform
    rayfin.yml
ไฟล์หรือโฟลเดอร์ สิ่งที่มีอยู่ภายใน วิธีการจัดการ
connectors\<connectorName>\dab-config.json การกําหนดค่า API ข้อมูลสําหรับเอนทิตีที่เปิดเผยของตัวเชื่อมต่อ รักษาชื่อตัวเชื่อมต่อให้สอดคล้องกับการประกาศ และตรวจสอบ workspace และ item ID ที่อ้างอิงสําหรับสภาพแวดล้อมเป้าหมาย
data\dab-config.json การกําหนดค่า API ข้อมูลและโครงสร้างฐานข้อมูลสําหรับเอนทิตีที่ผู้ใช้กําหนดเอง รักษาส่วนขยายสคีมาที่สร้างขึ้น และตรวจสอบการเปลี่ยนแปลงสคีมาก่อนปรับใช้
frontend\static-app.zip แอสเซ็ตส่วนหน้าที่สร้างขึ้น ไม่ใช่โปรเจกต์ซอร์สส่วนหน้า สร้างใหม่จากซอร์สโค้ด รวมชุดนี้เมื่อนําเข้าคํานิยามโดยเปิดใช้งานโฮสติ้ง
functions\functions-app.zip ชุดฟังก์ชันสําหรับการติดตั้งแอปพลิเคชัน สร้างใหม่จากซอร์สโค้ด และรวมไว้กับ deploymetadata.json.
functions\deploymetadata.json manifest ที่ติดตั้งฟังก์ชันที่สร้างขึ้น เก็บรักษาไฟล์นี้ไว้และจับคู่กับ functions-app.zip.
storage\storage-config.json การกําหนดโฟลเดอร์จัดเก็บข้อมูลและกฎการเข้าถึง รักษากฎที่สร้างขึ้นและคํานิยามฟิลด์ไว้ วัตถุที่อัปโหลดจะไม่ถูกรวมอยู่ด้วย
.fabric-app-metadata.json ข้อมูลเวอร์ชันแพ็กเกจที่สร้างโดยแอป เมื่อถูกบันทึก ไฟล์นี้ไม่จําเป็นสําหรับการนําเข้า เก็บรักษาไฟล์นี้เมื่ออัปเดตคําจํากัดความที่ส่งออก
.platform ข้อมูลเมตาของรายการ Fabric และรหัสตรรกะที่ใช้โดยการผสานรวม Git รักษาข้อมูลเมตาและรหัสตรรกะที่สร้างขึ้นไว้
rayfin.yml การกําหนดค่าบริการรันไทม์, การประกาศตัวเชื่อมต่อ และชื่อรหัสลับ โดยไม่มีค่ารหัสลับ สําหรับรายละเอียดการกําหนดค่า โปรดดูโครงสร้างโครงการ Fabric Apps

เก็บชื่อไดเรกทอรีรายการที่สร้างขึ้นไว้เมื่อคุณแก้ไขการตั้งค่าแอป และอย่าเปลี่ยนรหัสตรรกะใน .platform. Fabric ใช้ ID นั้นเพื่อเชื่อมโยงคํานิยามใน Git กับรายการ workspace สําหรับข้อมูลเพิ่มเติม โปรดดูที่ รูปแบบซอร์สโค้ดการรวมตัวของ Git

Note

ข้อมูลที่ส่งออก rayfin.yml แสดงถึงการกําหนดค่าขณะรัน ไม่ใช่สําเนาของโปรเจกต์ rayfin/rayfin.ymlท้องถิ่น การส่งออกไม่ได้สร้างเส้นทางท้องถิ่น คําสั่งสร้าง และการตั้งค่าการพัฒนาใหม่ สําหรับการกําหนดค่าภายในเครื่อง ดูที่โครงสร้างโครงการ Fabric Apps

การกําหนดค่าข้อมูลและตัวเชื่อมต่อ

ไฟล์นี้ data\dab-config.json อธิบายถึงเอนทิตีของแอปคุณ สิทธิ์ API และโครงสร้างฐานข้อมูล จะไม่รวมการตั้งค่าการเชื่อมต่อข้อมูลของสภาพแวดล้อมต้นทางและหน่วยงาน Usersที่จัดการโดยแพลตฟอร์ม เช่น . เป้าหมายจะให้บริการข้อมูลของตัวเอง;แถวฐานข้อมูลจะไม่ถูกคัดลอก

แต่ละตัวเชื่อมต่อที่รองรับ GraphQL ที่กําหนดค่าไว้สามารถมีไฟล์ของ connectors\<connectorName>\dab-config.json ตัวเอง โดยที่ <connectorName> คือชื่อที่เป็นมิตร เช่น adventureWorksSql. การประกาศคอนเนคเตอร์ที่ไม่มีการกําหนดค่าเอนทิตีที่คงอยู่อาจไม่มีไฟล์นี้ ใช้การกําหนดค่าคอนเนคเตอร์กับต้นทางก่อนส่งออกหากคุณคาดหวังให้มีเอนทิตีที่กําหนดค่าไว้ สําหรับการตั้งค่าตัวเชื่อมต่อ ดูที่ Connect Fabric Apps to Fabric data

ข้อควรระวัง

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

การกําหนดค่าการจัดเก็บข้อมูล

ไฟล์กําหนด storage\storage-config.json โฟลเดอร์จัดเก็บและกฎการเข้าถึง ไม่ใช่วัตถุที่อัปโหลดเข้าไป ทั้งบริการข้อมูลและบริการจัดเก็บข้อมูลต้องเปิดใช้งานเพื่อใช้การตั้งค่านี้

แพ็กเกจส่วนหน้าและฟังก์ชัน

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

การส่งออกส่วนหน้าจะไม่รวมไฟล์หรือสภาพแวดล้อมเฉพาะrayfin.config.jsonconfig.json การนําเข้าจะสร้างการกําหนดค่ารันไทม์สําหรับเป้าหมายใหม่ ถ้าโฮสต์แบบคงที่เปิดใช้งานแต่ซอร์สโค้ดไม่มีชุด frontend ให้ติดตั้ง frontend ก่อนส่งออก

ฟังก์ชันส่งออกจะ local.settings.json ลบไฟล์ จัดส่ง functions-app.zip และ deploymetadata.json รวมกันเมื่อนําเข้า และเก็บรักษารายการสินค้าที่สร้างขึ้น หากไม่มีแอปพลิเคชันฟังก์ชันใดถูกจัดเตรียมไว้บนซอร์ส ไฟล์ทั้งสองอาจหายไป

ตรวจสอบไฟล์กําหนดค่าและเนื้อหาที่บรรจุไว้ก่อนที่คุณจะ commit อย่าใส่ข้อมูลรับรองหรือความลับอื่น ๆ

Important

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

ซิงค์การเปลี่ยนแปลงระหว่าง Fabric และ Git

การเปลี่ยนแปลงใน workspace และการเปลี่ยนแปลงใน Git จะไม่ซิงค์โดยอัตโนมัติหลังจากการเชื่อมต่อครั้งแรก ใช้ การควบคุม Source เพื่อ ยืนยันการเปลี่ยนแปลงในพื้นที่ทํางานหรือใช้การเปลี่ยนแปลง Git ที่เข้ามา

Important

Git เก็บชื่อลับ ไม่ใช่ค่าต่าง ๆ หลังจากนําเข้าแอปหรือชื่อลับใหม่จาก Git แล้ว ให้ตั้งค่าค่าใน แอปเป้าหมาย ค่าความลับเป้าหมายที่มีอยู่จะถูกเก็บไว้

ยอมรับการเปลี่ยนแปลงพื้นที่ทํางานใน Git

  1. อัปเดตและปรับใช้แอปของคุณไปยังพื้นที่ทํางานที่เชื่อมต่อ เช่น โดยใช้ Rayfin CLI
  2. ใน workspace ให้ตรวจสอบคอลัมน์สถานะ Git แอปจะแสดงการเปลี่ยนแปลงที่ยังไม่ได้ยืนยันเมื่อคําจํากัดความเปลี่ยนแปลง
  3. ควบคุมแบบโอเพ่นซอร์ส และเลือก การเปลี่ยนแปลง
  4. ตรวจสอบและเลือกแอปและรายการอื่น ๆ ที่คุณต้องการจะบันทึก
  5. ป้อนข้อความ commit แล้วเลือก commit

หลังจากการคอมมิตสําเร็จ รายการที่เลือกจะแสดงสถานะ ซิงค์

การใช้งานร่วมกับท่อส่งงาน

การผสานรวม git เวอร์ชันของคําจํากัดความแอปของคุณ เพื่อส่งเสริมการกําหนดระหว่างพื้นที่ทํางานสําหรับการพัฒนา ทดสอบ และการผลิต ให้ใช้ Deployment pipelines ตรวจสอบการตั้งค่าตัวเชื่อมต่อเฉพาะสภาพแวดล้อมก่อนการปรับใช้ และตรวจสอบแอปในพื้นที่ทํางานเป้าหมายหลังจากนั้น

Important

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

ค่าความลับที่มีอยู่ในแอปเป้าหมายจะถูกเก็บไว้ นอกจากนี้ตรวจสอบ workspace connector และ item ID รวมถึง URI redirect authentication แบบสมบูรณ์สําหรับสภาพแวดล้อมเป้าหมาย;การคัดลอกคําจํากัดความไม่ได้รับประกันว่า dependencies ภายนอกจะถูกแมปใหม่.

อัตโนมัติด้วย API สาธารณะ

สําหรับเวิร์กโฟลว์ที่มีสคริปต์ ให้ใช้ Get Item Definition เพื่อส่งออกคํานิยามแอป, Create Item with Type AppBackend เพื่อสร้างแอปจากคํานิยาม หรือ Update Item Definition เพื่อใช้คํานิยามกับรายการแอปที่มีอยู่

ในคําขอ API ส่วนนิยามจะใช้ InlineBase64 payloads เข้ารหัส YAML และ JSON เป็น UTF-8 ก่อนเข้ารหัส Base64 และเข้ารหัสไฟล์ ZIP จากไบนารีของมัน

API เหล่านี้ทํางานบนคํานิยามของรายการ พวกเขาไม่ได้สร้าง Git commits, ซิงค์สาขา หรือรันสายงาน deployment ตรวจสอบรูปแบบคําขอ สิทธิ์ และการจัดการการทํางานระยะยาวของ API แต่ละตัวก่อนนําไปใช้ในระบบอัตโนมัติ