เข้าสู่ระบบนัดหมายรับฟังข้อมูลสรุป (or นัดหมายพูดคุยกับทีมงาน)

บทที่ 2.25

การสร้างสำหรับแต่ละรุ่น

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

หน้านี้แปลโดย AI จากต้นฉบับภาษาอังกฤษ หากมีส่วนใดไม่ชัดเจน โปรดอ้างอิงจากหน้าภาษาอังกฤษ อ่านหน้านี้เป็นภาษาอังกฤษ

ใช้เวลาอ่าน 17 นาที

ที่ 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
การพัฒนาบน Community
การสร้างปลั๊กอินการจองบนเซิร์ฟเวอร์ Community เครื่องเดียว สังเกตบัตรผ่านการเข้าถึงซึ่งไปถึงระดับ Propose ผ่าน GitHub และไม่มีระดับ Elevate รวมถึงตัวอย่างทางด้านขวาที่แสดงรายการสิ่งที่ Enterprise เพิ่มเข้ามา

หน้าสำหรับนักพัฒนาใน Community มี golden path ชุดเดียวกัน โดยมีความแตกต่างสามประการที่คุณจะสังเกตได้ทันที:

  1. โค้ดของคุณอยู่ใน GitHub แทนที่จะอยู่ในรีโพสิทอรีของการติดตั้งเอง golden path สำหรับปลั๊กอินจะสร้างรีโพสิทอรี GitHub และพื้นที่พัฒนาจากเทมเพลตที่ตรึงเวอร์ชันชุดเดียวกับที่ Enterprise ใช้ หน้าจอ DV18 แสดงการสร้าง room-bookings
  2. golden path สำหรับแพ็กโดเมนและแพลตฟอร์มเป็นของ Enterprise บน Community คุณสร้างปลั๊กอินและสกิล รวมถึงเลนส์และเวิร์กโฟลว์บนสิ่งที่คุณใช้งานอยู่
  3. บัตรผ่านของ 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 และการตรวจสอบในไปป์ไลน์ที่ปฏิเสธสำเนาที่แตกต่าง เนื่องจากสำเนาอยู่ภายในรีโพสิทอรี เกตจึงยอมรับ

กล่องขนาดใหญ่สองกล่องวางเคียงกัน กล่องซ้ายมีป้ายกำกับ "Community (Apache-2.0)" และมีกล่องย่อยสำหรับ "Services", "Plugin SDK" และ "@adverant/nexus-spi" กล่องขวามีป้ายกำกับ "Enterprise module (closed)" และมี "RouteModule", "ScreenModule" และ "GrantCheck" ลูกศรเส้นทึบหนึ่งเส้นข้ามเส้นแบ่ง จากกล่องขวาไปยัง "@adverant/nexus-spi" เท่านั้น โดยมีป้ายกำกับ "compile against" ลูกศรเส้นประสองเส้นจากกล่องขวาไปยัง "Services" และ "Plugin SDK" ถูกขีดฆ่าและมีป้ายกำกับ "licence-line gate: finding"
เส้นแบ่งสัญญาอนุญาตระหว่าง Community และโมดูล Enterprise

การบิลด์สำหรับแต่ละรุ่น

หากส่วนขยายของคุณส่งมอบให้ลูกค้าทั้งสองรุ่น คุณต้องบิลด์หนึ่งครั้งต่อหนึ่งรุ่น และแต่ละการบิลด์เกิดขึ้นในทรีที่ประกอบขึ้นเฉพาะของตนเอง การประกอบทรีหมายถึงการนำเฉพาะไฟล์ที่เป็นของรุ่นนั้นมาใช้ การส่งออกของ 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 ที่มีเฉพาะข้อมูลตัวอย่าง ติดตามลำดับการทำงานจริงที่ด้านบน: IDE เข้าถึงคลัสเตอร์และข้อมูลตัวอย่างของผู้เผยแพร่ รีลีสที่ลงนามแล้วผ่านการตรวจสอบไปยังแคตตาล็อก และไม่มีเส้นทางไปยังลูกค้ารายใด

คลัสเตอร์ผู้เผยแพร่คือคลัสเตอร์เสมือนบน 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 ให้แจ้งผู้ปฏิบัติงานให้หยุดที่จุดนั้นและติดต่อคุณ มีสวิตช์แบบไม่เข้มงวดอยู่ แต่ผู้ปฏิบัติงานไม่ควรใช้เด็ดขาด

กฎสามข้อที่ทำให้การส่งมอบของเราสำเร็จ:

  1. คีย์ที่เชื่อถือได้ต้องส่งแยกจากบันเดิล เราส่งคีย์สาธารณะและ SHA-256 ของบันเดิลผ่านช่องทางที่ต่างจากสื่อ เพื่อไม่ให้บันเดิลรับรองตัวเองได้
  2. ไม่มีสิ่งใดในบันเดิลที่ต้องใช้เครือข่ายในระหว่างการติดตั้ง ไม่มีการดึงแพ็กเกจ ไม่มีการดาวน์โหลดโมเดล ไม่มีการเรียกตรวจสอบสัญญาอนุญาต หากปลั๊กอินต้องใช้โมเดล เซิร์ฟเวอร์โมเดลของลูกค้าเองจะจัดหาให้ผ่าน AI (artificial intelligence) Provider Router
  3. หลังจากตรวจสอบแล้ว ผู้ปฏิบัติงานจะนำรีลีสเข้ามาผ่านช่องทางรีลีสของการติดตั้งเอง เหมือนกับที่ลูกค้าที่เชื่อมต่อเครือข่ายทำทุกประการ บันเดิลเป็นเพียงวิธีที่ข้อมูลมาถึง ไม่ใช่ทางเลี่ยงเกตการเลื่อนระดับ

งานแบบ air-gapped ช้ากว่า และเราไม่สามารถแก้ไขเรื่องนี้จากฝั่งของเราได้ ไบต์ที่ผิดพลาดเพียงหนึ่งไบต์หมายถึงการทำสื่อชุดใหม่และการเดินทางอีกครั้ง ดังนั้นเราจึงตรวจสอบบันเดิลด้วยตนเองบนเครื่องที่สะอาดด้วยคำสั่งเดียวกันก่อนที่จะส่งออกจากสำนักงาน

แพ็กภารกิจ Nexus Edge

Nexus Edge คือ Nexus ขนาดเล็กที่ทำงานบนดาวเทียมและโดรน บนคอมพิวเตอร์ภารกิจที่แยกออกจากคอมพิวเตอร์การบิน เป็นส่วนเสริมที่มีใบอนุญาตต่อแพลตฟอร์มหรือต่อฝูง สิ่งที่เปลี่ยนไปในแต่ละภารกิจคือชุดภารกิจ (mission pack) และการสร้างชุดเหล่านั้นก็เป็นส่วนสำคัญของงานของผม

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

สร้างชุดภารกิจ
สร้างชุดภารกิจ
การสร้าง Maritime watch 1.5 จาก 1.4 โปรดสังเกตกรณีทดสอบบนตัวยาน (48 กรณี ต้องผ่านทั้งหมด) และตารางการจัดวาง ซึ่งระบุว่าสิ่งใดทำงานบนบอร์ด GPU (หน่วยประมวลผลกราฟิก) ทั้งสองบอร์ดและบอร์ด CPU (หน่วยประมวลผลกลาง) ในแต่ละขั้นตอนลดระดับ

ชุดภารกิจถูกสร้างและลงนามบนภาคพื้นดิน ต่อไปนี้คือกฎเชิงปฏิบัติบางข้อจากการสร้างของเรา:

  • รักษาส่วนขนาดใหญ่ให้คงที่ Maritime watch 1.5 เพิ่มอะแดปเตอร์ค้นหาเรือและกฎการแจ้งเตือนสองข้อ โดยโมเดลภาษาและออนโทโลยีไม่เปลี่ยนแปลง ชุดภารกิจจึงมีขนาด 412 MB แทนที่จะเป็น 9.8 GB ช่องสัญญาณขาขึ้นมีแบนด์วิดท์แคบ และโมเดลพื้นฐานจะถูกโหลดก่อนการปล่อยยาน
  • ใช้โมเดล embedding เดียวสำหรับภารกิจทั้งตระกูล ทั้งบนภาคพื้นดินและบนเพย์โหลด เพื่อให้การเปลี่ยนแปลงของกราฟที่ส่งลงมาสามารถรวมเข้ากับกราฟภาคพื้นดินได้
  • เพย์โหลดไม่เคยส่งคำสั่งไปยังระบบการบินเลย แต่จะส่งคำขอแบบมีชนิดข้อมูลผ่าน supervisor ไปยังคอมพิวเตอร์การบิน ซึ่งจะตอบกลับแต่ละคำขอพร้อมเหตุผล
  • ฮาร์ดแวร์แต่ละประเภทต้องมีการตรวจสอบชุดภารกิจของตนเอง การติดตั้งชุดภารกิจที่ยังไม่ได้ตรวจสอบสำหรับฮาร์ดแวร์ของอุปกรณ์จะถูกปฏิเสธด้วย PACK_NOT_CHECKED_FOR_HARDWARE
ลงนามและส่งชุดภารกิจ
ลงนามและส่งชุดภารกิจ
การเผยแพร่ Maritime watch 1.5 ไปยัง CORR-3 ต้องใช้ลายเซ็นสองในสาม คีย์ที่ถูกขโมยเพียงคีย์เดียวจึงไม่สามารถเผยแพร่ชุดภารกิจได้ และแผนแสดงให้เห็นว่าชุดภารกิจจะถูกเปิดใช้งานหลังจากผ่านการทดสอบ 48 รายการบนตัวยานแล้วเท่านั้น

การเผยแพร่ต้องใช้ลายเซ็นสองในสาม ลายเซ็นของเราและของ 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 สถานการณ์การสร้าง มีสูตรสำหรับแต่ละแถวข้างต้น