로그인브리핑 예약

챕터 2.25

에디션별 빌드

하나의 확장이 모든 에디션, 에어갭(망분리) 사이트, Nexus Edge 페이로드 또는 고객의 자체 브랜드 환경에서 작동해야 할 때 달라지는 점을 설명합니다. Enterprise 모듈의 라이선스 기준선과 서명된 오프라인 배포를 다루며, 각 대상별로 달리 수행해야 할 작업 매트릭스를 제공합니다.

이 페이지는 AI에 의해 영어 원문에서 번역되었습니다. 불명확한 내용이 있는 경우 영어 페이지를 기준으로 삼으십시오. 이 페이지를 영어로 읽기

읽는 시간 17분

Corrán Orbital에서는 대부분의 팀보다 더 많은 곳에 배포합니다. 자사 엔지니어는 지상에서 Enterprise를 운영합니다. 위성 CORR-3은 Nexus Edge에서 미션 팩을 실행합니다. 고객 두 곳은 단일 서버에서 Community를 운영하고, 한 곳은 인터넷에 전혀 연결되지 않는 에어갭 Enterprise 설치 환경을 운영하며, 보험사를 위해서는 해당 고객의 자체 설치 환경에 팩을 구축했습니다. 그 밑의 코드는 대부분 동일하며, 차이점은 대부분 코드가 어디로 갈 수 있는지와 어떻게 그곳에 도달하는지에 관한 것입니다.

이 장에서는 각 대상을 차례로 살펴봅니다. 무엇을 기준으로 빌드하는지, 무엇을 건드려서는 안 되는지, 그리고 결과물이 어떻게 고객에게 전달되는지입니다. 마지막의 매트릭스에서 이를 한 페이지로 정리합니다. 2.18장 확장 모델에서는 스킬, 플러그인, 팩, 모듈의 차이를 설명합니다. 2.2장 에디션의 내부 구조에서는 에디션 자체를 설명합니다.

Community와 오픈 코어

Community는 Apache License, Version 2.0에 따른 오픈 코어입니다. 포크하여 변경 사항을 배포할 수 있습니다. 함께 제공되는 NOTICE 파일에는 무언가에 브랜드를 붙이기 전에 알아 두어야 할 한 가지가 명시되어 있습니다. 이 라이선스는 저작물의 출처를 밝히는 것 이상으로 Adverant의 이름이나 상표의 사용을 허락하지 않는다는 점입니다.

Community는 Enterprise를 확장하는 것과 같은 방식으로 확장합니다. Plugin SDK(소프트웨어 개발 키트)는 두 에디션에서 동일한 패키지이며, 전체 서비스 템플릿과 22개의 준수 게이트도 달라지지 않습니다. 이에 대해서는 2.21장 Plugin SDK에서 다룹니다. 스킬도 작동합니다. Community는 버전 및 테스트를 포함한 Skills Engine 작성 도구와 라이브러리 전체를 제공받으며, 카나리 릴리스와 2인 승인은 Enterprise에만 있습니다.

Community에서 빌드하기
Community에서 빌드하기
단일 Community 서버에서 예약 플러그인을 빌드하는 모습입니다. GitHub를 통해 Propose 단계까지 도달하고 Elevate는 제공하지 않는 액세스 패스와, Enterprise가 추가하는 기능을 나열한 오른쪽의 티저를 확인하십시오.

Community의 개발자 페이지는 동일한 골든 패스를 제공하지만, 바로 체감할 수 있는 세 가지 차이가 있습니다.

  1. 코드는 설치 환경의 자체 저장소가 아닌 GitHub에 저장됩니다. 플러그인 골든 패스는 Enterprise가 사용하는 것과 동일한 고정된 템플릿으로 GitHub 저장소와 개발 공간을 생성합니다. 화면 DV18에서 room-bookings을(를) 생성하는 모습을 볼 수 있습니다.
  2. 도메인 팩 및 플랫폼 골든 패스는 Enterprise 기능입니다. Community에서는 플러그인과 스킬, 그리고 운영 중인 환경에 대한 렌즈와 워크플로를 빌드합니다.
  3. Community 패스는 Elevate 등급 아래에서 멈춥니다. 서버가 하나뿐이므로 IDE(통합 개발 환경)에서 접근할 프로덕션이 없으며, 서버는 직접 관리합니다. IDE에서 시도하면 PASS_TIER_REQUIRED(으)로 거부됩니다.

소규모 서버의 Community 개발 공간은 사양이 소박합니다. 저희의 경우 2코어와 8 GiB 메모리였으며, 매니페스트에 선언된 것 외에는 차단되었고, 7일간 유휴 상태가 지속되자 종료되었습니다.

기여하기

Skills Engine도 Apache-2.0이며, 일반적인 방식으로 기여를 받습니다. 저장소를 포크하고, main에서 브랜치를 만들고, 테스트와 함께 변경을 수행한 다음, 풀 리퀘스트를 열기 전에 검사를 실행하십시오.

git checkout -b feature/skill-synthesis-validation
npm test
npm run lint
npm run typecheck

동작을 변경하는 기여에는 해당 변경 없이는 실패하는 테스트가 필요합니다. 이는 단순한 내부 관례가 아닙니다. SDK 자체의 테스트 규칙에 따라 모든 새 테스트는 변경 전 트리에서 실패함을 보여야 하며, 리뷰어는 그 증거를 요청합니다.

Enterprise 모듈과 라이선스 기준선

Enterprise는 Community에 라이선스 모듈을 더한 것입니다. 라이선스 모듈은 Community 서비스가 시작될 때 로드하는 별도의 아티팩트로, Enterprise 기능과 Enterprise 고객을 위해 빌드하는 모든 비공개 모듈이 오픈 코어에 연결되는 방식입니다.

이를 가능하게 하는 규칙이 라이선스 경계선입니다. 비공개 모듈은 단 하나의 패키지, 즉 서비스 공급자 인터페이스인 @adverant/nexus-spi을(를) 통해서만 Community 에디션에 접근할 수 있습니다. 이 패키지는 Apache-2.0이며, 인터페이스와 호스트 및 모듈이 서로를 검사하는 데 사용하는 타입 가드만 담고 있고 그 밖의 런타임 로직은 없습니다. 경계선을 넘는 결합은 인터페이스나 네트워크 프로토콜이어야 하며, 결코 소스 코드여서는 안 됩니다.

내보내기 항목 설명
RouteModule 라이선스 라우트 모듈: id, featureGroup, bodies 및 register(app, ctx)이며, 호스트의 앱에 라우터를 마운트합니다
SpiApp 모듈이 접근하는 호스트 HTTP 앱의 영역: use
SpiContext 호스트가 모듈에 전달하는 것: 제품 게이트 및 범위 가드, 라이선스 리더, 범위 지정 쿼리 풀, 서비스의 스키마, 업스트림 주소 및 플랫폼 클라이언트
SpiRuntime 호스트가 모듈에 전달하는 플러그인 SDK 값으로, 모듈이 SDK 런타임을 직접 임포트하지 않도록 합니다
SpiPlane 라이선스 플레인이 라우트 외에 추가하는 것으로, 제공하는 화면 읽기 등이 있습니다
ScreenModule 콘솔의 라이선스 화면 그룹: group, featureGroup, routes, screens 및 menu
GrantCheck (featureGroup) => Promise<{ entitled, code?: 'LICENCE_LOCKED' }>

HTTP 프레임워크와 콘솔의 화면 타입은 타입 매개변수이므로 인터페이스는 어느 쪽에도 종속되지 않습니다. 다음은 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(으)로 거부하고 해당 기능의 데이터가 아닌 티저를 표시합니다. 또한 모듈은 플러그인 SDK의 런타임을 임포트하지 않습니다. SDK는 경계선이 허용하지 않는 Community 패키지이기 때문입니다. 호스트가 모듈이 호출하는 SDK 값을 전달합니다. 호스트는 모듈을 로드하기 전에 SDK 런타임과 앱 자체의 라우트 키트를 담은 SpiHost을(를) Symbol.for(SPI_HOST_KEY) 아래 globalThis에 설치합니다. 이 작업은 먼저 이루어져야 합니다. 하나의 번들로 컴파일된 모듈은 전체가 한꺼번에 평가되므로, 로드되는 동안 SDK 값을 읽는 코드에 대해서는 register 호출이 너무 늦기 때문입니다. 타입의 경우 @adverant/nexus-spi/sdk/<module>이(가) SDK의 선언을 다시 내보냅니다. 이 선언은 하나의 SDK 릴리스에서 변경 없이 벤더링되고 체크섬으로 고정되므로, 모듈은 플러그인이 사용하는 것과 동일한 거부 본문과 클라이언트를 기준으로 타입 검사를 받습니다.

화면 모듈은 규칙이 하나 더 있습니다. 기능 그룹당 모듈은 하나이므로, 화면이 두 기능 그룹에 속하는 그룹은 두 개의 모듈로 배포되며, 그중 하나만 메뉴 행을 포함합니다.

라이선스 경계선 게이트가 거부하는 항목

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": []
}

다음 각 항목은 파일 및 행과 함께 발견 사항으로 보고됩니다.

  • 허용된 인터페이스나 Enterprise 패키지가 아닌 Community 범위 아래 패키지의 모든 임포트(동적 임포트 포함)
  • Community 저장소를 지정하는 모든 지정자, Go 임포트 경로 또는 종속성 URL(allowedCommunityGoModules에 나열된 Go 모듈은 제외)
  • 저장소 밖으로 벗어나는 상대 임포트
  • 저장소 외부의 file:, link:, portal: 또는 workspace: 경로이거나 Community 저장소에 대한 Git URL인 package.json 종속성
  • 저장소 외부를 가리키는 go.mod replace

문제가 없으면 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"로 향하는 두 개의 점선 화살표에는 X 표시가 되어 있으며 "licence-line gate: finding"이라는 레이블이 붙어 있습니다.
Community와 Enterprise 모듈 사이의 라이선스 경계선.

에디션 빌드

확장 기능을 두 에디션의 고객에게 모두 배포한다면 에디션마다 한 번씩 빌드하며, 각 빌드는 별도로 구성된 트리에서 이루어집니다. 트리를 구성한다는 것은 해당 에디션에 속하는 파일만 가져오는 것을 의미합니다. Adverant의 자체 내보내기는 경계 목록을 기반으로 이를 수행하며, 이 목록에서는 추적되는 모든 파일이 첫 번째 일치 우선 규칙에 따라 할당됩니다. 규칙은 기능을 지정하고 파일의 에디션은 에디션 매트릭스에서 해당 기능의 등급에 따라 정해지거나, 어느 에디션에도 포함되지 않는 파일 유형을 사유와 함께 지정합니다. 빌드 전용 파일은 Enterprise 트리에 포함되며, 표시된 경우 Community 트리에도 포함됩니다. 모듈의 마이그레이션 체인은 설치 프로그램 데이터이며 모든 에디션의 트리에 포함됩니다.

그런 다음 구성된 각 트리에서 전체 빌드를 처음부터 실행하십시오. 즉, 매번 세 가지 명령을 모두 실행해야 합니다.

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 클라우드에서만 실행됩니다. 자체 호스팅 Team은 없습니다. Team 세트는 Community에 여섯 가지 기능을 추가하며, 그중에는 통합 작업 패널, 공유 노트북, 스킬 라이브러리 관리, 환경 간 승격을 포함한 워크플로 운영이 있습니다.

빌더에게 클라우드 전용이란 한 가지를 의미합니다. Team 고객은 플러그인을 카탈로그를 통해 서명된 릴리스로 받으며, 결코 귀하의 서버에서 받지 않습니다. 외부 게시자가 빌드하는 방식대로 게시자 클러스터에서 빌드합니다.

게시자 클러스터
퍼블리셔 클러스터
Adverant 클라우드에 있는 게시자 자체의 가상 클러스터로, 샘플 데이터만 있습니다. 상단의 실시간 흐름을 따라가 보십시오. IDE는 게시자의 클러스터와 샘플 데이터에 접근하고, 서명된 릴리스는 검토를 거쳐 카탈로그로 가며, 어떤 고객으로도 이어지는 경로는 없습니다.

게시자 클러스터는 Adverant가 설정한 할당량을 가진 Adverant 클라우드의 가상 클러스터입니다. 샘플 데이터만 보유하며 어떤 고객으로도 연결되는 경로가 없습니다. 그곳에서 고객 데이터의 마스킹된 사본을 요청하면 TENANT_BOUNDARY(으)로 거부됩니다. 고객은 테스트 결과를 공유할 수는 있지만 데이터는 결코 공유할 수 없습니다. 클러스터에 대한 패스는 결코 고객 환경에 접근하지 않습니다. 릴리스가 준비되면 서명되고 Adverant의 검토를 거친 후 카탈로그에 등록됩니다. 그런 다음 각 고객은 설치 여부를 선택하고, 매니페스트에 선언된 항목만 단위별로 부여합니다. 매니페스트에 선언되지 않은 항목에 대한 호출은 고객 측에서 CONNECTION_SCOPE_EXCEEDED(으)로 거부되며, 이를 추가하는 유일한 방법은 고객이 검토하는 새 릴리스입니다.

에어갭 환경의 고객

저희 고객 중 한 곳은 네트워크를 통해 아무것도 드나들지 않는 환경에서 Nexus를 운영합니다. 해당 설치 환경은 2.10장 에어갭 설치에 설명되어 있습니다. 저희에게는 플러그인을 서명된 매체로 배포해야 한다는 의미였으며, 이를 위한 도구는 소버린 딜리버리 키트 @adverant/nexus-sovereign의 nexus-airgap입니다.

봉인된 번들은 서명된 자체 완결형 tarball 하나입니다. 이미지와 마이그레이션, 사전 서명된 스킬과 모델 가중치, 그리고 내부 모든 항목의 라이선스가 담긴 SBOM(소프트웨어 자재 명세서)을 포함할 수 있습니다. 매니페스트는 모든 파일을 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(인공지능) Provider Router를 통해 제공합니다.
  3. 검증 후 운영자는 연결된 고객과 똑같이 설치 환경 자체의 릴리스 채널을 통해 릴리스를 도입합니다. 번들은 바이트가 도착하는 방법일 뿐, 승격 게이트를 우회하는 방법이 아닙니다.

에어갭 작업은 더 느리며, 저희 쪽에서 이를 해결할 방법은 없습니다. 바이트 하나가 틀리면 새 매체 세트와 또 한 번의 이동이 필요하므로, 번들이 건물을 떠나기 전에 깨끗한 컴퓨터에서 동일한 명령으로 직접 검증합니다.

Nexus Edge 미션 팩

Nexus Edge는 위성과 드론에서, 비행 컴퓨터와 분리된 임무 컴퓨터에서 실행되는 소형 Nexus입니다. 플랫폼 또는 기체군 단위로 라이선스가 부여되는 애드온입니다. 임무마다 달라지는 것은 미션 팩이며, 이를 구축하는 것이 제 업무의 상당 부분을 차지합니다.

미션 팩에는 하나의 임무에 페이로드가 필요로 하는 것이 담겨 있습니다. 모델과 어댑터 외에도 초기 그래프를 포함한 온톨로지, 에이전트 단계, 경보 규칙, 무엇을 먼저 다운링크할지에 대한 우선순위, 어떤 컴퓨터가 무엇을 실행하는지 지정하는 배치 테이블, 컴퓨터에 장애가 발생했을 때 플랫폼이 전환할 수 있는 성능 저하 단계, 그리고 탑재 상태에서 통과해야 하는 테스트 케이스가 포함됩니다.

미션 팩 구축
미션 팩 구축
Maritime watch 1.4를 기반으로 1.5를 구축하는 화면입니다. 탑재 테스트 케이스(48개, 모두 통과해야 함)와 배치 테이블을 확인하십시오. 배치 테이블은 각 성능 저하 단계에서 두 개의 GPU(그래픽 처리 장치) 보드와 CPU(중앙 처리 장치) 보드에서 각각 무엇이 실행되는지를 나타냅니다.

팩은 지상에서 구축되고 서명됩니다. 저희 빌드 경험에서 얻은 몇 가지 실무 규칙은 다음과 같습니다.

  • 큰 구성 요소는 변경하지 마십시오. Maritime watch 1.5에서는 선박 탐지 어댑터 하나와 경보 규칙 두 개가 추가되었고, 언어 모델과 온톨로지는 변경되지 않았기 때문에 팩 크기가 9.8 GB가 아닌 412 MB였습니다. 업링크는 대역폭이 좁으며, 기본 모델은 발사 전에 로드됩니다.
  • 지상과 페이로드 모두에서 임무 계열 전체에 하나의 임베딩 모델을 사용하십시오. 그래야 다운링크된 그래프 변경 사항을 지상 그래프와 병합할 수 있습니다.
  • 페이로드는 비행 시스템에 명령을 보내지 않습니다. 감독 프로세스를 통해 비행 컴퓨터에 유형이 지정된 요청을 보내며, 비행 컴퓨터는 각 요청에 사유와 함께 응답합니다.
  • 모든 하드웨어 유형마다 팩에 대한 별도의 검증이 필요합니다. 장치의 하드웨어에 대해 검증되지 않은 팩을 설치하려 하면 PACK_NOT_CHECKED_FOR_HARDWARE 오류와 함께 거부됩니다.
팩 서명 및 전송
팩 서명 및 전송
Maritime watch 1.5를 CORR-3에 릴리스하는 화면입니다. 세 개 중 두 개의 서명이 필요하므로 키 하나가 도난당하더라도 팩을 릴리스할 수 없으며, 계획에는 팩이 탑재 상태에서 48개 테스트를 통과한 후에만 활성화되는 것으로 표시됩니다.

릴리스에는 세 개 중 두 개의 서명이 필요합니다. 일반적으로 저희 서명과 Adverant의 서명을 사용하며, 세 번째는 나머지 둘 중 하나를 분실한 경우에 대비해 금고에 보관하는 오프라인 키입니다. 팩은 유휴 슬롯으로 업로드되어 검증된 후 실제 보드에서 테스트 케이스를 실행하며, 모두 통과한 경우에만 활성화됩니다. 또한 카운터를 통해 이전 팩이 다시 설치되는 것을 방지합니다. 테스트가 실패하면 플랫폼은 이전 팩을 계속 사용하고, 실패 내용은 다음 통과 시 다운링크됩니다. 저희는 한 번에 하나의 플랫폼씩, 각각 일주일간 문제가 없는 것을 확인한 후 배포합니다. 팩은 플랫폼이 통신 두절 상태인 동안에도 유효하므로, 링크가 없는 위성도 보유한 팩으로 계속 작동합니다.

차량과 선박에서는 Edge를 k3s에서 실행할 수 있습니다. 우주선에서는 Kubernetes 대신 서명된 이미지 또는 정적 바이너리와 고정된 배치 테이블을 사용하는 감독 프로세스를 실행하며, 이 때문에 배치 테이블이 팩 안에 포함되어 전송됩니다.

화이트라벨 스토어프론트

Storefront / 화이트 라벨 애드온을 사용하면 고객은 자사 사용자에게 표시되는 화면에 자사 브랜드와 도메인을 적용하고, 자체 로그인 화면을 사용하며, 자체 게이트웨이를 통해 결제를 받을 수 있습니다. 카드 정보는 Nexus를 거치지 않습니다.

화이트 라벨 고객을 위해 구축한 플러그인에는 Adverant가 절대 표시되어서는 안 됩니다. 브랜드 관련 정보는 모두 매니페스트에 포함되며, 나머지는 코드에 하드코딩된 값이 아니라 조직 자체의 브랜드에서 플랫폼이 확인합니다.

{
  "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은(는) 이와 일치해야 합니다. 패스키는 사용자가 로그인하는 도메인에 바인딩되기 때문입니다. 자체 오리진에서 실행되는 웹 앱은 SDK의 로그인 헬퍼를 통해 사용자를 로그인시키며, 이 헬퍼의 두 공개 경로는 범위 게이트가 허용하는 유일한 비보호 /api 경로입니다. 단, 매니페스트에서 allowAnonymous: true와(과) 함께 auth: public(으)로 선언한 경우에만 허용됩니다. 프런트엔드 호출은 서비스 주소로 직접 보내지 않고 항상 BFF(backend for frontend) 허용 목록 프록시를 거칩니다. 게이트웨이부터 브랜드 결제 화면까지 결제 관련 설정은 고객의 관리자가 구성합니다. 플러그인에서는 구성하지 않습니다.

매트릭스

빌드 대상 빌드 기반 달리 해야 할 작업 고객에게 제공되는 방식
Community Plugin SDK, Skills Engine 코드는 GitHub에 보관, 도메인 팩 또는 플랫폼 경로 없음, Elevate 없음 고객이 직접 설치하며 카탈로그 심사 불필요
Enterprise(자체 설치 환경) Plugin SDK, Skills Engine, 팩 템플릿 개발 공간, 데이터 브랜치, 데이터 소유자와 함께하는 마스킹된 사본, 팩과 렌즈 스테이징에서 파일럿 단위로, 이후 전체로 승격
Enterprise 모듈(비공개) @adverant/nexus-spi만 해당 라이선스 경계 규칙, 자체 기능 그룹에 대한 권한 확인, 사용 권한이 없을 때 LICENCE_LOCKED 라이선스가 부여된 설치 환경에서 시작 시 Community 서비스가 로드
두 에디션 모두 Plugin SDK 각 에디션의 트리를 구성하고, 각각에서 npm ci, 테스트 및 프로덕션 빌드 실행 에디션별 릴리스 1개
Team 퍼블리셔 클러스터의 Plugin SDK 샘플 데이터만 사용, 클라우드 전용 서명된 릴리스, Adverant 심사, 카탈로그
에어갭 Plugin SDK, @adverant/nexus-sovereign 봉인된 번들, 키와 체크섬은 별도 전송, 설치 시 외부에서 가져오는 항목 없음 서명된 미디어를 검증한 후 설치 환경의 릴리스 채널로 제공
Nexus Edge 미션 팩 구성 요소 배치 테이블, 성능 저하 단계, 탑재 테스트, 하드웨어 검증 세 개 중 두 개의 서명, 유휴 슬롯, 테스트 통과 후 활성화
화이트라벨 Plugin SDK 매니페스트의 domains 및 branding, 어디에도 Adverant 이름 없음 Enterprise와 동일하되 고객 자체 도메인에서 제공

대상과 관계없이 배포는 설치 환경의 릴리스 채널을 통해서만 이루어집니다. 이러한 채널은 2.28장 '확장 기능 릴리스'에서 다룹니다. 2.27장 '빌드 시나리오'에는 위 표의 각 행에 대한 방법이 나와 있습니다.