รุ่น 1.0.0-alpha.1ล่าสุด
บทที่ 2.28
การปล่อยส่วนขยายของคุณ
วิธีที่ปลั๊กอินหรือแพ็กเปลี่ยนผ่านจากการบิลด์ที่สำเร็จไปสู่หน่วยงานที่รันใช้งาน และวิธีถอนออก เวอร์ชัน การตรวจสอบก่อนปล่อย ช่องทางและการติดตั้ง การลงนาม การอนุมัติการเปลี่ยนแปลง บันทึกข้อมูลจำเพาะของการส่งมอบ การย้ายข้อมูล การย้อนกลับ และการปลดระวางเวอร์ชัน
หน้านี้แปลโดย AI จากต้นฉบับภาษาอังกฤษ หากมีส่วนใดไม่ชัดเจน โปรดอ้างอิงจากหน้าภาษาอังกฤษ อ่านหน้านี้เป็นภาษาอังกฤษ

Cold chain 0.4.0 เป็นรุ่นแรกของเราที่ขอสิทธิ์มากกว่ารุ่นก่อนหน้า โดยได้เพิ่มการส่งอีเมลและที่อยู่ภายนอกหนึ่งรายการสำหรับการแจ้งเตือนตู้คอนเทนเนอร์ห้องเย็น บิลด์ผ่านทั้งหมด การทดสอบผ่านในสาขาจำลองทั้งสามแห่ง แต่รุ่นนี้ยังคงค้างอยู่ใน dev space เป็นเวลาสองวัน ระหว่างที่คนสองคนอ่านสิ่งที่รุ่นนี้ต้องการ และอีกคนหนึ่งอนุมัติที่อยู่ดังกล่าว นี่คือความรู้สึกที่การเผยแพร่บน Nexus ควรจะเป็น กล่าวคือ โค้ดเป็นส่วนที่ง่าย ส่วนหลักฐานและการอนุมัติคือตัวการเผยแพร่
บทนี้ครอบคลุมทุกสิ่งระหว่างบิลด์ที่ผ่านแล้วจนถึงเวอร์ชันที่ทำงานสำหรับทุกหน่วย รวมถึงวิธีการถอยกลับ เส้นทางการเลื่อนระดับ ตั้งแต่ dev space ไปยัง staging ไปยังหน่วยนำร่อง และไปยังทุกหน่วย ได้แนะนำไว้แล้วในบทที่ 2.24 การสร้างอุตสาหกรรมเฉพาะแบบกำหนดเองตั้งแต่ต้นจนจบ และผมจะไม่กล่าวถึงด่านตรวจของเส้นทางนั้นซ้ำที่นี่ มีกฎข้อหนึ่งที่เป็นกรอบของทั้งหมด คือการติดตั้งใช้งานต้องทำผ่านช่องทางการเผยแพร่ของการติดตั้งเท่านั้น ไม่มีทางลัดสำหรับการแก้ไขเร่งด่วน และไม่มีผู้ใดแก้ไขอิมเมจที่กำลังทำงานอยู่ด้วยมือ
เวอร์ชัน
หมายเลขเวอร์ชันสามรายการจะเปลี่ยนในการเผยแพร่แพ็ก และควรแยกแยะทั้งสามไว้ให้ชัดเจนในใจ
| สิ่งใด | อยู่ที่ใด | ตัวอย่าง | กฎ |
|---|---|---|---|
| ปลั๊กอิน | version ใน nexus.manifest.json |
0.4.0 |
เวอร์ชันเชิงความหมาย (Semantic version) อนุญาตให้มีส่วนต่อท้ายก่อนเผยแพร่ เช่น -rc.1 |
| แพ็ก | version ใน pack.json |
0.4.0 |
เปลี่ยนไปพร้อมกับเลนส์ คำศัพท์ และคลัสเตอร์ของแพ็ก |
| โมเดลความรู้ | เวอร์ชันของโมเดลเอง | 1.3 ถึง 1.4 |
เปลี่ยนได้ผ่านคำขอเปลี่ยนแปลงกราฟเท่านั้น |
บิลด์สำหรับการพัฒนาจะมีส่วนต่อท้าย 0.4.0-dev จนกว่าจะไปถึง staging ควรให้เวอร์ชันของปลั๊กอินและแพ็กเท่ากันเมื่อจัดส่งพร้อมกัน เพราะจะช่วยลดข้อโต้แย้งในการทบทวนการเผยแพร่ทุกครั้งว่าหลักฐานเป็นของหมายเลขใด
อีกสองเวอร์ชันถูกตรึงไว้แทนที่จะเลือกได้ เวอร์ชันเทมเพลตของแพ็ก (domain-pack@1.6.0 สำหรับ Cold chain) จะถูกกำหนดเมื่อสร้างแพ็ก และเปลี่ยนได้เฉพาะในรูปแบบการเปลี่ยนแปลงที่ผ่านการทบทวนแล้ว ส่วน SDK (ชุดพัฒนาซอฟต์แวร์) จะติดตั้งที่เวอร์ชันที่แน่นอน ไม่ใช่ช่วงเวอร์ชัน เพื่อให้บิลด์เดียวกันให้ผลลัพธ์เหมือนเดิมในเดือนถัดไป:
npm install --save-exact @adverant-nexus/plugin-sdk@2.50.0ทักษะของ Skills Engine ก็มีเวอร์ชันเช่นกัน แต่มีลักษณะการทำงานแตกต่างออกไป แต่ละเวอร์ชันที่เผยแพร่แล้วจะคงที่ และ live, canary และ shadow เป็นป้ายกำกับบนเวอร์ชัน การสลับกลับคือการย้ายป้ายกำกับ และการทำงานที่กำลังดำเนินอยู่จะเสร็จสิ้นบนเวอร์ชันที่เริ่มต้นไว้
ก่อนที่คุณจะขอรับการตรวจสอบ: ไฟล์ Manifest
หน้า Manifest and permissions จะเปรียบเทียบสิ่งที่การเผยแพร่นี้ประกาศไว้กับการเผยแพร่ครั้งล่าสุด ได้แก่ ขอบเขตสิทธิ์ ที่เก็บข้อมูล ที่อยู่ขาออก และโปรไฟล์แซนด์บ็อกซ์ โปรดอ่านหน้านี้ก่อนขอให้ผู้ใดทบทวน เพราะหน้านี้จะบอกคุณอย่างชัดเจนว่าผู้ทบทวนจะถูกขอให้ยอมรับสิ่งใด
การเผยแพร่ที่ขอสิทธิ์มากกว่าที่ manifest เคยประกาศไว้จะถูกระงับไว้ที่เดิมด้วย MANIFEST_SCOPE_WIDENED จนกว่าผู้ทบทวนสองคนจะยอมรับ manifest ที่กว้างขึ้น ที่อยู่ภายนอกยังต้องได้รับการอนุมัติจากผู้ที่รับผิดชอบที่อยู่ภายนอกของลูกค้าด้วย การอนุมัตินั้นมีระยะเวลาที่กำหนด และของเรามีระยะเวลา 12 เดือน คุณมีสองทางเลือก คือลบบรรทัดเหล่านั้นออก หรือขอรับการทบทวน หน้าดังกล่าวมีปุ่มสำหรับทั้งสองทางเลือก
ทุกบรรทัดในหน้านั้นมีการบังคับใช้ขณะทำงาน ไม่ใช่เพียงผ่านการทบทวนเท่านั้น การเรียกใช้เครื่องมือแต่ละครั้งจะถูกตรวจสอบกับขอบเขตสิทธิ์ที่ประกาศไว้ ที่อยู่ภายนอกจะถูกบล็อกหากไม่อยู่ในรายการ และโปรไฟล์แซนด์บ็อกซ์ไม่อนุญาตเครือข่ายอื่นใด ปลั๊กอินที่พยายามเข้าถึงสิ่งที่ไม่ได้ประกาศไว้จะถูกปฏิเสธ และวิธีแก้ไขเพียงวิธีเดียวคือการเผยแพร่รุ่นใหม่ที่ประกาศสิ่งนั้น
การตรวจสอบก่อนปล่อย
หน้า Release review รวบรวมหลักฐานของการเผยแพร่หนึ่งรายการไว้ในตารางเดียว สำหรับผู้ทบทวนที่ไม่ใช่ผู้เขียน
| หลักฐาน | สิ่งที่แสดงสำหรับ 0.4.0 |
|---|---|
| การทดสอบ | 66 จาก 66 ในสาขาจำลองสามแห่ง |
| การตรวจสอบคุณภาพ | เอกสารและโค้ดสอดคล้องกัน |
| นโยบาย | แต่ละเลนส์ทำได้เพียงจำกัดให้แคบลง ฟิลด์ข้อมูลส่วนบุคคลปิดไว้โดยค่าเริ่มต้น |
| ลายเซ็น | อิมเมจและแพ็กเกจลงนามโดยไปป์ไลน์ |
| ความแตกต่างของขอบเขตสิทธิ์ | เพิ่มการส่งอีเมลและที่อยู่ภายนอกหนึ่งรายการ พร้อมการอนุมัติ |
| ความเข้ากันได้ | เวอร์ชันแพลตฟอร์มและเวอร์ชันแพ็กพื้นฐานที่ใช้ทดสอบ |
| การเปลี่ยนแปลงโมเดล | การทดลองรันของคำขอเปลี่ยนแปลงกราฟ: เปลี่ยนชื่อลิงก์ 1,284 รายการ ไม่มีการลบ |
ใต้ตารางเป็นความคิดเห็นเกี่ยวกับการเปลี่ยนแปลงและแหล่งที่มา ได้แก่ ไปป์ไลน์ใดสร้างขึ้น จากการเปลี่ยนแปลงใด digest ของอิมเมจ และเทมเพลต ผู้ทบทวนอนุมัติด้วยพาสคีย์ของตน ผู้ทบทวนสองคนที่ไม่ใช่ผู้เขียนเป็นผู้อนุมัติ จากนั้นไปป์ไลน์จะเลื่อนการเผยแพร่ไปยัง staging ผู้เขียนจะไม่นับเป็นผู้ทบทวนในทุกกรณี และความพยายามดังกล่าวจะถูกปฏิเสธด้วย NEEDS_SECOND_PERSON คำขอทบทวนจะหมดอายุหลังจาก 3 วัน
โปรดตอบคำถามของผู้ทบทวนในช่องความคิดเห็น ไม่ใช่ในหน้าต่างแชต ระหว่างการทบทวนของเรา เจ้าหน้าที่กำกับดูแลการปฏิบัติตามข้อกำหนดของเราถามว่าเหตุใดจำนวนเงินเคลมจึงจัดเป็นข้อมูลเชิงพาณิชย์ และผู้ทบทวนคนที่สองขอแผนการย้อนกลับสำหรับการเปลี่ยนแปลงโมเดล คำตอบทั้งสองข้อกลายเป็นส่วนหนึ่งของบันทึกการเผยแพร่แล้ว ซึ่งเป็นที่ที่ผู้ทบทวนคนต่อไปจะเข้าไปดู
การอนุมัตินโยบายการเปลี่ยนแปลง
การทบทวนการเผยแพร่ครอบคลุมการเผยแพร่โดยรวม บล็อก changePolicy ใน manifest ไปได้ไกลกว่านั้น โดยระบุว่าการเปลี่ยนแปลงประเภทใดต่อส่วนที่ติดตั้งใช้งานได้ของปลั๊กอินของคุณที่ต้องได้รับการอนุมัติ และจากกี่คน
"changePolicy": {
"enabled": true,
"classes": ["website", "bff", "migration"],
"approvals": { "website": 1, "bff": 1, "migration": 2 }
}สามประเภทได้แก่ website (เว็บแอป) bff (backend for frontend) และ migration (การย้ายฐานข้อมูล) แต่ละประเภทที่ระบุใน classes ต้องมีจำนวนของตนเองใน approvals ตั้งแต่ 1 ถึง 10 ประเภทที่คุณไม่ระบุจะไม่อยู่ภายใต้การควบคุม และสคีมาบังคับให้คุณเขียนสิ่งนั้นเป็นการเลือกโดยตั้งใจ แทนที่จะเกิดขึ้นจากการละเว้น เรากำหนดให้มีการอนุมัติสองรายการสำหรับการย้ายฐานข้อมูล เพราะการย้ายฐานข้อมูลเป็นการเปลี่ยนแปลงเพียงอย่างเดียวที่ย้อนกลับได้ยาก
การอนุมัติจะนับตามจำนวนบุคคลที่แตกต่างกัน และผู้เสนอจะไม่ถูกนับรวมในทุกกรณี กฎที่รองรับหลักการนี้ควรทราบไว้ เพราะแต่ละข้อมีการปฏิเสธของตนเอง:
- การอนุมัติจากบุคคลที่เสนอการเปลี่ยนแปลงจะถูกปฏิเสธด้วย
TRUST_APPROVAL_SELF_APPROVAL - บุคคลที่ไม่มีสิทธิ์ทำการเปลี่ยนแปลงประเภทนั้นเลยจะถูกปฏิเสธด้วย
CHANGE_CLASS_NOT_PERMITTED - เมื่อคอมมิตใดในการเปลี่ยนแปลงลงนามโดยข้อมูลประจำตัวเอเจนต์ขององค์กร องค์ประชุมจะเท่ากับจำนวนขั้นต่ำตามปกติบวกหนึ่ง และคะแนนเสียงของเอเจนต์เองจะไม่นับ
- การอนุมัติแต่ละรายการจะบันทึก diff และ head ที่เห็นในขณะนั้น หากการเปลี่ยนแปลงมีการเปลี่ยนไปหลังการอนุมัติครั้งล่าสุด การผสานจะถูกปฏิเสธด้วย
HASH_MISMATCHและต้องรวบรวมการอนุมัติใหม่สำหรับเนื้อหาใหม่
กฎข้อที่สามมีความสำคัญหากคุณพัฒนาด้วยเครื่องมือเขียนโค้ด AI (ปัญญาประดิษฐ์) ตามที่อธิบายไว้ในบทที่ 2.26 การพัฒนาด้วยเครื่องมือเขียนโค้ด AI งานที่เอเจนต์เขียนต้องได้รับการอนุมัติจากมนุษย์มากกว่างานที่บุคคลเขียนหนึ่งรายการ โปรดวางแผนสำหรับเรื่องนี้
การลงนามและการตรวจสอบความถูกต้อง
อิมเมจและแพ็กเกจทุกรายการลงนามโดยไปป์ไลน์ที่สร้างขึ้น และอิมเมจที่ลงนามแล้วเป็นหนึ่งในด่านตรวจสำหรับการเข้าสู่ staging dev space จะรันเฉพาะอิมเมจที่ลงนามแล้วตั้งแต่เริ่มต้น บน Enterprise ผู้ดูแลระบบจะตั้งค่าแต่ละ namespace ให้บันทึกอิมเมจที่ไม่ได้ลงนามหรือปฏิเสธอิมเมจเหล่านั้น และเปลี่ยน namespace ให้เป็นแบบปฏิเสธทีละรายการ เพื่อให้ท้ายที่สุดแล้ว production รันเฉพาะอิมเมจที่ไปป์ไลน์สร้างและลงนามเท่านั้น การลงนามเป็นส่วนหนึ่งของบิลด์ ไม่ใช่สิ่งที่คุณเพิ่มเข้าไปก่อนการเผยแพร่
กฎที่ครอบคลุมทั้งหมดนี้คือ ลายเซ็นที่ไม่ผ่านถือเป็นการปฏิเสธ ไม่ใช่คำเตือนในทุกกรณี การตรวจสอบที่ได้รับ SIG_INVALID จะหยุดทำงาน ไม่ย้อนกลับไปใช้เวอร์ชันที่ไม่ได้ลงนาม และไม่ดำเนินการต่อพร้อมบันทึกหมายเหตุไว้ในล็อก เพราะคำเตือนในล็อกของบิลด์ถือเป็นการผ่านสำหรับทุกคนที่ไม่ได้อ่าน
กฎเดียวกันนี้ใช้กับทุกสิ่งที่คุณส่งมอบผ่านสื่อบันทึกข้อมูล บันเดิลที่ปิดผนึกสำหรับลูกค้าที่ใช้ระบบแบบ air-gapped จะได้รับการตรวจสอบกับกุญแจสาธารณะของคุณก่อนแตกไฟล์ใดๆ และบทที่ 2.25 การพัฒนาสำหรับแต่ละรุ่น แสดงคำสั่งไว้
ข้อมูลจำเพาะของการส่งมอบ
ปลั๊กอินถูกส่งมอบผ่านหลายสิ่งที่แต่ละสิ่งมีชื่อของตนเอง ได้แก่ รีโพซิทอรี กุญแจสำหรับลงนาม deploy namespace คำนำหน้ารีจิสทรี สคีมาฐานข้อมูล ชุดโดเมน และนโยบายการเปลี่ยนแปลง สิ่งใดสิ่งหนึ่งเหล่านี้อาจเป็นจุดที่ปลั๊กอินสองตัวชนกัน หรือปลั๊กอินหนึ่งตัวเบี่ยงเบนไป ข้อมูลประจำตัวการส่งมอบคือบันทึกที่ลงนามแล้วหนึ่งรายการต่อปลั๊กอินที่รวบรวมสิ่งเหล่านี้ทั้งหมด เพื่อให้การตรวจสอบทุกครั้งบนเส้นทางการเผยแพร่อ่านคำตอบเดียวกัน และปฏิเสธเมื่อไม่ตรงกัน
คุณระบุส่วนของคุณผ่าน manifest เท่านั้น ได้แก่ schema db domains changePolicy และ URL ของรีโพซิทอรี แพลตฟอร์มจะเติมส่วนที่เหลือในบันทึกและลงนาม คุณไม่ต้องตั้งชื่อ namespace คำนำหน้ารีจิสทรี หรือกุญแจสำหรับลงนามของคุณเอง สิ่งเหล่านั้นจะถูกกำหนดให้คุณ และ manifest ที่พยายามประกาศสิ่งเหล่านั้นจะเป็นการกล่าวอ้างที่การตรวจสอบจะต้องไม่เชื่อถือ
บันทึกที่ลงนามแล้วมีสิบเอ็ดฟิลด์ ได้แก่ slug ของปลั๊กอิน องค์กรที่เป็นเจ้าของ องค์กรที่สร้างปลั๊กอิน รีโพซิทอรี ชื่อกุญแจสำหรับลงนาม deploy namespace คำนำหน้ารีจิสทรี สคีมาฐานข้อมูล โดเมน นโยบายการเปลี่ยนแปลง และรายการสั้นๆ ของชื่ออิมเมจเดิมที่เคยใช้ก่อนที่คำนำหน้ารีจิสทรีจะมีขึ้น รายการสุดท้ายนี้ลดลงได้เท่านั้น เนื่องจากรายการนี้ลงนามแล้ว ลายเซ็นใหม่จึงสามารถลบรายการออกได้ และไม่มีสิ่งใดสามารถเพิ่มรายการได้อย่างเงียบๆ ลายเซ็นเป็นแบบ Ed25519 บนรูปแบบ JSON มาตรฐานแบบ canonical ของสิบเอ็ดฟิลด์ดังกล่าว ดังนั้นบันทึกที่มี "Tomás" หรือ "Sinéad" อยู่จะตรวจสอบได้ผลเหมือนกันทุกที่
เมื่อการเผยแพร่ไม่ตรงกับบันทึก การปฏิเสธรายการแรกที่พบจะมีผล:
| รหัส | เมื่อใด | HTTP |
|---|---|---|
DELIVERY_IDENTITY_MISSING |
ไม่มีบันทึกสำหรับปลั๊กอิน | 403 |
DELIVERY_PATH_REFUSED |
การพุชอิมเมจนอกคำนำหน้ารีจิสทรีที่ไม่อยู่ในรายการชื่อเดิมที่ลงนามแล้ว | 403 |
NAMESPACE_MISMATCH |
การติดตั้งใช้งานที่กำหนดเป้าหมายไปยัง namespace อื่น | 403 |
IMAGE_NAME_COLLISION |
ชื่ออิมเมจที่ปลั๊กอินอื่นอ้างสิทธิ์ไว้แล้ว | 409 |
CHANGE_CLASS_NOT_PERMITTED |
ประเภทการเปลี่ยนแปลงที่นโยบายไม่ได้ควบคุม | 403 |
IMAGE_NAME_COLLISION เป็นรายการที่ทำให้หลายคนประหลาดใจ โปรดเลือกชื่ออื่น และอย่านำชื่อกลับมาใช้ซ้ำ เพราะชื่ออิมเมจที่ใช้ร่วมกันหมายความว่าการเลื่อนระดับของปลั๊กอินหนึ่งอาจย้าย pod ของปลั๊กอินอื่นได้
การย้ายข้อมูลที่บันทึกแล้วและระบุขอบเขต
การย้ายฐานข้อมูลจัดส่งอยู่ภายในอิมเมจของปลั๊กอินของคุณ และทำงานก่อนที่เวอร์ชันใหม่จะเริ่ม ผ่านตัวรันการย้ายฐานข้อมูลตัวเดียวของ SDK คือ nexus-migrate คุณไม่ต้องเขียนตัวนำไปใช้ของคุณเอง ก่อนที่การเผยแพร่ใดจะเลื่อนระดับได้ ตัวรันเดียวกันนี้จะนำการย้ายฐานข้อมูลของคุณไปใช้ทีละไฟล์กับฐานข้อมูลชั่วคราว เพื่อให้การย้ายฐานข้อมูลที่ล้มเหลวล้มเหลวที่นั่น shadow build ของเทมเพลตจะเรียกตัวรันหนึ่งครั้งต่อไฟล์ตามลำดับ และบันทึกแต่ละไฟล์ในแบบเดียวกับที่ production จะทำ
กฎของตัวรันคือกฎเดียวกับที่ด่านตรวจใช้ตรวจสอบ ซึ่งเขียนไว้ในรูปแบบโค้ด:
- ตัวรันเชื่อมต่อในบทบาท migrator ของสคีมาของคุณ และรันทุกไฟล์ในฐานะเจ้าของสคีมา การเข้าสู่ระบบอื่นใด โดยเฉพาะ superuser จะถูกปฏิเสธ ไฟล์ที่พยายามสลับบทบาทเองจะถูกปฏิเสธก่อนที่จะมีการรันสิ่งใด
- ไฟล์ tenancy ซึ่งมีหมายเลข 0 จะไม่ถูกแก้ไขหลังจากนำไปใช้แล้ว การเปลี่ยนแปลง tenancy จะมีไฟล์ revision ของตนเอง คือ
000_tenancy_r<N>.sqlซึ่งnexus-tenancy render --revision <N>จะเขียนให้คุณ - ตามปกติ ตัวรันจะเป็นเจ้าของ transaction ของแต่ละไฟล์ และปฏิเสธ
BEGINหรือCOMMITภายในไฟล์ ไฟล์ที่จัดการ transaction ของตนเองจะประกาศว่าทำงานแบบต่อคำสั่ง และจากนั้นทุกBEGINที่เปิดขึ้นจะต้องมีคู่ที่ตรงกัน - ตัวรันจะเก็บบัญชีบันทึกไว้ หนึ่งแถวต่อไฟล์ พร้อม SHA-256 ของไฟล์และวิธีที่ไฟล์ทำงาน ไฟล์ที่นำไปใช้แล้วจะไม่ถูกเปลี่ยนแปลงในที่เดิม การเปลี่ยนแปลงคือไฟล์ใหม่ที่มีหมายเลขกำกับ
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-tenancy render --manifest nexus.manifest.json --revision 2 --out migrations/000_tenancy_r2.sqlการกำหนดขอบเขตหมายความว่าทุกตารางใหม่ต้องมี organization_id owner_user_id และ business_unit_id รวมถึงคอลัมน์เครื่องหมาย is_demo เว้นแต่ gates/demo-exempt.json จะยกเว้นตารางนั้นพร้อมระบุเหตุผล โดยมีคีย์หลักที่ขึ้นต้นด้วยองค์กร และคีย์นอกที่นำองค์กรติดไปด้วย และบังคับใช้ความปลอดภัยระดับแถวกับตารางนั้น ด่านตรวจ migrations-are-scoped จะตรวจสอบกฎเหล่านั้นในทุกไฟล์ และ migrations-commit-what-they-open จะนับว่าแต่ละไฟล์คอมมิตสิ่งที่เปิดไว้ ด่านตรวจที่สองมีขึ้นเพราะครั้งหนึ่งการย้ายฐานข้อมูลที่ย้อนกลับอย่างเงียบๆ ได้จบการทำงานด้วยรหัส 0 และตารางที่ควรสร้างขึ้นไม่เคยมีอยู่จริง
มีอีกไฟล์หนึ่งที่เป็นของทุกการเผยแพร่ scripts/ci/required-env จะพิมพ์ตัวแปรสภาพแวดล้อมที่บริการของคุณต้องใช้ในการบูต เป็นอาร์เรย์ JSON ที่นำมาจากตัวโหลดการกำหนดค่าของคุณ เส้นทางการเผยแพร่จะรันไฟล์นี้และปฏิเสธการเผยแพร่ที่การติดตั้งใช้งานไม่ได้ตั้งค่าตัวแปรทุกตัว ดังนั้นตัวแปรที่ขาดหายจะถูกตรวจพบก่อนการเผยแพร่ ไม่ใช่โดย pod ที่เริ่มทำงานไม่ได้
node scripts/ci/required-envการปล่อยทักษะ
ทักษะทั้งสองประเภทเข้าถึงผู้ใช้ผ่านเส้นทางที่แตกต่างกัน ดังนั้นจึงควรเผยแพร่แตกต่างกัน
ทักษะแบบ manifest ซึ่งเป็นแถวที่มีการกำหนดชนิดใน skills[] ของปลั๊กอินของคุณ จะจัดส่งไปพร้อมกับปลั๊กอินและผ่านการเลื่อนระดับแบบเดียวกับส่วนอื่นของปลั๊กอิน กระบวนการเริ่มต้นใช้งานจะซิงค์ชุดทักษะทั้งหมดไปยังรีจิสทรีในทุกการเผยแพร่ หากละทักษะใดออกจากชุด ทักษะนั้นจะถูกปิดใช้งาน และบน Enterprise การซิงค์ที่มีทักษะที่ไม่ถูกต้องเพียงหนึ่งรายการจะไม่นำทักษะใดไปใช้เลย ดังนั้นเวอร์ชันก่อนหน้าจะยังคงทำงานต่อไป แทนที่จะเป็นเวอร์ชันใหม่เพียงครึ่งเดียว
Skill ของ Skills Engine จะเผยแพร่จากไลบรารี ในรุ่น Enterprise skill ที่เพิ่มเครื่องมือสำหรับเขียนข้อมูลจะต้องรอให้บุคคลที่ระบุชื่อสองคนอนุมัติด้วยพาสคีย์ของตน และผู้เสนอไม่สามารถเป็นหนึ่งในนั้นได้ เวอร์ชันที่ได้รับอนุมัติแล้วจะทำงานในโหมด shadow ก่อน จากนั้นทำงานแบบ canary สำหรับหนึ่งหน่วยงานภายใต้เกณฑ์ที่กำหนดชื่อไว้ แล้วจึงเปิดให้ทุกคน และจะหยุดตัวเองหากไม่ผ่านเกณฑ์ใดเกณฑ์หนึ่ง หากปลั๊กอินของคุณและ skill ของ Skills Engine พึ่งพากัน ให้เผยแพร่ skill ก่อนและปล่อยให้ถึงทุกคนก่อนที่รีลีสของปลั๊กอินที่เรียกใช้ skill นั้นจะออกจากช่วงนำร่อง
ช่องทางและการติดตั้ง
เมื่อรีลีสผ่านช่วงนำร่องและไปถึงทุกหน่วยงานแล้ว รีลีสนั้นจะถูกนำเสนอบนช่องทาง และแต่ละหน่วยงานจะเลือกช่องทางของตนเอง ผู้ดูแลระบบของหน่วยงานจะต้องยินยอมในการเปลี่ยนแปลงทุกครั้ง หน้า Channels and installs จะแสดงว่าหน่วยงานใดใช้เวอร์ชันใด พร้อมอัตราข้อผิดพลาดในรูปแบบจำนวนนับเท่านั้น คุณจะเห็นว่าส่วนขยายของคุณทำงานอย่างไร แต่จะไม่เห็นว่าผู้ใดทำอะไรกับส่วนขยายนั้น
ปลั๊กอิน carrier-sync ของเราทำงานสามเวอร์ชันพร้อมกัน และนั่นเป็นเรื่องปกติ หน่วยงานส่วนใหญ่ใช้รีลีสปัจจุบัน หนึ่งหน่วยงานยังคงใช้เวอร์ชันเก่ากว่าบนช่องทางที่คงไว้จนถึงวันที่ที่ระบุ และรีลีสแคนดิเดตอยู่บนช่องทางที่ยังไม่มีผู้ใดเลือก อย่าต่อต้านสิ่งนี้ หน่วยงานที่ต้องการความเสถียรเพื่อการตรวจสอบย่อมมีสิทธิ์ได้รับความเสถียรนั้น
ล็อกและเมตริกของส่วนขยายของคุณ
หน้าบันทึกและตัวชี้วัดสำหรับแพ็กของคุณจำกัดไว้เฉพาะเวิร์กโหลดของคุณเอง ในหน่วยงานที่คุณมีสิทธิ์ดู คุณสามารถกรองตามหน่วยงานและสภาพแวดล้อม และคุณจะเห็นจำนวนนับ ระยะเวลา และสถานะ
ฟิลด์ข้อมูลส่วนบุคคลจะถูกแทนที่ก่อนเขียนบรรทัดบันทึก และเนื้อหาของลูกค้า เช่น ข้อความการเคลม อีเมล หรือเนื้อหาเอกสาร จะไม่ถูกเขียนลงในล็อกเลย ล็อกจะถูกเก็บไว้ 14 วัน องค์กรจะถูกกำหนดโดยเกตเวย์ ไม่ใช่โดยคิวรีของคุณ ดังนั้นคิวรีที่ระบุองค์กรอื่นจะถูกปฏิเสธด้วย TENANT_BOUNDARY ผู้ช่วยใน dock สามารถอ่านล็อกเดียวกันนี้ร่วมกับคุณได้ และอ่านได้เฉพาะล็อกเหล่านี้เท่านั้น เมื่อผมถามว่าเหตุใดระเบียน excursion จึงเข้ามาล่าช้าในเช้าวันหนึ่ง ผู้ช่วยได้ติดตามการลองใหม่นาน 18 นาทีไปจนพบว่าเกิดจากค่าที่อ่านซ้ำจากแหล่งจ่ายไฟของท่าเทียบเรือแห่งหนึ่ง
การย้อนกลับ
การย้อนกลับมีสองประเภท และทั้งสองประเภทเป็นการเปลี่ยนแปลงที่ผ่านการตรวจทาน ไม่ใช่สวิตช์
การย้อนกลับสภาพแวดล้อมจะใช้เวอร์ชันก่อนหน้า แต่ละสภาพแวดล้อมจะเก็บเวอร์ชันนั้นไว้ 30 วัน การย้อนกลับจะถูกเตรียมเป็นการเปลี่ยนแปลงของรีลีส แสดงตัวอย่างสิ่งที่จะเกิดขึ้น และต้องมีบุคคลที่สอง เมื่อได้รับอนุมัติแล้ว ไปป์ไลน์จะย้อนกลับภายในประมาณหนึ่งนาที การย้อนกลับทุกครั้งมีการจับเวลา และการซ้อมทุกครั้งก็เช่นกัน ดังนั้นควรซ้อมไว้ก่อนที่คุณจะต้องใช้จริง การย้อนกลับหนึ่งหน่วยงานใช้หน้า Channels and installs หน้าต่างโมดัลการย้อนกลับจะระบุว่าอะไรเปลี่ยนแปลง (หน่วยงานนั้นจะกลับไปใช้เวอร์ชันเก่ากว่า และอัตราข้อผิดพลาดจะถูกเฝ้าติดตามเป็นเวลาหนึ่งชั่วโมง) อะไรคงเดิม (หน่วยงานอื่น ๆ รวมถึงการตั้งค่าและระเบียนของหน่วยงานนั้น) เหตุผล และบุคคลที่สองคือใคร ซึ่งก็คือผู้ดูแลระบบของหน่วยงานนั้น
การตั้งค่าและระเบียนจะคงอยู่ตลอดการย้อนกลับ ดังนั้นให้วางแผนแต่ละรีลีสโดยสันนิษฐานว่าเวอร์ชันก่อนหน้าอาจกลับมาทำงานอีกครั้งบนข้อมูลที่เวอร์ชันใหม่กว่าเขียนไว้ นั่นคือเหตุผลในทางปฏิบัติที่ควรทำให้การย้ายข้อมูลเป็นแบบเพิ่มเติมเท่านั้นภายในรีลีสที่คุณอาจย้อนกลับ และเป็นเหตุผลที่เราขอให้มีผู้อนุมัติสองคนสำหรับการย้ายข้อมูลแต่ละครั้ง การเปลี่ยนแปลงโมเดลก็เช่นเดียวกัน ผู้ตรวจทานสามารถและควรขอแผนการย้อนกลับของคำขอเปลี่ยนแปลงกราฟก่อนอนุมัติ
การย้อนกลับ skill ทำได้นุ่มนวลกว่า การย้ายป้าย live กลับไปยังเวอร์ชันก่อนหน้าทำได้ในขั้นตอนเดียว และการทำงานที่กำลังดำเนินอยู่จะเสร็จสิ้นบนเวอร์ชันที่เริ่มต้นไว้
การปลดระวางเวอร์ชัน
รีลีสที่สร้างขึ้นแล้วจะไม่ถูกแก้ไขอีก เวอร์ชันที่ไม่ควรใช้งานอีกต่อไปจะถูกเพิกถอน และการแก้ไขจะถูกเผยแพร่เป็นหมายเลขเวอร์ชันใหม่ ช่องทางรีลีสของ SDK เองก็ปฏิบัติตามแนวทางเดียวกัน: SDK เวอร์ชันที่มีปัญหาจะถูกถอนออก และไม่ถูกแทนที่ด้วยเนื้อหาอื่นภายใต้หมายเลขเดิม ให้ทำตามแนวทางนี้ เพราะหมายเลขเวอร์ชันที่อาจหมายถึงบิลด์สองแบบที่แตกต่างกันจะทำให้หลักฐานทุกชิ้นเกี่ยวกับเวอร์ชันนั้นไร้ค่า
การเพิกถอนปลั๊กอินหรือแพ็กจะหยุดการติดตั้งใหม่ หน่วยงานต่าง ๆ จะยังคงใช้เวอร์ชันที่ใช้อยู่จนกว่าจะย้าย ดังนั้นการเพิกถอนจึงเป็นสัญญาณและกำหนดเส้นตาย ไม่ใช่สวิตช์ปิด แจ้งผู้ดูแลระบบของหน่วยงานว่าควรย้ายไปยังเวอร์ชันใดและภายในเมื่อใด
การปลดระวาง skill ใช้แนวคิดเดียวกันโดยมีขั้นตอนเพิ่มอีกหนึ่งขั้น Skills Engine จะย้ายผู้เรียกใช้ที่เหลือทั้งหมดไปยัง skill ทดแทนหลังจากรันกรณีทดสอบของ skill ทดแทนแล้ว หยุดการทำงานใหม่ และเก็บเวอร์ชัน กรณีทดสอบ และระเบียนการทำงานที่ปิดผนึกไว้ เพื่อให้สามารถนำ skill กลับมาได้หาก skill ทดแทนกลายเป็นว่าไม่ถูกต้อง
รายการตรวจสอบการปล่อยใช้งาน
นี่คือรายการที่เราอ่านก่อนรีลีส Cold chain ทุกครั้ง รายการนี้สั้นเพราะแพลตฟอร์มตรวจสอบส่วนใหญ่ให้เราแล้ว
- เวอร์ชันตรงกัน: manifest,
pack.jsonและโมเดลความรู้หากมีการเปลี่ยนแปลง - ทุกเกณฑ์ผ่านเป็นสีเขียวบนเครื่องจากสถานะเริ่มต้นที่สะอาด และการทดสอบใหม่ทุกรายการได้แสดงให้เห็นว่าล้มเหลวก่อน
- หน้า Manifest and permissions ไม่แสดงการขยายสิทธิ์ หรือการขยายสิทธิ์นั้นเป็นสิ่งที่เราตั้งใจไว้และผู้ตรวจทานทราบเหตุผล
- การย้ายข้อมูลทุกรายการเป็นไฟล์ใหม่ที่มีหมายเลข กำหนดขอบเขตไว้ และนำไปใช้กับฐานข้อมูลชั่วคราวได้อย่างไม่มีปัญหา
scripts/ci/required-envระบุตัวแปรทุกตัวที่บริการต้องใช้ และการดีพลอยกำหนดค่าให้แต่ละตัว- แผนการย้อนกลับเขียนไว้ในการเปลี่ยนแปลง รวมถึงสำหรับการเปลี่ยนแปลงโมเดลใด ๆ
- มีผู้ตรวจทานสองคนที่ไม่ใช่ผู้เขียนพร้อมทำงานในสัปดาห์นี้
รายการสุดท้ายฟังดูเล็กน้อย แต่เป็นรายการที่ทำให้รีลีสของเราล่าช้ามากกว่าเกณฑ์ทั้งหมดรวมกัน



