로그인브리핑 예약

챕터 2.6

Kubernetes에 Community 설치하기

cert-manager부터 모든 워크로드가 준비될 때까지 Helm을 이용해 Community 에디션을 순서대로 설치하는 방법과 함께, 키별로 설명된 values 파일, --wait를 사용하지 않는 이유, 차트 훅(Hook)이 실행되는 순서, 그리고 대안으로서의 nexusctl 설치 경로를 설명합니다.

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

읽는 시간 18분

설치 자체는 단 하나의 helm install입니다. 그 주변의 모든 과정은 이 명령어가 첫 시도에 작동하도록 하기 위해 존재합니다. 즉, 사전의 cert-manager 설치, 한 줄씩 꼼꼼히 확인한 values 파일, 그리고 무엇을 기다려야 할지 아는 사후 대기 과정입니다. Harrow Port Authority에서는 6주간의 파일럿을 위해 계획 워크시트에 있는 3노드 k3s 클러스터에 Community 에디션을 먼저 설치했습니다. 릴리스는 약 20분 만에 실행되었으며, 우리가 소유권을 등록할 때까지 아무도 로그인할 수 없었는데, 이는 정상적인 동작입니다.

이 장에서는 여러분이 이미 세 가지 작업을 완료했다고 가정합니다. 즉, 계획 워크시트 작성(2.3장, 설치 계획하기), 릴리스 다운로드 및 확인(2.4장, 릴리스 가져오기 및 검증하기), 그리고 사전 점검 실행(2.5장, nexusctl을 이용한 사전 점검)입니다. 이 중 하나라도 아직 완료되지 않았다면 이전 단계로 돌아가십시오. 설치 과정은 대부분의 실수를 명시적으로 거부하지만, 이미 키를 분실한 관리인(custodian)과 같은 몇 가지 문제는 감지할 수 없습니다.

1단계: 도구 및 컨텍스트 확인하기

  1. Helm이 버전 4인지 확인하십시오.

    helm version

    설치 과정은 기본적으로 차트의 훅(hook) Job들을 기다리는 Helm 4의 동작에 의존합니다. 여기서는 v4.3.1을 사용했습니다.

  2. 워크시트에 있는 클러스터를 가리키도록 kubectl을 설정하고 이를 확인합니다.

    kubectl config use-context harrow-prod
    kubectl get nodes

    모든 노드가 Ready 상태여야 합니다. 사전 점검에서 이미 이를 확인했지만, 사전 점검과 설치 사이에 노드가 이탈할 수 있으므로 여기서 확인하는 것이 더 빠릅니다.

2단계: cert-manager 먼저 설치하기

차트는 cert-manager를 사용하여 자체 로컬 인증 기관(CA)을 생성하며, 모든 서비스는 자체 서명된 Issuer, 10년 만기 로컬 CA 인증서, 그리고 서비스용 단기 인증서 등 이 기관이 발급한 인증서를 통해 서로 통신합니다. 따라서 Nexus를 설치하기 전에 cert-manager가 실행 중이어야 합니다. 이 릴리스에는 v1.21.3이 필요하며, trust-manager는 필요하지 않습니다.

  1. 커스텀 리소스를 포함하여 cert-manager의 자체 차트에서 cert-manager를 설치합니다:

    helm install cert-manager <cert-manager-chart> -n cert-manager --create-namespace \
      --set crds.enabled=true --wait --timeout 10m

    <cert-manager-chart>은 cert-manager 프로젝트의 자체 릴리스에서 제공하는 cert-manager v1.21.3 차트입니다. 여기서는 대기 옵션을 사용하는 것이 맞습니다. 이는 다른 어떤 것에도 의존하는 훅이 없는 cert-manager 자체 설치이기 때문입니다.

  2. 모든 인증서 요청이 거치게 되는 웹훅(webhook)을 기다립니다:

    kubectl -n cert-manager rollout status deploy/cert-manager-webhook --timeout=300s
    deployment "cert-manager-webhook" successfully rolled out

3단계: 네임스페이스와 TLS Secret 생성하기

tls.mode: existing을 사용하는 경우, 차트는 설치 전에 네임스페이스 내에 인증서가 Kubernetes Secret으로 존재할 것으로 기대합니다. 세 가지 주소 모두에 대한 전송 계층 보안(TLS)이 이 단일 Secret에서 제공되므로, 해당 인증서에는 세 호스트의 이름이 모두 포함되어야 합니다.

kubectl create namespace nexus
kubectl -n nexus create secret tls harrow-public-tls \
  --cert=harrow-public.crt --key=harrow-public.key

harrow-public.crt은 체인을 포함한 인증서이고, harrow-public.key는 개인 키입니다. 2.3장, 설치 계획하기에서 tls.mode: cert-manager 또는 none를 선택한 경우 Secret 생성을 건너뛰십시오. 지금 네임스페이스를 생성하거나, 6단계에서 --create-namespace를 사용하여 Helm이 생성하도록 할 수 있습니다.

4단계: values 파일 작성하기

다음은 파일럿을 위한 Harrow의 values 파일입니다. 이 파일의 모든 키는 차트의 스키마가 허용하는 키입니다. 스키마는 그 외의 키를 모두 거부하므로, 철자가 틀린 키가 있으면 조용히 무시되는 대신 설치가 실패합니다.

# harrow-values.yaml (Helm values, Community)
global:
  imageRegistry: registry.adverant.ai
  domain: harrow.example
hosts:
  console: console.harrow.example
  api: api.harrow.example
  auth: auth.harrow.example
edition: community
enterprise:
  enabled: false
tls:
  mode: existing
  existingSecret: harrow-public-tls
ingress:
  className: traefik
storage:
  className: local-path
networkPolicy:
  ingressNamespace: kube-system
  externalEgressCIDRs: ["10.20.9.25/32"]
keys:
  installationName: harrow-port-authority
  custody:
    recipients:
      - "<recipient-aoife>"
      - "<recipient-tomas>"
      - "<recipient-safe-laptop>"

각 <recipient-...>은 관리인 한 명의 공개 age 수신자(recipient)로, 관리인이 여러분에게 보낸 age1... 또는 age1se1... 줄입니다. 우리가 설정한 모든 키와 그 이유는 다음과 같습니다.

global.imageRegistry은 노드가 이미지를 풀(pull)하는 레지스트리입니다. 차트에는 기본값이 없으며, 모든 이미지를 <this>/nexus/<service>@<digest> 형태로 빌드합니다. 인터넷에 연결된 설치의 경우 registry.adverant.ai입니다. 이미지를 자체 레지스트리에 복사한 경우 해당 호스트입니다.

global.domain은 세 가지 주소가 속하는 상위 도메인입니다.

hosts.console, hosts.api 및 hosts.auth은 설치 환경의 ID로, 사용자와 프로그램이 사용하는 세 가지 이름입니다. 각 이름은 도메인 네임 시스템(DNS)에서 이미 확인(resolve)되어야 하며, 이는 사전 점검에서 확인했습니다.

edition과 enterprise.enabled는 서로 일치해야 합니다. 즉, community과 false, 또는 enterprise와 true의 조합이어야 합니다. 차트는 그 외의 모든 조합을 거부하며, 이미지 잠금(lock) 파일과 맞지 않는 에디션도 거부합니다.

tls.mode과 tls.existingSecret는 퍼블릭 엣지가 인증서를 가져오는 방식을 선택합니다. cert-manager을 사용하는 경우 대신 tls.clusterIssuer를 설정하며, none를 사용하는 경우 둘 다 설정하지 않습니다.

ingress.className은 인그레스(ingress) 클래스를 지정합니다. 클러스터의 기본 클래스를 사용하려면 설정하지 않은 채로 두십시오.

storage.className은 모든 데이터 볼륨에 대한 스토리지 클래스를 지정합니다. 기본값을 사용하려면 설정하지 않은 채로 두십시오.

networkPolicy.ingressNamespace은 인그레스 컨트롤러가 실행되는 네임스페이스입니다. 기본값인 kube-system는 k3s의 Traefik에 맞지만, 파일에 명시적으로 드러나도록 하기 위해 그대로 설정했습니다.

networkPolicy.externalEgressCIDRs은 DNS 및 Kubernetes 애플리케이션 프로그래밍 인터페이스(API) 서버 외에, 서비스가 도달할 수 있는 네임스페이스 외부의 주소 범위를 사이더(CIDR) 표기법으로 나열합니다. 우리의 파일에는 메일 릴레이의 단일 주소가 들어 있으며, 목록이 비어 있으면 네임스페이스 외부의 어떤 곳에도 도달할 수 없습니다.

keys.installationName은 키 저장소가 설치 환경 ID를 발급할 때 사용하는 영구적인 이름입니다.

keys.custody.recipients은 관리인들의 공개 age 수신자를 나열합니다. 관리(custody) Job은 모든 봉인 해제 조각(unseal share)과 복구 키를 각 수신자에게 암호화합니다.

필요할 수 있는 키와 그대로 두어야 할 키

키 설정 시기
networkPolicy.apiServerCIDRs 차트가 kubernetes Endpoints에서 API 서버의 주소를 읽을 수 없을 때. /32 범위로 지정하십시오
proxy.trustedCIDRs 인그레스 컨트롤러의 파드(pod)가 k3s의 10.42.0.0/16에 있지 않을 때
ai.localProvider.baseUrl 조직에서 자체 OpenAI 호환 인공지능(AI) 모델 서버를 실행할 때(2.14장, AI 제공자 및 모델)
ai.installationHosts 해당 모델 서버가 설치 환경 내부의 프라이빗 이름을 사용할 때
dataTier.<store>.size 저장소에 기본 볼륨보다 더 많은 용량이 필요할 때
dataTier.<store>.mode 직접 운영하는 저장소에 대한 external(2.11장, 변형 구성: 외부 저장소, TLS 및 인그레스)
components.<service>.replicas, components.<service>.resources 서비스의 규모를 확장(size up)할 때
auth.rateLimitPerMinute 대규모 자동화로 인해 사용자당 분당 5,000건 이상의 요청이 필요할 때
schemaWait.timeoutSeconds 느린 디스크로 인해 첫 마이그레이션이 30분 이상 걸릴 때

istio.enabled은 false로 두십시오. Nexus에는 서비스 메시가 필요하지 않습니다. telemetry.enabled은 false로 두십시오. 스키마는 다른 값을 허용하지 않습니다. orchestrator.platformServiceUserId와 probitas.flags은 차트가 설정한 대로 두십시오.

어떠한 자격 증명도 차트 값으로 설정되지 않습니다. 모델 제공자의 API 키, 메일 비밀번호 또는 풀(pull) 토큰을 위한 키는 존재하지 않습니다. 서비스들은 설치 시 자체 내부 시크릿을 생성하여 업그레이드 시에도 이를 유지하며, 각 조직의 모델 키는 첫 실행 후 콘솔에서 자체 키 풀(key pool)로 입력됩니다.

5단계: 최종 파일에 대해 사전 점검 실행하기

nexusctl preflight --context harrow-prod --values harrow-values.yaml

실행은 0 failed으로 끝나야 합니다. 2.5장, nexusctl을 이용한 사전 점검에서 모든 행을 설명합니다. 마지막 실행 이후 크기 하나라도 변경한 것이 있다면 다시 실행하십시오.

6단계: --wait 없이 설치하기

helm install nexus oci://registry.adverant.ai/nexus/charts/nexus --version 1.0.0-alpha.1 \
  --namespace nexus -f harrow-values.yaml --timeout 45m

3단계에서 네임스페이스를 생성하지 않았다면 --create-namespace을 추가하십시오. 다운로드하여 확인한 차트 파일로 설치하는 경우, oci:// 참조 대신 해당 파일의 경로를 입력하십시오.

--wait을 추가하지 마십시오. 차트의 데이터베이스 부트스트랩은 릴리스의 자체 리소스가 생성된 후 설치 후(post-install) 훅으로 실행되며, 각 서비스에 데이터베이스 역할과 비밀번호를 부여하는 것이 바로 이 훅입니다. --wait를 사용하면 모든 Deployment가 Available 상태가 될 때까지 설치를 보류하게 되는데, 기다리고 있는 훅이 실행되기 전에는 어떠한 Deployment도 Available 상태가 될 수 없습니다. 서비스들은 데이터베이스 로그인이 거부된 상태로 대기하고, Helm은 타임아웃이 될 때까지 이들을 기다립니다. --wait이 없더라도 Helm 4는 모든 훅 Job을 순서대로 기다리며, 이것이 바로 우리가 원하는 대기 방식입니다.

마지막 훅이 완료되면 Helm은 요약 정보를 출력합니다:

NAME: nexus
NAMESPACE: nexus
STATUS: deployed
REVISION: 1

STATUS: deployed은 모든 훅이 성공했음을 의미합니다. 아직 모든 서비스가 요청을 처리하고 있다는 의미는 아니며, 7단계에서 이를 기다립니다.

실행되는 항목과 실행 순서

Helm은 가중치(weight)가 가장 낮은 것부터 순서대로 훅을 실행하며, 다음 훅을 실행하기 전에 각 훅이 완료될 때까지 기다립니다. 모든 마이그레이션 Job에는 backoffLimit: 0이 설정되어 있습니다. 마이그레이션이 실패하면 설치가 실패하며, 보이지 않는 곳에서 임의로 재시도되지 않습니다. 성공한 Job은 삭제되고, 실패한 Job은 로그를 확인할 수 있도록 로그와 함께 남아 있습니다.

가중치 훅 수행 작업
-30 사전 요구 사항 훅 계정 nexus-migrations, 생성된 데이터베이스 자격 증명이 포함된 훅 전용 Secret nexus-migrations-env, 그리고 관리(custody) Job의 계정, 역할, 구성 및 인증서
-20 nexus-db-bootstrap 데이터베이스와 역할을 생성하며, 그중 어느 것도 슈퍼유저가 아니고 행 수준 보안(RLS)을 우회할 수 없습니다. PostGIS와 pgvector를 포함한 확장 기능을 추가하고, 릴리스 원장(ledger)을 생성합니다
-15 nexus-openbao-custody-init 키 저장소와 봉인 해제기(unsealer)를 초기화하고, 조각과 복구 키를 관리인들에게 암호화하며, 두 루트 토큰을 모두 폐기하고, keys.installationName 아래에 설치 환경 ID를 발급합니다
-12 nexus-graphrag-migrations 로그인 서비스의 스키마가 그래프 서비스가 소유한 객체를 참조하므로, 그래프 서비스의 스키마를 먼저 구성합니다
-10 nexus-auth-migrations 로그인 서비스의 스키마와 두 가지 런타임 역할을 구성합니다
-5 nexus-orchestrator-migrations, nexus-gateway-migrations, nexus-probitas-migrations 각 서비스의 자체 스키마를 구성합니다. probitas는 auth의 테이블을 먼저 확인하므로 auth 다음에 실행됩니다
0 nexus-alpha-bff-migrations 프론트엔드용 백엔드(BFF) 데이터베이스와 그 역할을 프로비저닝한 다음 마이그레이션을 적용합니다

각 마이그레이션 훅은 마지막에 릴리스 원장인 nexus_release.schema_applied에 체인의 이름과 이를 실행한 이미지의 다이제스트가 담긴 행 하나를 기록하며 종료됩니다. 이 행은 마이그레이션 러너가 오류 없이 완료된 후에만 기록됩니다. 부트스트랩 Job은 db-bootstrap: done를 출력하고, SQL 마이그레이션 훅은 마지막 줄에 schema-ledger: recorded <chain> for this release's image을 출력합니다. 콘솔의 자체 마이그레이션 훅인 nexus-alpha-bff-migrations도 동일한 방식으로 행을 기록한 후 bff-migrate: done를 출력합니다.

"helm install"이라는 레이블이 붙은, 왼쪽에서 오른쪽으로 이어지는 수평 타임라인입니다. 상단 트랙에는 순서대로 일곱 개의 훅 상자가 있습니다: "-30 prerequisites", "-20 db-bootstrap", "-15 custody init", "-12 graphrag migrations", "-10 auth migrations", "-5 orchestrator, gateway, probitas migrations", "0 BFF migrations". 각 마이그레이션 상자에는 중간 트랙에 있는 "release ledger: nexus_release.schema_applied"라는 레이블이 붙은 원통으로 향하는 작은 아래쪽 화살표가 있습니다. 하단 트랙에는 왼쪽에서 시작하는 "Deployments start, wait-for-schema holds each pod"라는 레이블이 붙은 긴 막대가 있으며, 이 막대에서 원장으로 짧은 수직 화살표들이 올라가고, 각 Deployment의 막대는 자체 원장 행이 나타날 때 실선으로 바뀝니다.
훅과 워크로드를 나란히 보여주는 신규 설치의 진행 순서입니다.

서비스가 스키마를 기다리는 방식

Deployment는 훅이 아직 실행 중일 때 Helm이 생성하자마자 시작됩니다. 역할, 비밀번호 또는 스키마가 없는 데이터베이스를 대상으로 시작된 서비스는 훅이 완료될 때까지 충돌과 재시작을 반복하게 됩니다. 따라서 데이터베이스를 사용하는 모든 Deployment에는 대신 파드의 시작을 보류시키는 초기화 컨테이너(init container)인 wait-for-schema이 포함되어 있습니다.

이 컨테이너는 해당 테이블 하나만 읽을 수 있고 다른 권한은 없는 로그인인 nexus_ledger_reader로 릴리스 원장을 읽으며, 원장에 이번 릴리스의 이미지 다이제스트에 대한 체인이 표시될 때까지 기다립니다. schemaWait.intervalSeconds(기본값 3)마다 폴링하고, 상태가 변경될 때와 20번째 폴링마다 상태를 출력하며, schemaWait.timeoutSeconds(기본값 1,800) 후에는 서비스 이름을 명시한 실패 메시지를 남기고 중단합니다.

Deployment 대기 대상
nexus-auth nexus-auth-migrations
nexus-orchestrator, nexus-workflows nexus-orchestrator-migrations
nexus-gateway nexus-gateway-migrations
nexus-graphrag nexus-graphrag-migrations
nexus-probitas nexus-probitas-migrations
nexus-skills-engine nexus-db-bootstrap
nexus-alpha-bff nexus-alpha-bff-migrations

특정 서비스의 대기 과정을 실시간으로 확인하려면 해당 초기화 컨테이너의 로그를 확인하십시오:

kubectl -n nexus logs deploy/nexus-auth -c wait-for-schema
wait-for-schema: nexus-auth waits for nexus_release.schema_applied (read as nexus_ledger_reader) to show: nexus-auth-migrations; gives up after 1800s
wait-for-schema: ready after 212s: the release ledger shows nexus-auth-migrations

대기 조건이 파일 개수가 아니라 이미지 다이제스트를 키로 사용하기 때문에, 추후 업그레이드 시 파드는 새 릴리스의 행을 기다리며, values만 변경된 후 재시작되는 파드는 자신의 행을 즉시 찾습니다.

7단계: 모든 워크로드가 준비될 때까지 기다리기

제한 시간을 두고 Deployment들을 기다립니다:

kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
deployment.apps/nexus-alpha condition met
deployment.apps/nexus-alpha-bff condition met
deployment.apps/nexus-auth condition met
deployment.apps/nexus-gateway condition met
deployment.apps/nexus-graphrag condition met
deployment.apps/nexus-keys condition met
deployment.apps/nexus-orchestrator condition met
deployment.apps/nexus-probitas condition met
deployment.apps/nexus-skills-engine condition met
deployment.apps/nexus-workflows condition met

그다음은 StatefulSet입니다. 두 키 저장소 서버는 파드를 삭제할 때만 업데이트되며, kubectl rollout status은 해당 업데이트 전략을 거부하므로 대신 준비 완료(ready) 개수를 기준으로 기다립니다:

for s in $(kubectl -n nexus get statefulset -o name); do
  kubectl -n nexus wait "$s" --for=jsonpath='{.status.readyReplicas}'=1 --timeout=900s
done

각각 condition met을 출력합니다. 우리의 클러스터에서는 Helm이 완료된 후 두 대기 과정을 합쳐 5분 미만이 걸렸습니다.

준비 완료 상태의 모습

kubectl -n nexus get deploy,statefulset
NAME                                  READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/nexus-alpha           1/1     1            1           14m
deployment.apps/nexus-alpha-bff       1/1     1            1           14m
deployment.apps/nexus-auth            1/1     1            1           14m
deployment.apps/nexus-gateway         1/1     1            1           14m
deployment.apps/nexus-graphrag        1/1     1            1           14m
deployment.apps/nexus-keys            1/1     1            1           14m
deployment.apps/nexus-orchestrator    1/1     1            1           14m
deployment.apps/nexus-probitas        1/1     1            1           14m
deployment.apps/nexus-skills-engine   1/1     1            1           14m
deployment.apps/nexus-workflows       1/1     1            1           14m

NAME                                READY   AGE
statefulset.apps/nexus-neo4j        1/1     14m
statefulset.apps/nexus-postgres     1/1     14m
statefulset.apps/nexus-qdrant       1/1     14m
statefulset.apps/nexus-seaweedfs    1/1     14m
statefulset.apps/nexus-valkey       1/1     14m
statefulset.apps/openbao            1/1     14m
statefulset.apps/openbao-unsealer   1/1     14m

10개의 Deployment와 7개의 StatefulSet이 모두 준비되었습니다. 이와 함께 키 서비스의 야간 유지보수를 담당하는 세 개의 CronJob인 nexus-keys-rotate-epoch, nexus-keys-run-schedule 및 nexus-keys-export-receipts을 확인할 수 있습니다. 성공한 훅 Job들은 삭제되었으므로 kubectl -n nexus get jobs에는 어떠한 훅 Job도 나열되지 않아야 합니다.

터미널을 닫기 전에 두 가지 작업을 해 두는 것이 좋습니다. 팀에서 구성을 보관하는 곳에 values 파일을 커밋하십시오. 모든 업그레이드는 이 파일에서 시작됩니다. 그리고 Secret nexus-generated은 건드리지 마십시오. 차트는 설치 시 내부 비밀번호와 키를 한 번 생성하여 그곳에 보관하고 매 업그레이드마다 다시 읽어 들이므로, 이를 삭제하면 서비스들이 자체 데이터에 접근할 수 없게 됩니다.

준비 완료(Ready)는 플랫폼이 실행 중이며 아직 소유권이 등록되지 않았음을 의미합니다. https://console.harrow.example을 열면 로그인 페이지가 아니라 설치 관리자에 도달하게 됩니다. 누군가 설치 환경의 소유권을 등록할 때까지 아무도 로그인할 수 없습니다. 이것이 2.12장, 첫 실행에서 다루는 첫 실행 과정입니다.

이 설치 환경(Community)
현재 설치 환경(Community)
소유권이 등록된 후의 Community 설치 환경 자체 페이지입니다. 실행 중인 버전, 엔진 상태, 디스크 사용량, 백업 및 보안 수정 보증이 표시되며, Enterprise 기능들은 누가 활성화할 수 있는지 알려주는 티저 형태로 표시됩니다.

실패하는 경우

대부분의 실패는 원인을 스스로 명시합니다. 무언가를 변경하기 전에 메시지를 먼저 읽으십시오.

표시되는 내용 원인 조치 방법
INSTALLATION_NAME_MISSING 또는 INSTALLATION_NAME_EXAMPLE keys.installationName이 비어 있거나 예제 값임 자체 영구 이름을 설정하십시오
KEYS_CUSTODIAN_MISSING 또는 KEYS_CUSTODIAN_EXAMPLE 관리인이 없거나 예제 값임 관리인들의 실제 수신자 정보를 설정하십시오
keys.installationName ... does not match ^[a-z][a-z0-9-]{0,62}$ 대문자, 마침표가 있거나 숫자로 시작함 문자로 시작하며 소문자, 숫자 및 하이픈을 사용하십시오
keys.custody.recipients: ... 및 사유 수신자 정보에 오타가 있거나, 개인 키이거나, 관리(custody) Job이 암호화할 수 없는 형식임 관리인에게 수신자 정보를 다시 요청하십시오
hosts.console is required (the installation identity) 호스트가 설정되지 않음 세 호스트를 모두 설정하십시오
tls.existingSecret is required when tls.mode is existing 지정된 Secret이 없음 설정하거나 tls.mode을 변경하십시오
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read 계정이 API 서버의 주소를 읽을 수 없음 /32 범위로 지정하십시오
global.imageRegistry is required 레지스트리가 설정되지 않음 설정하십시오
Helm이 타임아웃될 때까지 대기함; nexus-auth에 password authentication failed가 기록됨 --wait이 지정되었음 제거한 후 --wait 없이 다시 설치하십시오
훅 이름을 명시한 Error: ... job failed 마이그레이션 실패 kubectl -n nexus logs job/<hook-name>을 실행하고 마지막 줄들을 읽으십시오
파드가 Init 상태에서 멈춤 해당 파드의 wait-for-schema이 아직 대기 중임 로그를 확인하십시오. 누락된 체인의 이름이 표시됩니다
wait-for-schema: FAILED 해당 체인의 훅이 행을 기록하지 못함 해당 훅의 실패 원인을 먼저 찾으십시오
ImagePullBackOff 노드가 global.imageRegistry에서 이미지를 풀(pull)할 수 없음 노드가 레지스트리에 도달할 수 있는지 확인하고, Enterprise의 경우 풀 토큰이 있는지 확인하십시오

PostgreSQL을 기다리는 모든 훅은 제한된 시간 동안만 대기하며 waiting for postgres (12/60)을 출력하므로, 데이터베이스가 멈춘 경우 1분 이내에 훅의 로그에 나타납니다.

nexusctl 설치 경로

nexusctl install은 주변 점검 과정들을 자동으로 실행하면서 동일한 설치를 수행합니다. 동일한 values 파일을 사용합니다:

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

사전 점검을 다시 실행하고 실패하기 시작한 점검 항목이 있으면 중단합니다. 릴리스 키를 기준으로 차트 번들의 서명을 검증합니다. 그런 다음 설치하고, 훅과 워크로드가 완료될 때까지 기다리며, 각 단계와 소요 시간을 출력합니다. --edition community은 파일뿐만 아니라 명령줄에서도 에디션을 명시합니다. --ca-bundle <file>는 사전 점검과 동일하게 자체 CA 인증서를 추가합니다. 실행하지 않고 실행될 helm 및 kubectl 작업만 확인하려면 --explain를 추가하십시오:

nexusctl install --context harrow-prod --values harrow-values.yaml --explain

작업이 완료되면 소유권 등록 주소, 일회용 등록 코드 및 설치 환경의 지문(fingerprint)을 출력합니다:

Installed in <time>. Nobody can sign in yet.

  Open   https://console.harrow.example/claim
  Code   <code>          works once, for 30 minutes
  Fingerprint of this installation, to compare in the browser:
         <eight groups of four>

코드는 세 그룹으로 구성되며 다섯 번의 시도가 허용됩니다. 지문은 네 글자씩 여덟 그룹으로 구성되며, 소유권을 등록하기 전에 비교할 수 있도록 브라우저에도 동일한 여덟 그룹이 표시됩니다.

설치 중
설치하기
운영자의 터미널에서 실행 중인 설치 과정입니다. 각 단계가 소요 시간과 함께 출력되며, 실행은 일회용 코드와 설치 환경의 지문을 출력하며 끝납니다. 브라우저에서 설치 환경의 소유권을 등록할 때까지 아무도 로그인할 수 없습니다.

첫 실행으로의 인계

Helm으로 설치한 경우, 첫 번째 관리자가 될 사람의 이름을 지정하여 등록 코드를 직접 생성하십시오:

nexusctl claim-code --administrator aoife.brennan@harrow.example

이 명령어는 클러스터 접근 권한을 사용하여 nexus-keys 파드에서 키 서비스의 자체 등록 코드 명령어를 실행하고, 위와 같이 주소, 코드 및 지문을 출력합니다. 코드는 30분 동안 유효하며, 새 코드를 받으려면 다시 실행하십시오.

여기부터는 브라우저에서 진행합니다. 설치 환경의 소유권을 등록하고, 패스키로 첫 번째 관리자를 생성한 다음, 다른 사람이 로그인하기 전에 여섯 가지 작업을 순서대로 처리하십시오. 이 내용은 2.12장, 첫 실행에 있습니다. Enterprise 라이선스를 즉시 적용하려는 경우, 라이선스가 이 여섯 가지 작업 중 하나이므로 2.7장, Enterprise 설치 및 라이선스 적용하기를 먼저 읽으십시오.