รุ่น 1.0.0-alpha.1ล่าสุด
บทที่ 2.25
การสร้างสำหรับแต่ละรุ่น
สิ่งที่เปลี่ยนแปลงเมื่อส่วนขยายเดียวต้องทำงานได้ในทุกรุ่น บนไซต์แบบแยกเครือข่าย (Air-gapped) บนเพย์โหลดของ Nexus Edge หรือภายใต้แบรนด์ของลูกค้าเอง ครอบคลุมเส้นแบ่งสิทธิ์ใช้งานสำหรับโมดูลรุ่น Enterprise และการส่งมอบแบบออฟไลน์ที่ลงนามกำกับ พร้อมตารางเปรียบเทียบสิ่งที่ต้องทำแตกต่างกันสำหรับแต่ละเป้าหมาย
หน้านี้แปลโดย AI จากต้นฉบับภาษาอังกฤษ หากมีส่วนใดไม่ชัดเจน โปรดอ้างอิงจากหน้าภาษาอังกฤษ อ่านหน้านี้เป็นภาษาอังกฤษ

ที่ Corrán Orbital เราส่งมอบงานไปยังปลายทางที่หลากหลายกว่าทีมส่วนใหญ่ วิศวกรของเราเองใช้งาน Enterprise บนภาคพื้นดิน ดาวเทียม CORR-3 ใช้งานชุดภารกิจ (mission pack) บน Nexus Edge ลูกค้าสองรายใช้งาน Community บนเซิร์ฟเวอร์เครื่องเดียว อีกหนึ่งรายใช้งานการติดตั้ง Enterprise แบบ air-gapped ที่ไม่เคยเชื่อมต่ออินเทอร์เน็ต และเราได้สร้างแพ็กสำหรับบริษัทประกันภัยรายหนึ่งบนการติดตั้งของบริษัทนั้นเอง โค้ดเบื้องหลังส่วนใหญ่เหมือนกัน และความแตกต่างส่วนใหญ่อยู่ที่ว่าโค้ดได้รับอนุญาตให้ไปที่ใด และไปถึงที่นั่นอย่างไร
บทนี้จะอธิบายเป้าหมายแต่ละแบบตามลำดับ ได้แก่ สิ่งที่คุณใช้เป็นฐานในการสร้าง สิ่งที่คุณไม่ได้รับอนุญาตให้แตะต้อง และวิธีที่ผลลัพธ์ไปถึงลูกค้า ตารางเปรียบเทียบท้ายบทสรุปทั้งหมดไว้ในหน้าเดียว บทที่ 2.18 แบบจำลองส่วนขยาย อธิบายความแตกต่างระหว่างสกิล ปลั๊กอิน แพ็ก และโมดูล บทที่ 2.2 เบื้องหลังรุ่นต่าง ๆ อธิบายรายละเอียดของรุ่นต่าง ๆ
รุ่น Community และ Open core
Community คือแกนหลักแบบโอเพนซอร์ส ภายใต้ Apache License, Version 2.0 คุณสามารถ fork และส่งมอบการเปลี่ยนแปลงของคุณได้ ไฟล์ NOTICE ที่มาพร้อมกันระบุสิ่งหนึ่งที่ควรทราบก่อนที่คุณจะติดแบรนด์ใด ๆ นั่นคือ สัญญาอนุญาตไม่ได้ให้สิทธิ์ใช้ชื่อหรือเครื่องหมายการค้าของ Adverant นอกเหนือจากการระบุแหล่งที่มาของงาน
คุณขยาย Community ด้วยวิธีเดียวกับที่ขยาย Enterprise Plugin SDK (software development kit) เป็นแพ็กเกจเดียวกันในทั้งสองรุ่น และทั้งเทมเพลตบริการเต็มรูปแบบและเกตการปฏิบัติตามข้อกำหนด 22 รายการไม่มีการเปลี่ยนแปลง ดูรายละเอียดได้ใน บทที่ 2.21 The Plugin SDK สกิลก็ใช้งานได้เช่นกัน Community ได้รับเครื่องมือสร้างและคลังของ Skills Engine ครบถ้วน พร้อมการจัดการเวอร์ชันและการทดสอบ ส่วนการเผยแพร่แบบ canary และการอนุมัติโดยสองบุคคลยังคงเป็นของ Enterprise
หน้าสำหรับนักพัฒนาใน Community มี golden path ชุดเดียวกัน โดยมีความแตกต่างสามประการที่คุณจะสังเกตได้ทันที:
- โค้ดของคุณอยู่ใน GitHub แทนที่จะอยู่ในรีโพสิทอรีของการติดตั้งเอง golden path สำหรับปลั๊กอินจะสร้างรีโพสิทอรี GitHub และพื้นที่พัฒนาจากเทมเพลตที่ตรึงเวอร์ชันชุดเดียวกับที่ Enterprise ใช้ หน้าจอ DV18 แสดงการสร้าง
room-bookings - golden path สำหรับแพ็กโดเมนและแพลตฟอร์มเป็นของ Enterprise บน Community คุณสร้างปลั๊กอินและสกิล รวมถึงเลนส์และเวิร์กโฟลว์บนสิ่งที่คุณใช้งานอยู่
- บัตรผ่านของ Community หยุดอยู่ต่ำกว่าระดับ Elevate บนเซิร์ฟเวอร์เครื่องเดียวไม่มีระบบโปรดักชันให้เข้าถึงจาก IDE (integrated development environment) และคุณดูแลเซิร์ฟเวอร์โดยตรง ความพยายามเข้าถึงจาก IDE จะถูกปฏิเสธด้วย
PASS_TIER_REQUIRED
พื้นที่พัฒนาของ Community บนเซิร์ฟเวอร์ขนาดเล็กมีทรัพยากรไม่มากนัก ของเรามี 2 คอร์และหน่วยความจำ 8 GiB ปิดกั้นทุกอย่างยกเว้นสิ่งที่แมนิเฟสต์ประกาศไว้ และสิ้นสุดลงหลังจากไม่มีการใช้งาน 7 วัน
การมีส่วนร่วมกลับคืน
Skills Engine ใช้สัญญาอนุญาต Apache-2.0 เช่นกัน และรับการมีส่วนร่วมตามวิธีปกติ ให้ fork รีโพสิทอรี สร้างแบรนช์จาก main ทำการเปลี่ยนแปลงพร้อมการทดสอบ และรันการตรวจสอบก่อนเปิด pull request:
git checkout -b feature/skill-synthesis-validation
npm test
npm run lint
npm run typecheckการมีส่วนร่วมที่เปลี่ยนพฤติกรรมของระบบต้องมีการทดสอบที่ล้มเหลวหากไม่มีการเปลี่ยนแปลงนั้น นี่ไม่ใช่เพียงแนวปฏิบัติภายใน กฎการทดสอบของ SDK เองกำหนดว่าการทดสอบใหม่ทุกรายการต้องแสดงให้เห็นว่าล้มเหลวบนโค้ดก่อนการเปลี่ยนแปลง และผู้ตรวจสอบจะขอหลักฐาน
โมดูลรุ่น Enterprise และเส้นแบ่งสิทธิ์ใช้งาน
Enterprise คือ Community บวกกับโมดูลที่มีสัญญาอนุญาต โมดูลที่มีสัญญาอนุญาตคืออาร์ติแฟกต์แยกต่างหากที่บริการของ Community โหลดเมื่อเริ่มทำงาน และเป็นวิธีที่ฟีเจอร์ของ Enterprise รวมถึงโมดูลปิดใด ๆ ที่คุณสร้างสำหรับลูกค้า Enterprise เชื่อมต่อเข้ากับแกนหลักแบบโอเพนซอร์ส
กฎที่ทำให้สิ่งนี้ทำงานได้คือเส้นแบ่งสัญญาอนุญาต โมดูลปิดสามารถเข้าถึงรุ่น Community ได้ผ่านแพ็กเกจเดียวเท่านั้น คือ @adverant/nexus-spi ซึ่งเป็นอินเทอร์เฟซผู้ให้บริการ (service provider interface) แพ็กเกจนี้ใช้สัญญาอนุญาต Apache-2.0 และประกอบด้วยอินเทอร์เฟซและ type guard ที่โฮสต์และโมดูลใช้ตรวจสอบกันและกัน โดยไม่มีตรรกะรันไทม์อื่นใด การเชื่อมโยงข้ามเส้นแบ่งต้องเป็นอินเทอร์เฟซหรือโปรโตคอลเครือข่าย ห้ามเป็นซอร์สโค้ด
| รายการที่ส่งออก | คำอธิบาย |
|---|---|
RouteModule |
โมดูลเส้นทางที่มีสัญญาอนุญาต: id, featureGroup, bodies และ register(app, ctx) ซึ่งติดตั้งเราเตอร์ของตนบนแอปของโฮสต์ |
SpiApp |
ส่วนของแอป HTTP ของโฮสต์ที่โมดูลเข้าถึง: use |
SpiContext |
สิ่งที่โฮสต์ส่งให้โมดูล: เกตผลิตภัณฑ์และตัวป้องกันขอบเขต ตัวอ่านสัญญาอนุญาต พูลคิวรีแบบจำกัดขอบเขต สคีมาของบริการ ที่อยู่ต้นทาง และไคลเอนต์ของแพลตฟอร์ม |
SpiRuntime |
ค่าต่าง ๆ ของ plugin SDK ที่โฮสต์ส่งให้โมดูล เพื่อให้โมดูลไม่ต้องนำเข้ารันไทม์ของ SDK เอง |
SpiPlane |
สิ่งที่ plane ที่มีสัญญาอนุญาตเพิ่มเข้ามานอกเหนือจากเส้นทาง เช่น การอ่านข้อมูลหน้าจอที่ให้บริการ |
ScreenModule |
กลุ่มหน้าจอที่มีสัญญาอนุญาตของคอนโซล: group, featureGroup, routes, screens และ menu |
GrantCheck |
(featureGroup) => Promise<{ entitled, code?: 'LICENCE_LOCKED' }> |
เฟรมเวิร์ก HTTP และประเภทหน้าจอของคอนโซลเป็นพารามิเตอร์ประเภท อินเทอร์เฟซจึงไม่ผูกกับสิ่งใด ต่อไปนี้คือโครงสร้างพื้นฐานของโมดูลเส้นทาง โดยใช้ประเภท handler ของ Express:
import type { GrantCheck, RouteModule, SpiApp, SpiContext } from "@adverant/nexus-spi";
import { Router, type RequestHandler } from "express";
export function auditTrail(checkGrant: GrantCheck): RouteModule<RequestHandler> {
return {
id: "audit-trail",
featureGroup: "<feature-group>",
bodies: [],
register(app: SpiApp<RequestHandler>, ctx: SpiContext<RequestHandler>) {
const router = Router();
router.get("/api/audit-trail", ...ctx.requireScope, async (_req, res) => {
const verdict = await checkGrant("<feature-group>");
if (!verdict.entitled) {
res.status(403).json({
error: true,
code: verdict.code,
message: "This organisation's licence does not carry the audit trail.",
troubleshooting: ["An owner or administrator can turn it on with a licence from Adverant."],
});
return;
}
res.json({ entries: [] });
});
app.use(router);
},
};
}<feature-group> คือกลุ่มฟีเจอร์ในตารางรุ่นที่โมดูลให้บริการ เส้นทางที่มีสัญญาอนุญาตทุกเส้นทางทำงานอยู่หลัง ctx.requireScope ซึ่งเป็นเกตผลิตภัณฑ์และตัวป้องกันขอบเขตของโฮสต์ และโมดูลยังตรวจสอบสิทธิ์ของตนเองก่อนตอบกลับด้วย โมดูลที่ไม่มีสิทธิ์จะปฏิเสธด้วย LICENCE_LOCKED และแสดงตัวอย่างของฟีเจอร์ ไม่ใช่ข้อมูล โมดูลของคุณจะไม่นำเข้ารันไทม์ของ plugin SDK เช่นกัน เนื่องจาก SDK เป็นแพ็กเกจของ Community ที่เส้นแบ่งไม่อนุญาต โฮสต์จะส่งค่าของ SDK ที่โมดูลเรียกใช้ให้ ก่อนโหลดโมดูลใด ๆ โฮสต์จะติดตั้ง SpiHost บน globalThis ภายใต้ Symbol.for(SPI_HOST_KEY) ซึ่งเก็บรันไทม์ของ SDK และชุดเครื่องมือเส้นทางของแอปเอง ขั้นตอนนี้ต้องเกิดขึ้นก่อน เพราะโมดูลที่คอมไพล์เป็นบันเดิลเดียวจะถูกประมวลผลทั้งหมดในคราวเดียว และการเรียก register จะช้าเกินไปสำหรับโค้ดที่อ่านค่าของ SDK ขณะโหลด สำหรับประเภทข้อมูล @adverant/nexus-spi/sdk/<module> จะส่งออกการประกาศของ SDK ซ้ำ โดยนำมาจาก SDK รุ่นหนึ่งโดยไม่เปลี่ยนแปลงและตรึงด้วย checksum เพื่อให้โมดูลของคุณตรวจสอบประเภทกับเนื้อหาการปฏิเสธและไคลเอนต์ชุดเดียวกับที่ปลั๊กอินใช้
โมดูลหน้าจอต้องปฏิบัติตามกฎเพิ่มอีกหนึ่งข้อ คือหนึ่งโมดูลต่อหนึ่งกลุ่มฟีเจอร์ ดังนั้นกลุ่มที่มีหน้าจออยู่ในสองกลุ่มฟีเจอร์จะส่งมอบเป็นสองโมดูล และมีเพียงโมดูลเดียวที่มีแถวเมนู
สิ่งที่เกตเส้นแบ่งสัญญาอนุญาตปฏิเสธ
เกตเส้นแบ่งสัญญาอนุญาตของ Adverant บังคับให้โมดูล Enterprise ทุกโมดูลอยู่ภายในเส้นแบ่ง และคุณควรบังคับใช้กฎเดียวกันกับโมดูลปิดของคุณเอง การกำหนดค่าของเกตอยู่ในไฟล์เดียว:
{
"communityScopes": ["@adverant/", "@adverant-nexus/"],
"allowedCommunityPackages": ["@adverant/nexus-spi"],
"enterprisePrefixes": ["@adverant/enterprise-", "@adverant-enterprise/"],
"communityRepos": ["nexus-community", "nexus-core", "Adverant-Nexus-Open-Core"],
"allowedCommunityGoModules": []
}แต่ละรายการต่อไปนี้เป็นสิ่งที่ตรวจพบ พร้อมระบุไฟล์และบรรทัด:
- การนำเข้าแพ็กเกจใด ๆ ภายใต้ขอบเขตของ Community ที่ไม่ใช่อินเทอร์เฟซที่อนุญาตหรือแพ็กเกจของ Enterprise รวมถึงการนำเข้าแบบไดนามิก
- specifier, เส้นทางการนำเข้าของ Go หรือ URL ของ dependency ใด ๆ ที่อ้างถึงรีโพสิทอรีของ Community เว้นแต่จะเป็นโมดูล Go ที่ระบุไว้ใน
allowedCommunityGoModules - การนำเข้าแบบสัมพัทธ์ที่ออกไปนอกรีโพสิทอรี
- dependency ใน
package.jsonที่เป็นเส้นทางfile:,link:,portal:หรือworkspace:นอกรีโพสิทอรี หรือเป็น Git URL ไปยังรีโพสิทอรีของ Community replaceในgo.modที่ชี้ออกไปนอกรีโพสิทอรี
เกตจะออกด้วยรหัส 0 เมื่อไม่พบปัญหา และ 1 เมื่อพบปัญหา รหัส 2 หมายความว่าเกตปฏิเสธการทำงาน เนื่องจากการกำหนดค่าไม่ถูกต้องหรือไม่ได้สแกนสิ่งใดเลย แพ็กเกจอินเทอร์เฟซไม่ได้เผยแพร่ไว้ในรีจิสทรี คุณต้องเก็บสำเนาของแพ็กเกจที่บิลด์แล้วซึ่งตรึงระดับไบต์ไว้ในรีโพสิทอรีของคุณเป็นแพ็กเกจ file: ภายในเครื่อง พร้อมการตรึง SHA256SUMS และการตรวจสอบในไปป์ไลน์ที่ปฏิเสธสำเนาที่แตกต่าง เนื่องจากสำเนาอยู่ภายในรีโพสิทอรี เกตจึงยอมรับ
การบิลด์สำหรับแต่ละรุ่น
หากส่วนขยายของคุณส่งมอบให้ลูกค้าทั้งสองรุ่น คุณต้องบิลด์หนึ่งครั้งต่อหนึ่งรุ่น และแต่ละการบิลด์เกิดขึ้นในทรีที่ประกอบขึ้นเฉพาะของตนเอง การประกอบทรีหมายถึงการนำเฉพาะไฟล์ที่เป็นของรุ่นนั้นมาใช้ การส่งออกของ Adverant เองทำสิ่งนี้จากรายการขอบเขต ซึ่งไฟล์ที่ติดตามทุกไฟล์จะถูกกำหนดด้วยกฎแบบ first-match-wins โดยกฎจะระบุความสามารถหนึ่ง และรุ่นของไฟล์จะเป็นไปตามระดับของความสามารถนั้นในตารางรุ่น หรือกฎจะระบุประเภทไฟล์ที่ไม่ได้ส่งมอบในรุ่นใดเลย พร้อมเหตุผล ไฟล์สำหรับการบิลด์เท่านั้นจะส่งมอบในทรีของ Enterprise และในทรีของ Community ด้วยเมื่อมีการทำเครื่องหมายไว้ ลำดับ migration ของโมดูลเป็นข้อมูลของตัวติดตั้งและส่งมอบในทรีของทุกรุ่น
จากนั้นให้รันการบิลด์ทั้งหมดตั้งแต่สถานะสะอาดในแต่ละทรีที่ประกอบขึ้น ซึ่งหมายถึงทั้งสามคำสั่ง ทุกครั้ง:
npm ci
npm test
npm run buildเราได้เรียนรู้เรื่องนี้ด้วยราคาที่แพง ทรีของ Enterprise ผ่านการทดสอบ ขณะที่ทรีของ Community ล้มเหลวในการบิลด์โปรดักชัน เนื่องจากประเภทข้อมูลที่จำเป็นอยู่ในไฟล์ของ Enterprise เท่านั้น การทดสอบที่ผ่านในทรีหนึ่งไม่ได้บอกอะไรเกี่ยวกับอีกทรีหนึ่ง การทดสอบของแต่ละรุ่นนำเข้าได้เฉพาะสิ่งที่อยู่ในทรีของรุ่นนั้น และการส่งออกจะปฏิเสธการทดสอบที่อ้างถึงสิ่งที่อยู่ภายนอก
การส่งออกยังเขียนสัญญาอนุญาตของแต่ละรุ่นด้วย ไฟล์ของ Community มีตัวระบุ SPDX (Software Package Data Exchange) Apache-2.0 ส่วนไฟล์ของ Enterprise มี LicenseRef-Adverant-Enterprise และ package.json ของไฟล์ระบุว่า UNLICENSED อย่าแก้ไขฟิลด์เหล่านี้ด้วยตนเอง การส่งออกจะเขียนทับฟิลด์เหล่านี้ และสำเนาที่ไม่ตรงกับข้อความสัญญาอนุญาตที่ตรึงไว้จะถูกปฏิเสธ
รุ่น Team: คลาวด์เท่านั้น
Team คือ Community บวกกับชุด Team และใช้งานได้บน Adverant cloud เท่านั้น ไม่มี Team แบบโฮสต์เอง ชุด Team เพิ่มความสามารถหกรายการจาก Community ซึ่งรวมถึงแผงงานรวม สมุดบันทึกที่ใช้ร่วมกัน การดูแลคลังสกิล และการดำเนินงานเวิร์กโฟลว์พร้อมการเลื่อนระดับระหว่างสภาพแวดล้อม
สำหรับผู้สร้าง การใช้งานบนคลาวด์เท่านั้นมีความหมายเพียงประการเดียว คือลูกค้า Team จะได้รับปลั๊กอินของคุณเป็นรีลีสที่ลงนามผ่านแคตตาล็อก ไม่ใช่จากเซิร์ฟเวอร์ของคุณเอง คุณสร้างปลั๊กอินแบบเดียวกับที่ผู้เผยแพร่ภายนอกสร้าง คือบนคลัสเตอร์ผู้เผยแพร่
คลัสเตอร์ผู้เผยแพร่คือคลัสเตอร์เสมือนบน Adverant cloud ที่มีโควตากำหนดโดย Adverant มีเฉพาะข้อมูลตัวอย่างและไม่มีเส้นทางไปยังลูกค้ารายใด การขอสำเนาข้อมูลของลูกค้าแบบปิดบังบนคลัสเตอร์นี้จะถูกปฏิเสธด้วย TENANT_BOUNDARY ลูกค้าสามารถแบ่งปันผลการทดสอบกับคุณได้ แต่ไม่สามารถแบ่งปันข้อมูลของตน บัตรผ่านของคุณบนคลัสเตอร์นี้ไม่สามารถเข้าถึงลูกค้าได้ เมื่อรีลีสพร้อม รีลีสจะได้รับการลงนามและตรวจสอบโดย Adverant ก่อนแสดงในแคตตาล็อก จากนั้นลูกค้าแต่ละรายเลือกว่าจะติดตั้งหรือไม่ และให้สิทธิ์เฉพาะสิ่งที่แมนิเฟสต์ประกาศไว้ทีละหน่วย การเรียกสิ่งใดก็ตามที่แมนิเฟสต์ไม่ได้ประกาศไว้จะถูกปฏิเสธที่ฝั่งลูกค้าด้วย CONNECTION_SCOPE_EXCEEDED และวิธีเดียวที่จะเพิ่มได้คือรีลีสใหม่ที่ลูกค้าตรวจสอบ
ลูกค้าแบบแยกเครือข่าย (Air-gapped)
ลูกค้ารายหนึ่งของเราใช้งาน Nexus ในสภาพแวดล้อมที่ไม่มีสิ่งใดเข้าหรือออกผ่านเครือข่าย การติดตั้งของลูกค้ารายนี้อธิบายไว้ใน บทที่ 2.10 การติดตั้งแบบ air-gapped สำหรับเรา หมายถึงการส่งมอบปลั๊กอินบนสื่อที่ลงนามแล้ว และเครื่องมือสำหรับงานนี้คือ nexus-airgap จากชุดเครื่องมือส่งมอบแบบอธิปไตย @adverant/nexus-sovereign
บันเดิลแบบปิดผนึกคือ tarball หนึ่งไฟล์ที่ลงนามแล้วและครบถ้วนในตัวเอง สามารถบรรจุอิมเมจและ migration, สกิลที่ลงนามไว้ล่วงหน้าและน้ำหนักโมเดล และ SBOM (software bill of materials) พร้อมสัญญาอนุญาตของทุกสิ่งภายใน แมนิเฟสต์ของบันเดิลแสดงรายการทุกไฟล์พร้อม SHA-256 และลงนามด้วย Ed25519 การสร้างบันเดิลจากโค้ดมีลักษณะดังนี้:
import { SealedBundleExporter } from "@adverant/nexus-sovereign";
const { bundleDigest } = await new SealedBundleExporter().export(source, {
outPath: "./cold-chain-0.4.0.tar.gz",
profile: "airgap",
signerPrivateKeyPem,
});signerPrivateKeyPem คือคีย์สำหรับลงนามรีลีสของคุณ คำสั่ง nexus-airgap bundle ทำสิ่งเดียวกันจากบรรทัดคำสั่ง จากนั้นผู้ปฏิบัติงานของลูกค้าจะตรวจสอบบันเดิลก่อนดำเนินการใด ๆ:
nexus-airgap verify --bundle cold-chain-0.4.0.tar.gz --trusted-key corran-release.pub.pem --profile airgapการตรวจสอบจะคำนวณแฮชของทุกไฟล์ใหม่เทียบกับแมนิเฟสต์ ปฏิเสธไฟล์ใด ๆ ที่แมนิเฟสต์ไม่ได้ระบุ กำหนดให้ต้องมีผู้ลงนาม Ed25519 ที่เชื่อถือได้ และปฏิเสธบันเดิลใด ๆ ที่รายการอนุญาตเครือข่ายไม่ว่างเปล่า ไฟล์ที่ถูกเปลี่ยนแปลงหลังการลงนามจะล้มเหลวด้วย BUNDLE_INTEGRITY_VIOLATION ให้แจ้งผู้ปฏิบัติงานให้หยุดที่จุดนั้นและติดต่อคุณ มีสวิตช์แบบไม่เข้มงวดอยู่ แต่ผู้ปฏิบัติงานไม่ควรใช้เด็ดขาด
กฎสามข้อที่ทำให้การส่งมอบของเราสำเร็จ:
- คีย์ที่เชื่อถือได้ต้องส่งแยกจากบันเดิล เราส่งคีย์สาธารณะและ SHA-256 ของบันเดิลผ่านช่องทางที่ต่างจากสื่อ เพื่อไม่ให้บันเดิลรับรองตัวเองได้
- ไม่มีสิ่งใดในบันเดิลที่ต้องใช้เครือข่ายในระหว่างการติดตั้ง ไม่มีการดึงแพ็กเกจ ไม่มีการดาวน์โหลดโมเดล ไม่มีการเรียกตรวจสอบสัญญาอนุญาต หากปลั๊กอินต้องใช้โมเดล เซิร์ฟเวอร์โมเดลของลูกค้าเองจะจัดหาให้ผ่าน AI (artificial intelligence) Provider Router
- หลังจากตรวจสอบแล้ว ผู้ปฏิบัติงานจะนำรีลีสเข้ามาผ่านช่องทางรีลีสของการติดตั้งเอง เหมือนกับที่ลูกค้าที่เชื่อมต่อเครือข่ายทำทุกประการ บันเดิลเป็นเพียงวิธีที่ข้อมูลมาถึง ไม่ใช่ทางเลี่ยงเกตการเลื่อนระดับ
งานแบบ air-gapped ช้ากว่า และเราไม่สามารถแก้ไขเรื่องนี้จากฝั่งของเราได้ ไบต์ที่ผิดพลาดเพียงหนึ่งไบต์หมายถึงการทำสื่อชุดใหม่และการเดินทางอีกครั้ง ดังนั้นเราจึงตรวจสอบบันเดิลด้วยตนเองบนเครื่องที่สะอาดด้วยคำสั่งเดียวกันก่อนที่จะส่งออกจากสำนักงาน
แพ็กภารกิจ Nexus Edge
Nexus Edge คือ Nexus ขนาดเล็กที่ทำงานบนดาวเทียมและโดรน บนคอมพิวเตอร์ภารกิจที่แยกออกจากคอมพิวเตอร์การบิน เป็นส่วนเสริมที่มีใบอนุญาตต่อแพลตฟอร์มหรือต่อฝูง สิ่งที่เปลี่ยนไปในแต่ละภารกิจคือชุดภารกิจ (mission pack) และการสร้างชุดเหล่านั้นก็เป็นส่วนสำคัญของงานของผม
ชุดภารกิจบรรจุสิ่งที่เพย์โหลดต้องใช้สำหรับหนึ่งภารกิจ นอกเหนือจากโมเดลและอะแดปเตอร์แล้ว ยังมีออนโทโลยีพร้อมกราฟเริ่มต้น ขั้นตอนของเอเจนต์ กฎการแจ้งเตือน ลำดับความสำคัญของสิ่งที่จะส่งลงมาก่อน ตารางการจัดวางที่ระบุว่าคอมพิวเตอร์เครื่องใดทำงานอะไร ขั้นตอนลดระดับที่แพลตฟอร์มสามารถลดลงไปใช้เมื่อคอมพิวเตอร์เครื่องใดล้มเหลว และกรณีทดสอบที่ต้องผ่านบนตัวยาน
ชุดภารกิจถูกสร้างและลงนามบนภาคพื้นดิน ต่อไปนี้คือกฎเชิงปฏิบัติบางข้อจากการสร้างของเรา:
- รักษาส่วนขนาดใหญ่ให้คงที่ Maritime watch 1.5 เพิ่มอะแดปเตอร์ค้นหาเรือและกฎการแจ้งเตือนสองข้อ โดยโมเดลภาษาและออนโทโลยีไม่เปลี่ยนแปลง ชุดภารกิจจึงมีขนาด 412 MB แทนที่จะเป็น 9.8 GB ช่องสัญญาณขาขึ้นมีแบนด์วิดท์แคบ และโมเดลพื้นฐานจะถูกโหลดก่อนการปล่อยยาน
- ใช้โมเดล embedding เดียวสำหรับภารกิจทั้งตระกูล ทั้งบนภาคพื้นดินและบนเพย์โหลด เพื่อให้การเปลี่ยนแปลงของกราฟที่ส่งลงมาสามารถรวมเข้ากับกราฟภาคพื้นดินได้
- เพย์โหลดไม่เคยส่งคำสั่งไปยังระบบการบินเลย แต่จะส่งคำขอแบบมีชนิดข้อมูลผ่าน supervisor ไปยังคอมพิวเตอร์การบิน ซึ่งจะตอบกลับแต่ละคำขอพร้อมเหตุผล
- ฮาร์ดแวร์แต่ละประเภทต้องมีการตรวจสอบชุดภารกิจของตนเอง การติดตั้งชุดภารกิจที่ยังไม่ได้ตรวจสอบสำหรับฮาร์ดแวร์ของอุปกรณ์จะถูกปฏิเสธด้วย
PACK_NOT_CHECKED_FOR_HARDWARE
การเผยแพร่ต้องใช้ลายเซ็นสองในสาม ลายเซ็นของเราและของ Adverant เป็นคู่ที่ใช้ตามปกติ ส่วนลายเซ็นที่สามเป็นคีย์ออฟไลน์ที่เราเก็บไว้ในตู้นิรภัยสำหรับกรณีที่คีย์ใดคีย์หนึ่งในสองคีย์แรกสูญหาย ชุดภารกิจจะถูกส่งขึ้นไปยังสล็อตที่ว่างอยู่ ได้รับการตรวจสอบ รันกรณีทดสอบบนบอร์ดจริง และจะถูกเปิดใช้งานก็ต่อเมื่อผ่านทั้งหมดเท่านั้น โดยมีตัวนับที่ป้องกันไม่ให้ติดตั้งชุดภารกิจรุ่นเก่ากลับเข้าไปใหม่ หากการทดสอบล้มเหลว แพลตฟอร์มจะยังคงใช้ชุดภารกิจเดิม และข้อมูลความล้มเหลวจะถูกส่งลงมาในรอบโคจรถัดไป เราทยอยเผยแพร่ทีละแพลตฟอร์ม โดยแต่ละแพลตฟอร์มจะเริ่มหลังจากแพลตฟอร์มก่อนหน้าทำงานได้โดยไม่มีปัญหาครบหนึ่งสัปดาห์ ชุดภารกิจยังคงใช้ได้ขณะที่แพลตฟอร์มขาดการติดต่อ ดาวเทียมที่ไม่มีการเชื่อมต่อจึงยังคงทำงานด้วยชุดภารกิจที่มีอยู่ได้
บนยานพาหนะและเรือ Edge สามารถทำงานบน k3s ได้ ส่วนยานอวกาศจะใช้ supervisor ที่มีอิมเมจที่ลงนามแล้วหรือไบนารีแบบสแตติก และตารางการจัดวางแบบตายตัวแทน Kubernetes ด้วยเหตุนี้ตารางการจัดวางจึงต้องเดินทางไปพร้อมกับชุดภารกิจ
หน้าร้านแบบ White-label
ส่วนเสริม Storefront / white-label ช่วยให้ลูกค้าสามารถใส่แบรนด์และโดเมนของตนเองในสิ่งที่ผู้ใช้ของตนเห็น พร้อมหน้าจอลงชื่อเข้าใช้ของตนเอง และรับชำระเงินผ่านเกตเวย์ของตนเอง รายละเอียดบัตรจะไม่ผ่าน Nexus เลย
ปลั๊กอินที่สร้างขึ้นสำหรับลูกค้า white-label ต้องไม่แสดง Adverant โดยเด็ดขาด manifest จะบรรจุทุกอย่างที่เฉพาะเจาะจงกับแบรนด์ และแพลตฟอร์มจะดึงส่วนที่เหลือจากแบรนด์ขององค์กรนั้นเอง แทนที่จะดึงจากสิ่งที่ฮาร์ดโค้ดไว้ในโค้ดของคุณ:
{
"domains": [
{ "primary": "<app-domain>", "aliases": ["www.<app-domain>"] }
],
"branding": {
"appName": "<app name>",
"tagline": "<one line>",
"primaryColor": "<hex>",
"accentColor": "<hex>",
"passkeyRpId": "<app-domain>",
"oauthClientRef": "brand:<plugin name>:google"
}
}<app-domain> คือโดเมนของลูกค้าเอง และ passkeyRpId ต้องตรงกับโดเมนนั้น เนื่องจาก passkey ผูกอยู่กับโดเมนที่ผู้ใช้ลงชื่อเข้าใช้ เว็บแอปบน origin ของตนเองจะให้ผู้ใช้ลงชื่อเข้าใช้ผ่านตัวช่วยลงชื่อเข้าใช้ของ SDK ซึ่งมีเส้นทางสาธารณะสองเส้นทาง โดยทั้งสองเส้นทางนี้เป็นเส้นทาง /api ที่ไม่มีการป้องกันเพียงเส้นทางเดียวที่ scope gate ยอมรับ และจะยอมรับก็ต่อเมื่อ manifest ประกาศเส้นทางเหล่านั้นเป็น auth: public ด้วย allowAnonymous: true เท่านั้น การเรียกจากฟรอนต์เอนด์จะผ่านพร็อกซี allow-list ของ backend for frontend เสมอ ไม่เรียกไปยังที่อยู่ของบริการโดยตรง ผู้ดูแลระบบของลูกค้าเป็นผู้กำหนดค่าด้านการชำระเงิน ตั้งแต่เกตเวย์ไปจนถึงหน้าชำระเงินที่ติดแบรนด์ ปลั๊กอินของคุณไม่ได้ทำส่วนนี้
ตารางเปรียบเทียบ
| เป้าหมายการสร้าง | สร้างโดยอิงกับ | สิ่งที่คุณทำแตกต่างออกไป | วิธีที่ส่งถึงลูกค้า |
|---|---|---|---|
| Community | Plugin SDK, Skills Engine | โค้ดอยู่ใน GitHub ไม่มี domain pack หรือเส้นทางของแพลตฟอร์ม ไม่มี Elevate | ลูกค้าติดตั้งเอง ไม่ต้องผ่านการตรวจสอบของแค็ตตาล็อก |
| Enterprise (การติดตั้งของคุณเอง) | Plugin SDK, Skills Engine, เทมเพลตแพ็ก | Dev space, data branch, สำเนาที่ปิดบังข้อมูลร่วมกับเจ้าของข้อมูล; แพ็กและเลนส์ | เลื่อนระดับจาก staging ไปยังหน่วยนำร่อง แล้วจึงไปทุกที่ |
| โมดูล Enterprise (ปิด) | @adverant/nexus-spi เท่านั้น |
กฎเส้นแบ่งใบอนุญาต; การตรวจสอบสิทธิ์บนกลุ่มฟีเจอร์ของตนเอง; LICENCE_LOCKED เมื่อไม่มีสิทธิ์ |
โหลดโดยบริการ Community เมื่อเริ่มทำงาน บนการติดตั้งที่มีใบอนุญาต |
| ทั้งสองรุ่น | Plugin SDK | ประกอบโครงสร้างของแต่ละรุ่น; npm ci, การทดสอบ และการสร้างสำหรับโปรดักชันในแต่ละรุ่น |
หนึ่งการเผยแพร่ต่อรุ่น |
| Team | Plugin SDK บนคลัสเตอร์ของผู้เผยแพร่ | ข้อมูลตัวอย่างเท่านั้น; คลาวด์เท่านั้น | การเผยแพร่ที่ลงนามแล้ว, การตรวจสอบโดย Adverant, แค็ตตาล็อก |
| Air-gapped | Plugin SDK, @adverant/nexus-sovereign |
บันเดิลแบบปิดผนึก; ส่งคีย์และ checksum แยกกัน; ไม่มีการดึงข้อมูลใดๆ ระหว่างการติดตั้ง | สื่อที่ลงนามแล้ว ผ่านการตรวจสอบ จากนั้นผ่านช่องทางการเผยแพร่ของการติดตั้ง |
| Nexus Edge | เนื้อหาของชุดภารกิจ | ตารางการจัดวาง, ขั้นตอนลดระดับ, การทดสอบบนตัวยาน, การตรวจสอบฮาร์ดแวร์ | ลายเซ็นสองในสาม, สล็อตที่ว่าง, เปิดใช้งานหลังผ่านการทดสอบ |
| การใช้แบรนด์ของคุณเอง (White-label) | Plugin SDK | domains และ branding ใน manifest; ไม่มีชื่อ Adverant ที่ใดเลย |
เช่นเดียวกับ Enterprise บนโดเมนของลูกค้าเอง |
ไม่ว่าเป้าหมายจะเป็นแบบใด การปรับใช้จะทำผ่านช่องทางการเผยแพร่ของการติดตั้งเท่านั้น บทที่ 2.28 การเผยแพร่ส่วนขยายของคุณ ครอบคลุมช่องทางเหล่านั้น บทที่ 2.27 สถานการณ์การสร้าง มีสูตรสำหรับแต่ละแถวข้างต้น



