หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
คุณสามารถใช้ไลบรารีตัวแปร Microsoft Fabric เพื่อจัดการการกําหนดค่าในขั้นตอนต่างๆ ของไปป์ไลน์การนําออกใช้ และเพื่อบันทึกค่าใน Git บทความนี้อธิบายวิธีใช้ไลบรารีตัวแปรในบริบทของการจัดการวงจรชีวิตและการรวมอย่างต่อเนื่องและการส่งมอบอย่างต่อเนื่อง (CI/CD)
Note
รายการไลบรารีตัวแปร Fabric อยู่ในการแสดงตัวอย่าง
ไลบรารีตัวแปรและไปป์ไลน์การปรับใช้
คุณสามารถปรับใช้ไลบรารีตัวแปรและค่าในไปป์ไลน์การปรับใช้เพื่อจัดการค่าตัวแปรข้ามขั้นตอนต่างๆ
จําข้อมูลสําคัญนี้:
ชุดค่าทั้งหมดในไลบรารีตัวแปรจะพร้อมใช้งานสําหรับทุกขั้นตอนของไปป์ไลน์การปรับใช้ แต่มีเพียงชุดเดียวเท่านั้นที่เปิดใช้งานในขั้นตอน
ค่าที่ใช้งานอยู่สําหรับแต่ละขั้นตอนจะถูกเลือกอย่างอิสระ คุณสามารถเปลี่ยนได้ตลอดเวลา
เมื่อคุณปรับใช้หรือคอมมิตไลบรารีตัวแปรเป็นครั้งแรก คุณสามารถเปลี่ยนค่านี้ได้โดยการเข้าถึงไลบรารีตัวแปรที่สร้างขึ้นใหม่ในขั้นตอนเป้าหมายหรือที่เก็บ และเปลี่ยนชุดที่ใช้งานอยู่
แม้ว่าการปรับใช้จะไม่ส่งผลกระทบต่อ ค่าที่ใช้งานอยู่ที่เลือกในแต่ละ ขั้นตอน แต่คุณสามารถอัปเดตค่าได้เองในไลบรารีตัวแปร รายการผู้บริโภคในพื้นที่ทํางาน (ตัวอย่างเช่น ไปป์ไลน์) ได้รับค่าที่ถูกต้องจากชุดค่าที่ใช้งานอยู่โดยอัตโนมัติ
การดําเนินการต่อไปนี้กับตัวแปรหรือชุดค่าในขั้นตอนหนึ่งของไปป์ไลน์การปรับใช้ทําให้ไลบรารีตัวแปรสะท้อนเป็น แหล่งที่มาของฟอร์มที่แตกต่างกันเมื่อเทียบกับ รายการเดียวกันในขั้นตอนอื่น:
- ตัวแปรที่เพิ่ม ลบ หรือแก้ไข
- ชุดค่าที่เพิ่มหรือลบ
- ชื่อของตัวแปร
- ลําดับของตัวแปร
การเปลี่ยนแปลงอย่างง่ายไปยังชุดค่าที่ใช้งานอยู่จะไม่ลงทะเบียนเป็น แหล่งฟอร์มที่แตกต่างกัน เมื่อคุณเปรียบเทียบ ชุดค่าที่ใช้งานอยู่เป็นส่วนหนึ่งของการตั้งค่าคอนฟิกสินค้า แต่ไม่รวมอยู่ในข้อกําหนด นั่นเป็นเหตุผลที่ไม่ปรากฏในการเปรียบเทียบไปป์ไลน์การปรับใช้และจะไม่ถูกเขียนทับในการปรับใช้แต่ละครั้ง
ไลบรารีตัวแปรและการรวม Git
เช่นเดียวกับรายการ Fabric อื่น ๆ ไลบรารีตัวแปรสามารถรวมเข้ากับ Git สําหรับการควบคุมแหล่งที่มา รายการไลบรารีตัวแปรจะถูกเก็บไว้เป็นโฟลเดอร์ที่คุณสามารถรักษาและซิงค์ระหว่าง Fabric และผู้ให้บริการ Git ของคุณ
สิทธิ์ของรายการจะถูกตรวจสอบระหว่างการอัปเดตและคอมมิต Git
สคีมาสําหรับรายการไลบรารีตัวแปรเป็นออบเจ็กต์ JSON ที่ประกอบด้วยสี่ส่วน:
- โฟลเดอร์สําหรับชุดค่า
- การตั้งค่า
- Platform.jsonไฟล์ที่สร้างขึ้นโดยอัตโนมัติ
- ตัวแปร
ชุดค่า
โฟลเดอร์ไลบรารีตัวแปรประกอบด้วยโฟลเดอร์ย่อยที่เรียกว่าvalueSets โฟลเดอร์นี้ประกอบด้วยไฟล์ JSON สําหรับแต่ละชุดค่า ไฟล์ JSON นี้มีเฉพาะค่าตัวแปรสําหรับค่า ที่ไม่ใช่ค่าเริ่มต้น ในชุดค่านั้น
สําหรับข้อมูลเพิ่มเติมเกี่ยวกับไฟล์ชุดค่า โปรดดูตัวอย่างชุดค่า
ค่าสําหรับตัวแปรที่ไม่ได้อยู่ในไฟล์นี้จะถูกนํามาจากค่าเริ่มต้น
การตั้งค่า
ไฟล์มี settings.json การตั้งค่าสําหรับไลบรารีตัวแปร
สําหรับข้อมูลเพิ่มเติม โปรดดูตัวอย่างsettings.json
ตัวแปร
ไฟล์ประกอบด้วย variables.json ชื่อตัวแปรและค่าเริ่มต้น
สําหรับข้อมูลเพิ่มเติม โปรดดูตัวอย่างvariables.json
ข้อควรพิจารณาและข้อจำกัด
ข้อจํากัดของขนาด
สามารถมี ตัวแปรได้สูงสุด 1,000 ตัวและชุด ค่าได้สูงสุด 1,000 ชุด ตราบใดที่คุณมีคุณสมบัติตรงตามข้อกําหนดทั้งสองข้อนี้:
- จํานวนเซลล์ทั้งหมดในชุดค่าทางเลือกน้อยกว่า 10,000 เซลล์
- ขนาดของสินค้าไม่เกิน 1 MB
ข้อกําหนดเหล่านี้จะได้รับการตรวจสอบเมื่อคุณบันทึกการเปลี่ยนแปลง
เขตข้อมูลหมายเหตุสามารถมีอักขระได้สูงสุด 2,048 อักขระ
เขตข้อมูลคําอธิบายของชุดค่าสามารถมีอักขระได้สูงสุด 2,048 อักขระ
ข้อจํากัดสําหรับชุดค่าทางเลือก
- ชุดค่าทางเลือกในไลบรารีตัวแปรจะปรากฏตามลําดับที่คุณเพิ่ม ในปัจจุบัน คุณไม่สามารถจัดลําดับใหม่ใน UI หากต้องการเปลี่ยนลําดับ แก้ไขไฟล์ JSON โดยตรง
- ชื่อของชุดค่าแต่ละชุดต้องไม่ซ้ํากันภายในไลบรารีตัวแปร
- ชื่อตัวแปรต้องไม่ซ้ํากันภายในไลบรารีตัวแปร คุณสามารถมีตัวแปรสองตัวที่มีชื่อเดียวกันในพื้นที่ทํางานได้หากอยู่ในรายการที่แตกต่างกัน
- มีค่าที่ใช้งานอยู่หนึ่งค่า (และเพียงค่าเดียว) ที่ตั้งค่าไว้ในไลบรารีตัวแปรในแต่ละครั้ง คุณไม่สามารถลบค่าที่ตั้งค่าในขณะที่ค่านั้นทํางานอยู่ หากต้องการลบ ให้กําหนดค่าชุดค่าอื่นให้ใช้งานก่อน คุณสามารถตั้งค่าที่ใช้งานอยู่ที่แตกต่างกันสําหรับแต่ละขั้นตอนของไปป์ไลน์การปรับใช้