로그인브리핑 예약

챕터 2.7

Enterprise 설치 및 라이선스 적용

Enterprise 에디션을 설치할 때 달라지는 점, Adverant 계정에서 라이선스를 요청하는 방법, 모든 거부 코드와 함께 라이선스를 가져오는 세 가지 방법, 그리고 Harrow Port Authority가 데이터 손실 없이 제자리에서 Community 파일럿을 Enterprise로 전환한 방법을 알아봅니다.

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

읽는 시간 17분

Enterprise 설치는 두 부분으로 나뉘며, 각각 다른 경로로 제공됩니다. Enterprise 이미지는 Enterprise 차트와 함께 제공되며 풀 토큰(pull token)을 사용해 가져옵니다. 라이선스는 Adverant 계정에서 서명된 파일 형태로 제공되며, 실행 중인 설치 환경으로 가져오게 됩니다. 어느 한쪽도 다른 쪽 없이는 작동하지 않습니다. 라이선스가 없는 이미지는 Community 기본 수준으로만 실행되며, Enterprise 이미지가 없는 라이선스는 활성화할 대상이 없습니다.

Harrow Port Authority에서는 Kubernetes에 Community 설치하기를 다룬 2.6장의 Community 파일럿을 진행한 지 6주 후에 이 순서대로 작업을 수행했습니다. Enterprise 차트로의 업그레이드는 한 번의 유지보수 시간 내에 완료되었고, 라이선스 가져오기는 2분이 걸렸습니다. 이 장에서는 두 가지 과정을 모두 다룹니다. 먼저 새로 설치하는 방법으로 시작하여, 기존 Community 설치 환경을 제자리에서 전환하는 방법으로 마무리합니다.

오른쪽의 "Enterprise 설치(Enterprise installation)"라고 표시된 하나의 상자로 이어지는 두 개의 평행 경로. 상단 경로: "Adverant 계정: 다운로드(Adverant account: Downloads)"가 "Enterprise 차트 및 이미지 잠금(Enterprise chart and its images lock)"으로 이어지고, 이어서 "모든 노드의 풀 토큰(pull token on every node)"이라는 보조 상자가 결합된 "helm install 또는 helm upgrade, edition: enterprise"로 이어집니다. 하단 경로: "Adverant 계정: 배포(Adverant account: Deployments)"가 "서명된 라이선스 파일(signed licence file)"로 이어지고, 이어서 "실행 중인 설치 환경으로 가져오기(import into the running installation)"로 이어집니다. 두 경로는 오른쪽 상자에서 만납니다. 그 아래의 캡션 줄에는 "라이선스가 없는 이미지는 Community 기본 수준으로 실행됩니다(images without a licence run at the Community floor)"라고 적혀 있습니다.
Enterprise 설치의 두 부분과 각각의 제공 경로.

Community와 다른 점

두 개의 값과 이를 읽어 들이는 차트.

# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
  enabled: true

값 파일의 나머지 모든 항목, 무엇보다도 설치 이름과 키 관리자는 기존 그대로 유지됩니다. 두 키는 반드시 일치해야 하며, 차트는 edition: enterprise 및 enterprise.enabled: false 조합이나 그 반대의 조합을 거부합니다.

또한 에디션은 차트의 이미지 잠금(images lock) 파일과도 일치해야 합니다. 각 차트 패키지에는 하나의 에디션에 대한 잠금 파일이 포함되어 있으며, Enterprise 잠금 파일에는 Community 이미지와 더불어 Enterprise 빌드가 나열되어 있습니다. Enterprise 값 파일을 Community 차트에 지정하면 렌더링이 files/images.lock.json is the community lock; this install is edition enterprise 오류와 함께 중단됩니다. 따라서 Enterprise를 설치하려면 Enterprise 차트가 필요합니다.

Enterprise 차트와 번들은 라이선스가 연동된 Adverant 계정의 다운로드(Downloads) 페이지에 있습니다. 차트 파일의 이름은 Community 차트와 동일한 nexus-1.0.0-alpha.1.tgz이므로 두 파일을 서로 다른 폴더에 보관하십시오. 릴리스 확보 및 검증을 다루는 2.4장에 설명된 것과 정확히 동일한 방법으로, 지문을 확인해 둔 릴리스 키에 대조하여 파일을 검증하십시오:

nexusctl verify enterprise/nexus-1.0.0-alpha.1.tgz
tar -xzf enterprise/nexus-1.0.0-alpha.1.tgz -C enterprise
jq -r '.version, .edition' enterprise/nexus/files/images.lock.json
1.0.0-alpha.1
enterprise

그런 다음 enterprise/nexus/files/images.lock.json에 대해 릴리스 확보 및 검증을 다루는 2.4장의 서명 확인 루프를 실행하십시오. 이 작업은 공용 이미지뿐만 아니라 Enterprise 이미지도 모두 검증합니다.

풀 토큰

Community 이미지는 공개되어 있습니다. 반면 Enterprise 이미지는 계정의 풀 토큰 및 설치 명령(Pull tokens and install commands) 페이지에서 발급받은 풀 토큰이 필요하며, 릴리스 확보 및 검증을 다루는 2.4장의 3단계에 나와 있는 대로 노드의 컨테이너 런타임에 맞게 구성해야 합니다. k3s의 경우 모든 노드의 /etc/rancher/k3s/registries.yaml에 있는 registry.adverant.ai에 대한 configs 항목이 이에 해당합니다.

클러스터당 하나의 토큰을 생성하고 알아보기 쉬운 만료일을 지정하십시오. 토큰이 만료되더라도 실행 중인 파드는 계속 작동하지만, 아직 이미지가 없는 노드로 재스케줄링된 파드는 이미지를 가져올 수 없게 됩니다. 당사는 토큰의 만료일을 인증서 만료일과 동일한 일정표에 등록해 두었습니다.

Enterprise 신규 설치

처음부터 Enterprise를 설치하는 경우, Kubernetes에 Community 설치하기를 다루는 2.6장을 단계별로 따르되 다음 세 가지 차이점에 유의하십시오:

  1. 6단계를 진행하기 전에 모든 노드에 풀 토큰을 배치하십시오.

  2. 4단계에서 Enterprise 값(위의 두 가지 키)을 사용하십시오.

  3. 6단계에서 다운로드한 Enterprise 차트 파일로 설치를 진행하십시오:

    helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \
      --namespace nexus -f harrow-values.yaml --timeout 45m

설치 명령 이후의 모든 과정은 Kubernetes에 Community 설치하기를 다루는 2.6장과 동일하며, --wait에 대한 규칙 역시 마찬가지로 사용하지 않아야 합니다. 대신 nexusctl 명령으로 설치하는 경우 명령에 --edition enterprise 옵션을 추가하십시오:

nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterprise

모든 워크로드가 준비되면 첫 실행을 다루는 2.12장의 첫 실행 과정을 진행하십시오. 라이선스는 사용자가 로그인하기 전에 콘솔에 나열되는 6가지 항목 중 하나입니다. 라이선스를 가져오기 전까지 설치 환경은 Community 기본 수준으로 실행되며, 모든 Enterprise 영역은 회색으로 비활성화되어 자물쇠 아이콘과 함께 표시됩니다.

라이선스 요청

Adverant의 라이선스는 설치 시 키 저장소가 keys.installationName 아래에 생성한 단일 설치 환경의 ID에 맞춰 발급됩니다. 따라서 계정에서 라이선스를 발급하려면 먼저 대상이 어느 설치 환경인지 알아야 합니다.

  1. https://account.adverant.ai에서 Adverant 계정에 로그인합니다.
  2. 설치 환경에서 이 설치(This installation)를 연 다음 라이선스(Licence)를 엽니다. 화면에 일회용 코드와 설치 환경의 지문이 표시됩니다.
  3. 계정에서 배포 등록(Claim a deployment)을 열고 코드를 입력합니다. 그런 다음 계정이 수신한 지문과 설치 환경에 표시된 지문을 그룹별로 비교합니다. 모든 그룹이 일치해야 합니다.
  4. 등록(claim) 버튼을 누릅니다. 설치 환경이 버전 및 라이선스 상태와 함께 계정의 배포(Deployments) 목록에 추가됩니다.
  5. Adverant가 해당 설치 환경에 대한 라이선스를 발급합니다. 계정에서 파일을 다운로드하십시오. 파일 이름은 라이선스 ID를 따서 <licence-id>.json 형태로 지정됩니다.

등록 코드는 짧은 시간 동안 한 번만 작동합니다. 시간이 만료되면 계정은 CLAIM_CODE_EXPIRED 오류와 함께 코드를 거부하며, 설치 환경에는 새로운 코드가 표시됩니다.

배포 등록(Claim a deployment)
배포 등록(Claim a deployment)
Adverant 계정에서 배포 등록하기. 일회용 코드를 먼저 입력한 후 4자리 그룹 단위로 지문을 비교하므로, 설치 환경의 화면을 직접 보고 있지 않은 사람은 등록할 수 없습니다.

이 외에도 두 가지 경로가 더 존재하며, 라이선스를 다루는 2.13장에서 두 가지 모두를 자세히 설명합니다. 어플라이언스와 엣지 키트에는 코드를 표시할 화면이 없으므로, 상자에 인쇄된 등록 키를 등록 키 입력(Enter a claim key) 화면에 직접 입력하거나 제조업체의 주문 파일에서 읽어 들여서 등록합니다. 외부로 나가는 네트워크 경로가 없는 설치 환경은 오프라인 교환(Offline exchange)을 사용합니다. 설치 환경이 서명된 라이선스 요청 파일을 생성하면 사용자가 이를 계정으로 가져가고, 발급된 라이선스 파일을 다시 설치 환경으로 가져오는 방식입니다. 또한 1년에 한 번 동일한 방식으로 서명된 사용량 내역서를 생성합니다. 교환되는 모든 파일에는 서명이 되어 있으므로 이동 중에 변경된 파일은 거부되며, 요청 파일의 경우 LICENCE_REQUEST_SIGNATURE_INVALID, 사용량 파일의 경우 USAGE_FILE_SIGNATURE_INVALID 오류가 발생합니다.

오프라인 교환(Offline exchange)
오프라인 교환(Offline exchange)
Adverant 계정의 오프라인 교환. 서명된 파일은 양방향 모두 수동으로 전달되며, 이동 중에 변경된 파일은 해당 오류 코드와 함께 거부됩니다.

라이선스 파일에 담긴 내용

라이선스는 nexus-licence/v1 형식의 JSON 문서로, Adverant가 두 개의 독립적인 키를 사용해 이중으로 서명합니다. 이 문서를 직접 읽을 필요는 없지만, 누군가 구매 내역을 물어볼 때를 대비해 그 안에 무엇이 들어 있는지 알아 두면 도움이 됩니다.

필드 설명
licence_id 라이선스 고유의 ID로, 소문자 UUID(범용 고유 식별자)입니다
type alpha, evaluation 또는 commercial
licensee 조직 이름 및 Adverant 고객 ID
scope 라이선스 대상 설치 환경 및 권한 부여에 지정된 조직
edition enterprise
grants 잠금 해제되는 기능 그룹(각각 전체 설치 환경 또는 지정된 조직에 적용됨)
add_ons 및 domain_packs 별도로 라이선스가 부여되는 기능(예: 물류 및 해운 팩)
metric 라이선스 산정 방식(named-seat, per-core 또는 per-environment) 및 수량
term starts_on, ends_on, 그리고 사전 경고 일수 및 유예 일수
matrix 라이선스 작성 시 기준이 된 에디션 매트릭스의 버전
signatures Adverant의 두 가지 서명

평가판 라이선스는 최대 5명의 지정된 사용자를 대상으로 최대 30일간 지속되며 유예 기간은 없습니다. 상용 라이선스는 기본적으로 만료 30일 전에 경고를 표시한 후 30일의 유예 기간을 제공합니다. 이 단계별 절차의 각 과정에서 일어나는 일은 라이선스를 다루는 2.13장에 설명되어 있습니다.

서명은 Adverant가 생성한 상태 그대로의 문서를 보증합니다. 받은 그대로 전달해야 하며, 문서를 자동으로 정리할 가능성이 있는 편집기에서 열지 마십시오.

라이선스 가져오기

라이선스는 설치 관리자(설치 환경을 소유한 전체 조직의 소유자 또는 관리자로서 해당 환경에 로그인한 사용자)만 가져올 수 있습니다. 전체 플랫폼 관리자도 라이선스를 가져올 수 있습니다. 라이선스는 절대 차트 값이나 파드에 마운트되는 파일 형태로 제공되지 않습니다. 라이선스는 로그인 서비스인 nexus-auth로 전달되며, 이 서비스는 자체 이미지에 내장된 신뢰 루트(trust roots)를 기준으로 오프라인 검증을 수행한 후 단일 트랜잭션으로 기록합니다. 라이선스는 세 가지 방법으로 가져올 수 있으며, 모두 동일한 결과로 이어집니다.

콘솔에서 가져오기

첫 실행 중에 로그인 전 6가지 작업(Six things before anyone signs in)을 연 다음 라이선스(Licence)를 엽니다. 라이선스 가져오기(Import the licence) 페이지에서 파일을 페이지에 끌어다 놓거나 직접 선택하여 업로드합니다. 페이지는 설치 환경 자체에서 파일을 오프라인으로 검증한 후, 활성화되는 기능 그룹의 목록을 각 그룹의 보호 방식 및 만료 기한과 함께 표시합니다. 라이선스에 포함되지 않은 그룹은 회색으로 비활성화된 채 목록에 남습니다.

이후에는 설치 환경의 라이선스 페이지에 있는 새 라이선스 가져오기(Import a new licence) 버튼을 통해 동일한 가져오기 작업을 수행합니다. 라이선스가 만료된 경우에는 제한된 라이선스 페이지에서 갱신된 라이선스 가져오기(Import a renewed licence) 버튼을 제공합니다.

라이선스 가져오기(Import the licence)
라이선스 가져오기(Import the licence)
콘솔에서 라이선스 가져오기. 파일은 설치 환경 자체에서 검증됩니다. 페이지에는 잠금 해제되는 항목이 기능 그룹별로 나열되며, 서명 검증에 실패한 파일은 해당 오류 코드와 함께 없는 것으로 처리됩니다.

nexusctl로 가져오기

nexusctl licence import <licence-id>.json

nexusctl 명령은 설치 관리자 권한으로 변경되지 않은 원본 파일을 설치 환경의 가져오기 경로로 전송하고, 라이선스 상태나 아래 표에 나와 있는 거부 코드를 보고합니다.

API를 통해 가져오기

가져오기 경로는 hosts.auth 주소에 있는 로그인 서비스의 애플리케이션 프로그래밍 인터페이스(API)의 일부입니다. 본문은 바이트 단위로 정확히 일치하는 라이선스 문서입니다:

curl -sS -X POST https://auth.harrow.example/api/v1/installation/licence \
  -H "authorization: Bearer <admin-token>" \
  -H "content-type: application/json" \
  --data-binary @<licence-id>.json

<admin-token>은 로그인한 설치 관리자의 액세스 토큰입니다. 줄 바꿈을 제거하여 전송 바이트를 변경하는 -d은 절대 사용하지 말고, 반드시 --data-binary을 사용하십시오. 이 경로는 쿼리 문자열을 받지 않으며 본문에는 오직 문서만 포함되어야 합니다. 최상위 수준에서 조직이나 사용자를 지정하려고 시도하는 본문은 내용을 읽기도 전에 거부됩니다.

가져오기가 성공하면 201 Created을 응답합니다. 요약된 본문은 다음과 같습니다:

{
  "licence": {
    "licence_id": "<licence-id>",
    "state": "licensed",
    "edition": "enterprise",
    "licensee": {"name": "Harrow Port Authority", "customer_id": "<customer-id>"},
    "term": {"starts_on": "2026-12-01", "ends_on": "2027-11-30", "warn_days": 30, "grace_days": 30},
    "groups": ["enterprise-base", "..."]
  },
  "organizations": 1,
  "tenants_without_organisation": 0
}

organizations은 현재 설치 환경에서 라이선스를 보유하게 된 조직의 수를 나타냅니다. tenants_without_organisation는 라이선스에 명시되어 있으나 이 설치 환경에는 존재하지 않는 조직의 수를 나타냅니다.

가져오기가 거부되는 경우

거부된 가져오기는 아무것도 변경하지 않습니다. 어떠한 행도 기록되지 않으며, 기존에 적용 중인 라이선스가 있다면 그대로 유지됩니다. 설치 환경의 감사 로그는 거부된 시도를 포함하여 모든 시도를 기록합니다.

코드 상태 의미 조치 방법
LICENCE_SIGNATURE_INVALID 422 Adverant의 두 서명 중 하나가 누락되었거나 검증되지 않음. 서명 후 파일이 변경되었음 Adverant에 파일을 다시 요청하고, 파일을 편집하지 마십시오
LICENCE_FORMAT_INVALID 422 파일이 현재 릴리스에서 읽을 수 있는 라이선스가 아님 Adverant가 제공한 상태 그대로 파일을 전송하십시오
LICENCE_ROOT_UNKNOWN 422 이 설치 환경이 신뢰하지 않는 키로 서명되었음 현재 릴리스의 신뢰 루트에 맞게 서명된 라이선스를 요청하거나 업그레이드하십시오
LICENCE_MATRIX_MISMATCH 422 현재 릴리스가 읽지 못하는 에디션 매트릭스를 기준으로 작성되었거나, 현재 릴리스가 알지 못하는 그룹의 권한을 부여함 업그레이드하거나, 현재 릴리스를 기준으로 작성된 라이선스를 요청하십시오
LICENCE_OTHER_INSTALLATION 409 다른 설치 환경을 위해 발급된 라이선스임 현재 설치 환경의 ID에 맞춰 발급된 라이선스를 요청하십시오
TRANSITION_NOT_PERMITTED 409 이 ID를 가진 라이선스를 이미 가져왔음. 각 라이선스는 한 번만 가져올 수 있음 조건을 변경해야 하는 경우 Adverant에 새 라이선스를 요청하십시오
LICENCE_REVOKED 403 Adverant가 이 라이선스를 철회했음 Adverant에 새 라이선스를 요청하십시오
LICENCE_LOCKED 403 라이선스 기간이 아직 시작되지 않았음. 시작 전까지는 Community 기본 수준이 적용됨 시작일 당일이나 그 이후에 다시 가져오십시오
RECORD_NOT_FOUND 404 설치 환경이 아직 선언되지 않아 대조할 ID가 없음 첫 번째 관리자 단계(첫 실행을 다루는 2.12장)를 완료한 후 가져오십시오
VALIDATION_FAILED 400 본문을 읽을 수 없거나 1 MiB를 초과함, 또는 쿼리 문자열이 전송되었음 쿼리 없이 파일 전체를 본문으로 전송하십시오

가져오기 성공 시 거부가 아닌 알림으로서 하나의 코드가 더 반환될 수 있습니다. LICENCE_CLOCK_BEHIND_FLOOR은 설치 환경의 시계가 이미 확인된 가장 최근 시간보다 이전 시간을 가리키고 있어, 라이선스가 그 나중 시간을 기준으로 읽혔음을 의미합니다. 시계를 뒤로 돌린다고 해서 만료된 라이선스가 되살아나지는 않습니다. 오직 Adverant가 해당 설치 환경을 위해 서명한 시간 재설정 토큰만이 기준 시간을 낮출 수 있습니다.

제자리에서 Community를 Enterprise로 전환

이것이 당사가 Harrow에서 수행한 작업입니다. 아무것도 재설치하거나 마이그레이션하지 않습니다. 동일한 ID와 동일한 데이터를 가진 같은 설치 환경에서 더 많은 기능을 활성화하는 것뿐입니다. 설치 이름과 키 관리자는 기존 그대로 유지됩니다. 업그레이드 시 키 관리 훅(custody hook)은 키 저장소가 이미 초기화되었는지만 확인하고 다른 작업은 수행하지 않습니다.

  1. 모든 노드에 풀 토큰을 배치하고 해당 노드의 컨테이너 런타임을 재시작합니다.

  2. 다운로드(Downloads)에서 Enterprise 차트를 가져와 위에서 설명한 대로 차트와 이미지를 검증합니다.

  3. 기존 값 파일에서 edition: enterprise 및 enterprise.enabled: true 두 가지 값을 변경합니다. 다른 것은 아무것도 변경하지 마십시오.

  4. 새 파일로 사전 검사(preflight)를 실행합니다.

    nexusctl preflight --context harrow-prod --values harrow-values.yaml
  5. 이번에도 --wait 없이 릴리스를 Enterprise 차트로 업그레이드합니다.

    helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \
      --namespace nexus -f harrow-values.yaml --timeout 45m

    업그레이드 시에는 새 파드가 롤아웃되기 전에 훅이 실행되며, 각 마이그레이션은 이전에 적용하지 않은 파일만 적용합니다. 생성된 시크릿은 설치 환경에서 다시 읽어 들여 그대로 유지합니다. Helm은 다음 메시지와 함께 종료됩니다:

    NAME: nexus
    NAMESPACE: nexus
    STATUS: deployed
    REVISION: 2
  6. Kubernetes에 Community 설치하기를 다루는 2.6장의 7단계와 정확히 동일하게 워크로드가 준비될 때까지 기다립니다.

    kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
  7. 위의 세 가지 방법 중 하나를 사용하여 라이선스를 가져옵니다.

  8. 콘솔에서 이 설치(This installation), 라이선스(Licence), Enterprise로 전환(Move to Enterprise)을 차례로 엽니다. 페이지는 실제 작업이 일어나기 전에 라이선스를 읽고 가져올 항목과 변경될 사항을 보여 줍니다. 또한 조직의 사용자와 콘텐츠 수를 계산하고 각각을 유지됨(kept)으로 표시합니다. 가져오기 및 활성화(Fetch and switch on)를 누릅니다. 각 부분은 사용되기 전에 Adverant의 릴리스 키와 대조하여 검증되며, 기능 그룹이 하나씩 차례로 활성화됩니다.

당사의 유지보수 시간은 1시간이었으나 실제 작업은 약 20분이 걸렸으며, 그중 대부분은 훅이 실행되는 동안의 스키마 대기 시간이었습니다. 파일럿 참여자들은 다음 날 아침 동일한 워크스페이스에 로그인했고, 메뉴의 Enterprise 영역은 더 이상 회색으로 비활성화되어 있지 않았습니다.

Community에서 Enterprise로
Community에서 Enterprise로
Community 설치 환경을 Enterprise로 전환하기. 페이지는 라이선스가 진짜인지 확인하고 항목을 가져오기 전에 가져올 목록을 보여 주며, 조직의 사용자와 파일은 유지됨으로 표시됩니다.

가져오기 이후

이 설치(This installation) 아래의 라이선스 페이지는 라이선스에 포함된 모든 기능 그룹을 좌석 수 및 기간과 함께 나열합니다. 또한 Enterprise 그룹의 경우 컴파일 및 라이선스 부여 방식, Community 기본 수준의 경우 오픈 소스 방식 등 각 부분이 어떻게 제공되는지도 표시합니다. 라이선스 범위를 벗어난 그룹은 회색으로 비활성화된 채 목록에 남습니다. 관리자는 그룹이 조직 내에서 도달하는 범위를 좁힐 수는 있지만, 라이선스가 부여하는 권한을 넓힐 수 있는 것은 오직 Adverant뿐입니다.

라이선스 상태는 읽을 때마다 문서와 날짜를 기준으로 다시 계산되므로 예약된 작업 없이도 만료가 처리됩니다. 만료일이 다가오면 설치 환경의 모든 사용자에게 콘솔에서 동일한 알림이 표시됩니다. 만료 30일 전부터는 LICENCE_ENDS_SOON이 표시되고, 유예 기간 동안에는 LICENCE_IN_GRACE가 표시됩니다. 일반 구성원에게는 알림과 날짜만 보이며, 라이선스 자체는 설치 관리자에게만 보입니다. 갱신 및 만료 단계별 절차는 라이선스를 다루는 2.13장에서 설명합니다.

라이선스 및 잠금 해제 항목
라이선스 및 잠금 해제 항목
Enterprise 설치 환경의 라이선스 페이지입니다. 상단의 수치는 좌석 수와 기간을 나타내며, 그 아래에는 모든 기능 그룹이 각각의 보호 방식과 함께 나열되고 라이선스 범위를 벗어난 그룹은 회색으로 유지됩니다.

실패하는 경우

표시되는 내용 원인 조치 방법
edition=enterprise but enterprise.enabled=false: they must agree 두 키 중 하나만 변경되었음 두 키를 모두 변경하십시오
files/images.lock.json is the community lock; this install is edition enterprise Community 차트가 사용되었음 다운로드(Downloads)에서 받은 Enterprise 차트를 사용하십시오
image ... is a enterprise image; a community install takes only community images Enterprise 이미지 이름이 Community 렌더링에 도달했음 edition 및 차트 폴더를 확인하십시오
업그레이드 후 Enterprise 이미지에서 ImagePullBackOff 발생 노드에 풀 토큰이 없거나 토큰이 더 이상 유효하지 않음 해당 노드에서 registries.yaml을 확인하거나 새 토큰을 생성하십시오
라이선스 거부 코드 위의 거부 표를 참조하십시오 해당 행의 지침을 따르십시오. 변경된 사항은 없습니다

라이선스 페이지에 Enterprise와 예상했던 그룹들이 표시되면 설치 환경에 라이선스가 부여된 것입니다. 아직 설치 환경을 등록하지 않았다면 다음 단계는 첫 실행을 다루는 2.12장의 첫 실행 과정입니다. 이미 등록했다면 어시스턴트가 사용자에게 답변하기 전에 조직 자체의 인공지능(AI) 모델 키가 필요합니다. AI 공급자 및 모델을 다루는 2.14장에서 이를 연결하는 방법을 설명합니다.