การสนับสนุน
รุ่น 1.0.0-alpha.1ล่าสุด
เอกสารประกอบ
เอกสารคู่มือ Adverant Nexus
รุ่น 1.0.0-alpha.1 เริ่มต้นที่ส่วนที่ 1 หากคุณเพิ่งเริ่มใช้งาน Nexus ส่วนที่ 2 สำหรับผู้ที่ทำหน้าที่ติดตั้งและดูแลระบบ
สำรวจแผนผังโมเดลความรู้คอร์หลักที่ใช้ร่วมกันและแต่ละชุดโดเมน พร้อมเลนส์ โมดูล และความสัมพันธ์
ส่วนที่ 1: สำหรับทุกคน
- 1.1Nexus คืออะไร และเหมาะสำหรับใครสิ่งที่ Adverant Nexus ทำเพื่อองค์กร สร้างขึ้นมาเพื่อใคร และส่วนประกอบต่างๆ ทำงานร่วมกันอย่างไร อธิบายด้วยภาษาที่เข้าใจง่ายโดยใช้ Harrow Port Authority เป็นตัวอย่าง และปิดท้ายด้วยรุ่นทั้งสามในย่อหน้าเดียว
- 1.2หนึ่งวันทำงานกับ Nexusหนึ่งวันทำงานที่ Harrow Port Authority ตั้งแต่การดูหน้า Today ครั้งแรกไปจนถึงการอนุมัติรายการสุดท้าย แสดงให้เห็นว่าผู้คนทำอะไรบ้างใน Nexus และงานแต่ละประเภทอยู่ที่ใด
- 1.3องค์กรของคุณ บุคลากร และสิ่งที่ยังคงเป็นส่วนตัววิธีที่ Nexus จำลองโครงสร้างองค์กรและบทบาทที่บุคลากรถือครอง ผู้ที่มีสิทธิ์ซื้อและอ้างสิทธิ์ในบัญชี Adverant และเส้นแบ่งระหว่างสิ่งที่ผู้ดูแลระบบมองเห็นได้กับสิ่งที่ยังคงเป็นส่วนตัวสำหรับแต่ละบุคคล
- 1.4AI ตามเงื่อนไขของคุณวิธีที่ Nexus ใช้ปัญญาประดิษฐ์ (AI) ตามเงื่อนไขขององค์กรเอง องค์กรนำคีย์โมเดลมาเองและเป็นเจ้าของเอง สวิตช์บอร์ดเดียวจะส่งต่อการเรียกใช้โมเดลทุกครั้งไปยังผู้ให้บริการที่องค์กรเลือก โมเดลภายในทำงานบนเซิร์ฟเวอร์ขององค์กรเอง และไม่มีสิ่งใดถูกส่งไปยัง Adverant โดยที่องค์กรไม่รู้เห็น
- 1.5ความน่าเชื่อถือและการปฏิบัติตามกฎระเบียบส่วนต่างๆ ของ Nexus ที่เจ้าหน้าที่กำกับดูแลการปฏิบัติตามกฎระเบียบใช้งานเป็นประจำ ครอบคลุมถึงบันทึกการตรวจสอบ (Audit Log) และระเบียนที่ปิดผนึก การอนุมัติที่ต้องใช้บุคคลที่สอง และการตัดสินใจของปัญญาประดิษฐ์ (AI) ที่รอการตรวจสอบ ปิดท้ายด้วยคำขอข้อมูลส่วนบุคคลและหน้าการปฏิบัติตามกฎระเบียบที่เตรียมหลักฐานให้พร้อมก่อนที่ผู้ตรวจสอบจะร้องขอ
- 1.6รุ่นและใบอนุญาตใช้งานด้วยภาษาที่เข้าใจง่ายทั้งสามรุ่นของ Nexus รวมถึงส่วนเสริมและชุดเครื่องมือเฉพาะกลุ่มธุรกิจ (Domain Packs) อีก 19 รายการที่ทำงานอยู่ด้านบน จากนั้นอธิบายว่าใบอนุญาตใช้งานทำงานอย่างไรสำหรับธุรกิจ ครอบคลุมถึงการตรวจสอบแบบออฟไลน์และความหมายของสถานะใบอนุญาตใช้งานแต่ละแบบในทางปฏิบัติ คำมั่นสัญญาที่ทุกใบอนุญาตใช้งานรักษาไว้ และการเปลี่ยนจากรุ่น Community เป็น Enterprise โดยไม่ต้องติดตั้งใหม่
- 1.7ชุดเครื่องมือเฉพาะกลุ่มธุรกิจ (Domain Packs) และระบบเฉพาะอุตสาหกรรม (Verticals)สิ่งที่ชุดเครื่องมือเฉพาะกลุ่มธุรกิจเพิ่มให้กับ Nexus สำหรับอุตสาหกรรมหนึ่งๆ ชุดเครื่องมือทั้งสิบที่ Adverant นำเสนอ วิธีเปิดใช้งานชุดเครื่องมือสำหรับหน่วยงานเดียว และสิ่งที่ชุดเครื่องมือต้องการในใบอนุญาตใช้งานของคุณ
- 1.8สถานที่ที่ Nexus ทำงานสถานที่ที่ Nexus สามารถทำงานได้ ตั้งแต่คลาวด์ในสหภาพยุโรปของ Adverant ไปจนถึงไซต์ที่ไม่มีอินเทอร์เน็ตและอุปกรณ์ภาคสนาม ความหมายของอธิปไตยในข้อมูลในทางปฏิบัติ และวิธีการเลือก
- 1.9เริ่มต้นใช้งานสองการตัดสินใจก่อนที่คุณจะเริ่ม สิ่งที่ทีม IT ของคุณต้องทำ การรันครั้งแรกในมุมมองของผู้ดูแลระบบคนแรก และรายการตรวจสอบสิ่งที่ต้องเตรียมให้พร้อมในวันแรก
- 1.10เมื่อไม่ได้อยู่ที่โต๊ะทำงานการใช้งาน Nexus บนโทรศัพท์ ตั้งแต่เลย์เอาต์สำหรับโทรศัพท์ของคอนโซลในทุกรุ่น ไปจนถึงแอปแบบเนทีฟสำหรับ iPhone และ Android ครอบคลุมถึงสิ่งที่ทำงานได้โดยไม่มีสัญญาณ และวิธีที่บริษัทจัดการโทรศัพท์
- 1.11ปรับแต่งให้เป็นแบบของคุณวิธีที่องค์กรปรับแต่ง Nexus ตั้งแต่การตั้งค่าเดียวไปจนถึงระบบเฉพาะอุตสาหกรรมของตนเอง รวมถึงวิธีบรีฟงานนักพัฒนาหรือพาร์ทเนอร์ และสิ่งที่แพลตฟอร์มรับประกันไม่ว่าจะสร้างอะไรขึ้นมาก็ตาม
- 1.12คำถามที่พบบ่อยคำตอบที่ตรงไปตรงมาสำหรับคำถามที่ผู้ซื้อ ผู้จัดการ และเจ้าหน้าที่คุ้มครองข้อมูลถามบ่อยที่สุด รวมถึงคำถามที่ตอบยากเกี่ยวกับเรื่องเงินและการเข้าถึงข้อมูลของคุณ
ส่วนที่ 2: สำหรับ IT, DevOps และนักพัฒนา
- 2.1สถาปัตยกรรมสิ่งที่แต่ละเซอร์วิสในชาร์ต Nexus เป็นเจ้าของและที่เก็บข้อมูลใดที่อยู่ด้านล่าง จากนั้นคือกฎที่ยึดโยงสิ่งเหล่านั้นเข้าด้วยกัน ตั้งแต่การยืนยันตัวตนระหว่างเซอร์วิสไปจนถึงเส้นทางที่ทุกการเรียกใช้โมเดลต้องผ่าน
- 2.2การทำงานเบื้องหลังของแต่ละรุ่นวิธีที่รุ่น Community และ Enterprise ถูกสร้างขึ้นจากผลิตภัณฑ์เดียว วิธีที่ใบอนุญาตใช้งานเปิดกลุ่มฟีเจอร์ขณะรันไทม์ สิ่งที่การติดตั้งแบบ Community แสดงสำหรับหน้าของรุ่น Enterprise และสิ่งนั้นหมายความว่าอย่างไรสำหรับอิมเมจที่คุณดึงมาและส่วนขยายที่คุณสร้าง
- 2.3การวางแผนการติดตั้งสิ่งที่การติดตั้ง Nexus บน Kubernetes ต้องมีก่อนที่คุณจะพิมพ์คำสั่ง ขนาดของระบบ และสองการตัดสินใจที่คุณไม่สามารถย้อนกลับได้ ได้แก่ ชื่อการติดตั้งและผู้ถือครองกุญแจ ปิดท้ายด้วยใบงานการวางแผนที่กรอกข้อมูลแล้วของ Harrow Port Authority
- 2.4การรับและตรวจสอบรีลีสแต่ละส่วนของรีลีส Nexus อยู่ที่ใด วิธีดึงอิมเมจรุ่น Enterprise ด้วยโทเค็นสำหรับดึงข้อมูล (Pull Token) และวิธีพิสูจน์ว่าทุกอิมเมจ ชาร์ต และไฟล์ดาวน์โหลดมาจาก Adverant โดยไม่ถูกเปลี่ยนแปลง แบบออฟไลน์ ก่อนที่คุณจะติดตั้งสิ่งใด
- 2.5การตรวจสอบความพร้อม (Preflight) ด้วย nexusctlทุกการตรวจสอบที่ `nexusctl preflight` ทำ สิ่งที่แต่ละรายการอ่านและสาเหตุที่ทำให้ล้มเหลว รายงานที่พิมพ์และบันทึก วิธีที่รายงานนั้นไปถึงหน้าการตรวจสอบความพร้อมของคอนโซล และทุกแฟล็ก
- 2.6การติดตั้งรุ่น Community บน Kubernetesการติดตั้งรุ่น Community ตามลำดับขั้นตอนด้วย Helm ตั้งแต่ cert-manager ไปจนถึงทุกเวิร์กโหลดพร้อมใช้งาน พร้อมคำอธิบายไฟล์ values ทีละคีย์ เหตุผลที่ไม่มี --wait ลำดับที่ฮุกของชาร์ตทำงาน และแนวทางการติดตั้งด้วย nexusctl เป็นทางเลือก
- 2.7การติดตั้งรุ่น Enterprise และการเปิดใช้ใบอนุญาตสิ่งที่เปลี่ยนแปลงเมื่อคุณติดตั้งรุ่น Enterprise วิธีขอใบอนุญาตจากบัญชี Adverant ของคุณ สามวิธีในการนำเข้าใบอนุญาตพร้อมรหัสการปฏิเสธทั้งหมด และวิธีที่ Harrow Port Authority ย้ายระบบนำร่องรุ่น Community ไปเป็นรุ่น Enterprise ในที่เดิมโดยไม่สูญเสียข้อมูลใดๆ
- 2.8การติดตั้งบนเครื่องเดียวติดตั้ง Nexus บนเซิร์ฟเวอร์ Linux เครื่องเดียวด้วย nexusctl หรือประเมินผลการใช้งานบนแล็ปท็อปด้วย k3d และเข้าถึงคอนโซลผ่าน HTTPS เพื่อให้การลงชื่อเข้าใช้และพาสคีย์ทำงานได้
- 2.9อิมเมจของดิสก์สำหรับติดตั้งบูตเซิร์ฟเวอร์เปล่าหรือเครื่องเสมือนจากอิมเมจสำหรับติดตั้งของ Nexus ซึ่งจะติดตั้งระบบปฏิบัติการ, k3s, cert-manager และ Nexus โดยไม่ต้องเชื่อมต่อเครือข่าย พร้อมทั้งตรวจสอบทุกไฟล์ก่อนนำไปใช้งาน
- 2.10การติดตั้งแบบแยกขาดจากเครือข่าย (Air-gapped)นำบันเดิลออฟไลน์ที่ลงนามแล้วเข้าไปยังสถานที่ที่ไม่มีอินเทอร์เน็ต ตรวจสอบความถูกต้องกับคีย์ที่คุณแยกนำเข้ามา โหลดเข้าสู่รีจิสทรีของคุณเอง และทำการติดตั้ง ใบอนุญาต การอัปเดต และรายการเพิกถอนจะต้องถูกนำข้ามระบบปิดนี้ด้วยตนเองเช่นกัน
- 2.11รูปแบบการตั้งค่าอื่นๆ: ที่เก็บข้อมูลภายนอก, TLS และ Ingressค่ากำหนดต่างๆ ที่ช่วยปรับ Nexus ให้เข้ากับคลัสเตอร์ที่ไม่ได้เริ่มต้นจากศูนย์ ซึ่งรวมถึง TLS (Transport Layer Security) ตลอดจนฐานข้อมูลที่คุณรันอยู่แล้ว ใบรับรองของคุณเอง Ingress controller ตัวอื่น, Storage class, เมล, พร็อกซี, เรพลิกา และ Managed Kubernetes
- 2.12การเรียกใช้งานครั้งแรกจากระบบที่ยังไม่มีการอ้างสิทธิ์ไปสู่การที่ผู้คนเริ่มทำงาน สร้างรหัสอ้างสิทธิ์ อ้างสิทธิ์ระบบที่ติดตั้งในเบราว์เซอร์ สร้างผู้ดูแลระบบคนแรกด้วยพาสคีย์ จากนั้นเชื่อมต่อระบบลงชื่อเข้าใช้ของบริษัทและเชิญคนอื่นๆ ทั้งหมด
- 2.13ใบอนุญาตสิ่งที่อยู่ในไฟล์ใบอนุญาตของ Nexus วิธีที่ระบบตรวจสอบไฟล์แบบออฟไลน์ สถานะทั้งหกที่เป็นไปได้ และวิธีขอ นำเข้า ต่ออายุ และเพิกถอนใบอนุญาต
- 2.14ผู้ให้บริการและโมเดล AIวิธีที่ตัวจัดเส้นทางผู้ให้บริการปัญญาประดิษฐ์ (AI) เลือกโมเดลจากพูลคีย์ขององค์กรเอง และวิธีที่สคริปต์และเครื่องมือ AI เข้าถึง Nexus จากภายนอก
- 2.15วันที่สอง: การดูแลระบบ Nexusงานประจำในการดูแลระบบที่ติดตั้งหลังจากสัปดาห์แรก เริ่มตั้งแต่การปลดผนึกที่เก็บคีย์หลังจากการรีสตาร์ท ไปจนถึงการถอนการติดตั้ง
- 2.16ความปลอดภัยและระบบเครือข่ายสิ่งที่ระบบอนุญาตให้เข้าและออก วิธีที่บริการต่างๆ พิสูจน์ตัวตนต่อกัน และมาตรการควบคุมที่ผู้ดูแลระบบตั้งค่าหรือรับช่วงต่อสำหรับการลงชื่อเข้าใช้และฐานข้อมูล
- 2.17การแก้ไขปัญหาปัญหาที่ผู้ดูแลระบบพบบ่อยที่สุด จัดเรียงตามอาการที่คุณเห็น แต่ละหัวข้อจะระบุสาเหตุ คำสั่งที่ใช้ยืนยันปัญหา และวิธีแก้ไข โดยท้ายบทจะเป็นการส่งบันเดิลข้อมูลสำหรับการสนับสนุน
- 2.18โมเดลส่วนขยายหกวิธีในการขยายขีดความสามารถของ Nexus ตั้งแต่การตั้งค่าไปจนถึงแพ็กโดเมน ข้อจำกัดของแต่ละวิธี และวิธีที่ระดับความเชื่อถือและการแยกส่วนกำหนดว่าจะให้โค้ดของคุณทำงานที่ใด โปรดอ่านเนื้อหานี้ก่อนเปิดชุดพัฒนาซอฟต์แวร์ (SDK)
- 2.19กฎที่ทุกส่วนขยายรับช่วงต่อการแยกส่วนบนสามแกน การประมวลผลผ่าน UNO การใช้ AI (ปัญญาประดิษฐ์) ผ่านตัวจัดเส้นทาง คีย์ที่เป็นขององค์กร และการตรวจสอบใบอนุญาต ความหมายของแต่ละกฎที่มีต่อโค้ดของคุณ เกตใดที่เป็นตัวบังคับใช้ และเหตุผลที่คุณรับช่วงต่อกฎเหล่านี้แทนที่จะต้องเขียนขึ้นเอง
- 2.20ทักษะ (Skills)วิธีเขียน ทดสอบ และเผยแพร่ทักษะของ Skills Engine ตำแหน่งที่ทักษะจะปรากฏเมื่อเปิดใช้งานจริง และความแตกต่างของทักษะใน Manifest ของปลั๊กอิน รวมถึงตัวอย่างการใช้งานจริงของการสรุปการจัดสรรท่าเทียบเรือสำหรับ Harrow Port Authority
- 2.21Plugin SDKการติดตั้ง Plugin SDK (ชุดพัฒนาซอฟต์แวร์) เครื่องมือบรรทัดคำสั่ง การสำรวจเทมเพลตแบบบริการเต็มรูปแบบ รายละเอียดทีละฟิลด์ของ Manifest รุ่น v2 และเกตทั้งยี่สิบสองด่านที่ควบคุมให้ปลั๊กอินปฏิบัติตามกฎ
- 2.22รันไทม์ของปลั๊กอินโมดูล SDK (ชุดพัฒนาซอฟต์แวร์) ที่ปลั๊กอินของคุณใช้ทำงาน ตั้งแต่การ์ดควบคุมขอบเขตและรั้วกั้นฐานข้อมูล ไปจนถึงการจ่ายงานของ UNO การอ่านเส้นทาง AI (ปัญญาประดิษฐ์) และการตรวจสอบใบอนุญาต จากนั้นจึงเป็นการทดสอบกับฐานข้อมูลจริง การลงทะเบียนทักษะของคุณ และการเริ่มใช้งาน
- 2.23แพ็กโดเมน (Domain packs)ส่วนประกอบของแพ็กโดเมนและสิ่งที่ระบุไว้ใน pack.json เลนส์และรีจิสทรีของเลนส์ โมเดลความรู้ ตัวเชื่อมต่อ และโอเวอร์เลย์สำหรับอุปกรณ์พกพา วิธีออกใบอนุญาตและเปิดใช้งานแพ็กสำหรับหน่วยงาน และแพ็กทั้งสิบที่ Adverant จัดส่งให้
- 2.24การสร้างกลุ่มอุตสาหกรรมเฉพาะแบบกำหนดเองตั้งแต่ต้นจนจบตัวอย่างการสร้างโดเมนแพ็กสำหรับห่วงโซ่ความเย็น (Cold chain) ตั้งแต่โจทย์แรกไปจนถึงการปล่อยใช้งานจริงสำหรับทุกหน่วยงาน พร้อมด้วยโมเดลความรู้ มุมมอง ทักษะ ปลั๊กอินแบบเต็มรูปแบบ และข้อมูลตัวอย่าง จากนั้นจึงอธิบายวิธีขยายแพ็กที่มีอยู่แล้ว และวิธีเพิ่มมุมมองให้กับแพ็กที่ส่งมอบไปแล้ว
- 2.25การสร้างสำหรับแต่ละรุ่นสิ่งที่เปลี่ยนแปลงเมื่อส่วนขยายเดียวต้องทำงานได้ในทุกรุ่น บนไซต์แบบแยกเครือข่าย (Air-gapped) บนเพย์โหลดของ Nexus Edge หรือภายใต้แบรนด์ของลูกค้าเอง ครอบคลุมเส้นแบ่งสิทธิ์ใช้งานสำหรับโมดูลรุ่น Enterprise และการส่งมอบแบบออฟไลน์ที่ลงนามกำกับ พร้อมตารางเปรียบเทียบสิ่งที่ต้องทำแตกต่างกันสำหรับแต่ละเป้าหมาย
- 2.26การสร้างด้วยเครื่องมือเขียนโค้ด AIวิธีสร้างส่วนขยายของ Nexus อย่างปลอดภัยด้วย Claude Code และเครื่องมือเขียนโค้ด AI (ปัญญาประดิษฐ์) อื่นๆ เริ่มต้นด้วยการเชื่อมต่อ IDE (สภาพแวดล้อมการพัฒนาแบบเบ็ดเสร็จ) ของคุณเข้ากับ Workbench และไฟล์ CLAUDE.md ของโปรเจกต์ที่บรรจุกฎของแพลตฟอร์ม และจบด้วยตัวอย่างคำสั่ง (Prompt) ที่ใช้งานได้จริง 6 รายการ พร้อมเกณฑ์ตรวจสอบที่พิสูจน์ผลลัพธ์ของแต่ละรายการ
- 2.27สถานการณ์จำลองการสร้างคู่มือรวบรวมการสร้าง 13 รูปแบบ ตั้งแต่ทักษะเดียวไปจนถึงการส่งมอบแบบแยกเครือข่าย (Air-gapped) แต่ละรูปแบบจะระบุเป้าหมาย ส่วนประกอบ ขั้นตอนและคำสั่ง เกณฑ์ตรวจสอบที่พิสูจน์ว่าทำงานได้จริง และสิ่งที่เปลี่ยนแปลงไปตามรุ่นและรูปแบบการส่งมอบ
- 2.28การปล่อยส่วนขยายของคุณวิธีที่ปลั๊กอินหรือแพ็กเปลี่ยนผ่านจากการบิลด์ที่สำเร็จไปสู่หน่วยงานที่รันใช้งาน และวิธีถอนออก เวอร์ชัน การตรวจสอบก่อนปล่อย ช่องทางและการติดตั้ง การลงนาม การอนุมัติการเปลี่ยนแปลง บันทึกข้อมูลจำเพาะของการส่งมอบ การย้ายข้อมูล การย้อนกลับ และการปลดระวางเวอร์ชัน
ภาคผนวก: ข้อมูลอ้างอิง
- Aภาคผนวก A: ข้อมูลอ้างอิงค่าของ Helmทุกคีย์ที่ชาร์ต Nexus ยอมรับ ประเภทของคีย์ ค่าที่อนุญาต และค่าเริ่มต้น
- Bภาคผนวก B: ตารางเปรียบเทียบรุ่นรุ่น ส่วนเสริม หรือโดเมนแพ็กใดที่รวมแต่ละความสามารถไว้บ้าง
- Cภาคผนวก C: รหัสข้อผิดพลาดทุกรหัสการปฏิเสธที่ผู้ปฏิบัติงานหรือนักพัฒนาพบ ความหมายของรหัส และสิ่งที่ต้องทำ
- Dภาคผนวก D: เซอร์วิสและพอร์ตทุกเซอร์วิสที่ชาร์ตรัน พอร์ตของเซอร์วิส และคีย์ของค่าที่ใช้กำหนดค่า
- Eภาคผนวก E: อภิธานศัพท์คำศัพท์ที่ใช้ในทั้งสองส่วน อธิบายด้วยถ้อยคำที่เข้าใจง่าย
- Fภาคผนวก F: ภาพรวมสถาปัตยกรรมแพลตฟอร์มทั้งหมด Open core และส่วนที่ต้องใช้สิทธิ์ใช้งานเพิ่มเติมบนนั้น แต่ละวิธีในการรัน Nexus และโดเมนแพ็กทั้งสิบรายการ แสดงด้วยแผนภาพแยกแต่ละหัวข้อ
- Gภาคผนวก G: พจนานุกรมข้อมูลและโมเดลความรู้ฟิลด์ในทุกระเบียน และส่วนประกอบของแต่ละโดเมนแพ็ก
ดาวน์โหลด (Download)
- Part 1, for everyone (PDF) (เปิดในแท็บใหม่) 18 MB
- Part 2, technical, with the appendices (PDF) (เปิดในแท็บใหม่) 40 MB
ไฟล์ PDF เป็นภาษาอังกฤษ