ชุดค่าในไลบรารีตัวแปร

ชุดค่าในไลบรารีตัวแปรให้ชุดค่าทางเลือกสําหรับตัวแปรที่กําหนด ซึ่งสนับสนุนสถานการณ์ต่างๆ เช่น การกําหนดค่าเฉพาะสภาพแวดล้อม (ตัวอย่างเช่น dev, test, prod) การทดสอบ A/B หรือการสลับแหล่งข้อมูลภายในพื้นที่ทํางานเดียวกัน

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

ชุดค่ามีชื่อเฉพาะภายในไลบรารี และสามารถเปลี่ยนชื่อ จัดลําดับใหม่ (ผ่าน git หรือ การอัปเดตด้วย API คําจํากัดความเท่านั้น) หรือลบ (ด้วยการป้องกันเพื่อป้องกันการลบชุดที่ใช้งานอยู่โดยไม่ต้องกําหนดใหม่) ระบบติดตามการเปลี่ยนแปลงและบังคับใช้ขีดจํากัดขนาดเพื่อให้มั่นใจถึงประสิทธิภาพ และการปรับเปลี่ยนชุดค่าใด ๆ จะได้รับการตรวจสอบความถูกต้องก่อนบันทึก โครงสร้างนี้ช่วยให้สามารถจัดการการกําหนดค่าที่มีประสิทธิภาพ ช่วยให้นักพัฒนาสามารถปรับใช้โดยอัตโนมัติและรักษาความสอดคล้องในสภาพแวดล้อมและขั้นตอนต่างๆ

โครงสร้างและการนําชุดค่านิยมไปใช้

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

• ชุดค่าเริ่มต้น: แสดงและมีค่าพื้นฐานของตัวแปรทุกตัวเสมอ (พร้อมกับข้อมูลเมตา เช่น ชื่อและประเภท) ไฟล์ค่าดีฟอลต์จะแจกแจงตัวแปรทั้งหมดด้วยค่าเริ่มต้น (หลัก)

• ชุดค่าสํารอง: สําหรับชุดค่าเพิ่มเติมแต่ละชุด (ตัวอย่างเช่น ชุดค่า "ทดสอบ" หรือ "ผลิต") คําจํากัดความจะแสดงเฉพาะตัวแปรที่ค่านั้นแทนที่ค่าเริ่มต้น ถ้าตัวแปรไม่ได้แสดงอยู่ในไฟล์ชุดค่าเฉพาะ ตัวแปรจะใช้ค่าเริ่มต้นสําหรับชุดนั้นโดยปริยาย

ตัวอย่าง: หากคุณมีตัวแปร ConnectionString ที่มีค่าเริ่มต้น "dev-server" และคุณสร้างชุดค่า "Production" แทนที่สิ่งนี้เป็น "prod-server" คําจํากัดความเริ่มต้นจะมี ConnectionString = "dev-server" และไฟล์ของชุดค่า "Production" จะมี ConnectionString = "prod-server" (และไม่มีอะไรสําหรับตัวแปรที่ยังคงไม่เปลี่ยนแปลง) วิธีการนี้ช่วยให้คําจํากัดความของชุดค่าแบบลีนและเน้นเฉพาะความแตกต่าง

การแสดงการควบคุมแหล่งที่มา

ในการรวม Git ของ Fabric สคีมาด้านบนจะแปลเป็นหลายไฟล์ภายใต้โฟลเดอร์ของไลบรารีตัวแปร โดยการออกแบบ ชุดค่าแต่ละชุดจะถูกทําให้เป็นอนุกรมเป็นไฟล์ JSON ของตัวเอง (ตั้งชื่อตามชุดค่า) ที่มีการแทนที่ แยกจากไฟล์ค่าเริ่มต้น ตัวอย่างเช่น รายการ VL "MyVars" อาจมี:

MyVars_Default.json – ค่าเริ่มต้นของตัวแปรทั้งหมด MyVars_Prod.json – เฉพาะตัวแปรที่มีค่าต่างกันสําหรับขั้นตอน "Prod" MyVars_Test.json – เฉพาะตัวแปรที่มีค่าต่างกันสําหรับขั้นตอน "ทดสอบ"

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

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

Schema และชนิดข้อมูล

ชุดค่าไม่ได้แนะนําชนิดข้อมูลใหม่ พวกเขามีค่าของประเภทเดียวกันที่กําหนดโดยตัวแปรแต่ละตัว ข้อกําหนดของรายการจะบันทึกชื่อ ชนิด ค่าเริ่มต้น และหมายเหตุเพิ่มเติมของตัวแปรแต่ละตัว ชนิดตัวแปรที่ซับซ้อน เช่น การอ้างอิงสินค้า มีสคีมาที่มีโครงสร้าง (การจัดเก็บรหัส) แต่ค่าเหล่านั้นจะแสดงในแต่ละชุดค่าโดยใช้โครงสร้าง JSON ที่สอดคล้องกัน (ตัวอย่างเช่น การอ้างอิงรายการเก็บรหัสพื้นที่ทํางาน + รหัสรายการสําหรับรายการของขั้นตอนนั้น) ไฟล์ชุดค่าทั้งหมดเป็นไปตามโครงสร้างสคีมาเดียวกันกับค่าเริ่มต้น: โดยพื้นฐานแล้วเป็นการแมปชื่อตัวแปรกับค่าของชุดนั้น (รวมถึงเฉพาะชื่อที่แตกต่างจากค่าเริ่มต้น)

แบบแผนการตั้งชื่อสําหรับชุดค่า

ชื่อของค่าที่ตั้งค่าภายในไลบรารีตัวแปรต้องเป็นไปตามข้อตกลงเหล่านี้:

• ไม่ว่างเปล่า
• ไม่มีช่องว่างนําหน้าหรือต่อท้าย
• ขึ้นต้นด้วยตัวอักษรหรือขีดล่าง
• สามารถรวมตัวอักษร ตัวเลข ขีดล่าง และยัติภังค์ได้
• ความยาวไม่เกิน 256 อักขระ

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

ข้อควรพิจารณาและข้อจำกัด

ข้อจํากัดสําหรับชุดค่าทางเลือก

• ชุดค่าทางเลือกในไลบรารีตัวแปรจะปรากฏตามลําดับที่คุณเพิ่ม ในปัจจุบัน คุณไม่สามารถจัดลําดับใหม่ใน UI หากต้องการเปลี่ยนลําดับ แก้ไขไฟล์ JSON โดยตรง
• ชื่อของชุดค่าแต่ละชุดต้องไม่ซ้ํากันภายในไลบรารีตัวแปร
• ชื่อตัวแปรต้องไม่ซ้ํากันภายในไลบรารีตัวแปร คุณสามารถมีตัวแปรสองตัวที่มีชื่อเดียวกันในพื้นที่ทํางานได้หากอยู่ในรายการที่แตกต่างกัน
• มีค่าที่ใช้งานอยู่หนึ่งค่า (และเพียงค่าเดียว) ที่ตั้งค่าไว้ในไลบรารีตัวแปรในแต่ละครั้ง คุณไม่สามารถลบค่าที่ตั้งค่าในขณะที่ค่านั้นทํางานอยู่ หากต้องการลบ ให้กําหนดค่าชุดค่าอื่นให้ใช้งานก่อน คุณสามารถตั้งค่าที่ใช้งานอยู่ที่แตกต่างกันสําหรับแต่ละขั้นตอนของไปป์ไลน์การปรับใช้