หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
ใช้ไลบรารีตัวแปรใน Fabric เพื่อจัดการการตั้งค่าคอนฟิกในขั้นตอนต่างๆ ของไปป์ไลน์การนําออกใช้ และเพื่อบันทึกค่าใน Git บทความนี้อธิบายวิธีใช้ไลบรารีตัวแปรในบริบทของการจัดการวงจรชีวิตและการรวมอย่างต่อเนื่องและการส่งมอบอย่างต่อเนื่อง (CI/CD)
ไลบรารีตัวแปรและไปป์ไลน์การปรับใช้
คุณสามารถปรับใช้ไลบรารีตัวแปรและค่าในไปป์ไลน์การปรับใช้เพื่อจัดการค่าตัวแปรข้ามขั้นตอนต่างๆ
จําข้อมูลสําคัญนี้:
ชุดค่าทั้งหมดในไลบรารีตัวแปรจะพร้อมใช้งานสําหรับทุกขั้นตอนของไปป์ไลน์การปรับใช้ แต่มีเพียงชุดเดียวเท่านั้นที่เปิดใช้งานในขั้นตอน
ค่าที่ใช้งานอยู่สําหรับแต่ละขั้นตอนจะถูกเลือกอย่างอิสระ คุณสามารถเปลี่ยนได้ตลอดเวลา
เมื่อไลบรารีตัวแปรถูกปรับใช้ไปยังสเตจว่าง การปรับใช้จะสร้างพื้นที่ทํางานที่ชุดค่า Default กําลังทํางานอยู่ หากสภาพแวดล้อมเป้าหมายต้องการชุดค่าอื่น ให้เปิดไลบรารีตัวแปรในพื้นที่ทํางานเป้าหมาย ตั้งค่าค่าที่ต้องการเป็นค่าที่ใช้งานอยู่ และบันทึกไลบรารีตัวแปรก่อนรันรายการที่ขึ้นกับหรือแผนการปรับใช้
แม้ว่าการปรับใช้จะไม่ส่งผลกระทบต่อ ค่าที่ใช้งานอยู่ที่เลือกในแต่ละ ขั้นตอน แต่คุณสามารถอัปเดตค่าได้เองในไลบรารีตัวแปร รายการผู้บริโภคในพื้นที่ทํางาน (ตัวอย่างเช่น ไปป์ไลน์) ได้รับค่าที่ถูกต้องจากชุดค่าที่ใช้งานอยู่โดยอัตโนมัติ
การดําเนินการต่อไปนี้กับตัวแปรหรือชุดค่าในขั้นตอนหนึ่งของไปป์ไลน์การปรับใช้ทําให้ไลบรารีตัวแปรสะท้อนเป็น แหล่งที่มาของฟอร์มที่แตกต่างกันเมื่อเทียบกับ รายการเดียวกันในขั้นตอนอื่น:
- ตัวแปรที่เพิ่ม ลบ หรือแก้ไข
- ชุดค่าที่เพิ่มหรือลบ
- ชื่อของตัวแปร
- ลําดับของตัวแปร
การเปลี่ยนแปลงอย่างง่ายไปยังชุดค่าที่ใช้งานอยู่จะไม่ลงทะเบียนเป็น แหล่งฟอร์มที่แตกต่างกัน เมื่อคุณเปรียบเทียบ ชุดค่าที่ใช้งานอยู่เป็นส่วนหนึ่งของการตั้งค่าคอนฟิกสินค้า แต่ไม่รวมอยู่ในข้อกําหนด นั่นเป็นเหตุผลที่ไม่ปรากฏในการเปรียบเทียบไปป์ไลน์การปรับใช้และจะไม่ถูกเขียนทับในการปรับใช้แต่ละครั้ง
ใช้ค่าไลบรารีตัวแปรในแผนการปรับใช้
การดําเนินการ แผนการปรับใช้ สามารถใช้การอ้างอิงไลบรารีตัวแปรแทนค่าพารามิเตอร์ตามตัวอักษร เมื่อการปรับใช้ทํางาน Fabric จะแก้ไขการอ้างอิงโดยใช้ชุดค่าที่ใช้งานของไลบรารีตัวแปรในพื้นที่ทํางานเป้าหมาย สิ่งนี้ช่วยให้การดําเนินการเดียวกันใช้ค่าที่เฉพาะเจาะจงกับแต่ละขั้นตอนการปรับใช้ได้
ก่อนปรับใช้ ให้แน่ใจว่าพื้นที่ทํางานเป้าหมายมีไลบรารีตัวแปรและตัวแปรที่อ้างอิง และชุดค่าที่ถูกต้องเปิดใช้งานอยู่ การปรับใช้จะไม่เปลี่ยนชุดค่าที่ใช้งานอยู่ หากการปรับใช้สร้างพื้นที่ทํางานเป้าหมาย ค่าเริ่มต้น จะยังคงทํางานจนกว่าคุณจะเลือกและบันทึกชุดค่าอื่น
สําหรับการดําเนินการแผนการปรับใช้ คุณสามารถใช้การอ้างอิงตัวแปรเป็นค่าของพารามิเตอร์ สําหรับข้อมูลเพิ่มเติม ดูที่ ส่งพารามิเตอร์ไปยังการกระทํา
ถ้า Fabric ไม่สามารถแก้ไขการอ้างอิงได้ มันจะรายงานว่าส่วนใดของการอ้างอิงล้มเหลว สําหรับลําดับการแก้ปัญหาและการแก้ไข ดูที่ ความล้มเหลวของความละเอียดอ้างอิงตัวแปร
ไลบรารีตัวแปรและการรวม Git
เช่นเดียวกับรายการ Fabric อื่น ๆ ไลบรารีตัวแปรสามารถรวมเข้ากับ Git สําหรับการควบคุมแหล่งที่มา รายการไลบรารีตัวแปรจะถูกเก็บไว้เป็นโฟลเดอร์ที่คุณสามารถรักษาและซิงค์ระหว่าง Fabric และผู้ให้บริการ Git ของคุณ
สิทธิ์ของรายการจะถูกตรวจสอบระหว่างการอัปเดตและคอมมิต 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 โดยตรง
- ชื่อของชุดค่าแต่ละชุดต้องไม่ซ้ํากันภายในไลบรารีตัวแปร
- ชื่อตัวแปรต้องไม่ซ้ํากันภายในไลบรารีตัวแปร คุณสามารถมีตัวแปรสองตัวที่มีชื่อเดียวกันในพื้นที่ทํางานได้หากอยู่ในรายการที่แตกต่างกัน
- มีค่าที่ใช้งานอยู่หนึ่งค่า (และเพียงค่าเดียว) ที่ตั้งค่าไว้ในไลบรารีตัวแปรในแต่ละครั้ง คุณไม่สามารถลบค่าที่ตั้งค่าในขณะที่ค่านั้นทํางานอยู่ หากต้องการลบ ให้กําหนดค่าชุดค่าอื่นให้ใช้งานก่อน คุณสามารถตั้งค่าที่ใช้งานอยู่ที่แตกต่างกันสําหรับแต่ละขั้นตอนของไปป์ไลน์การปรับใช้