버전 1.0.0-alpha.1최신
챕터 2.11
변형 구성: 외부 저장소, TLS 및 인그레스
초기 상태가 아닌 클러스터에 Nexus를 맞추는 값들로, TLS(전송 계층 보안)를 비롯해 이미 운영 중인 데이터베이스, 자체 인증서, 다른 인그레스 컨트롤러, 스토리지 클래스, 메일, 프록시, 레플리카 및 관리형 Kubernetes가 포함됩니다.
이 페이지는 AI에 의해 영어 원문에서 번역되었습니다. 불명확한 내용이 있는 경우 영어 페이지를 기준으로 삼으십시오. 이 페이지를 영어로 읽기

Harrow Port Authority의 운영 클러스터는 백지상태가 아니며, TLS(Transport Layer Security) 구성만 해도 세 부분으로 나뉩니다. 데이터베이스 팀은 자체 머신에서 PostgreSQL을 운영하며 모든 데이터베이스를 그곳에 두고 자신들의 방식으로 백업하기를 원합니다. 인증서는 cert-manager를 통해 Harrow의 내부 CA(인증 기관)에서 발급됩니다. 인그레스 컨트롤러는 Traefik이 아니며 자체 네임스페이스에 있습니다. 이 중 어느 것도 차트를 포크할 필요가 없습니다. 각각의 차이점은 설정값으로 처리되며, 이 장에서는 Tomás Reilly가 마주한 순서대로 이를 살펴봅니다.
이 장의 모든 values 블록은 일부분입니다. 2.6장, Kubernetes에 Community 설치하기에 나온 global, hosts, edition, keys와 함께 필요한 항목을 자체 values 파일에 병합하십시오. 차트의 스키마는 알 수 없는 키를 거부하므로, 철자가 틀린 키는 무시되지 않고 helm lint --strict 및 설치를 실패하게 만듭니다. 이는 의도된 것입니다. dataTier의 오타로 인해 저장소가 클러스터에 조용히 남겨지는 것이 오류보다 더 나쁘기 때문입니다.
외부 데이터 저장소
Nexus는 다섯 개의 저장소에 데이터를 보관합니다. 기본적으로 각 저장소는 릴리스 자체의 서명된 이미지를 사용하여 자체 볼륨과 함께 클러스터 내부에서 실행됩니다.
| 저장소 | Values 키 | 클러스터 내부 기본값 | 기본 볼륨 |
|---|---|---|---|
| PostgreSQL 16 (PostGIS 3 및 pgvector 0.8 포함) | dataTier.postgres |
릴리스 이미지 | 50Gi |
| Valkey 8.1 | dataTier.valkey |
릴리스 이미지 | 5Gi |
| Neo4j 5.26 Community Edition | dataTier.neo4j |
릴리스 이미지 | 20Gi |
| Qdrant 1.15 | dataTier.qdrant |
릴리스 이미지 | 10Gi |
| SeaweedFS 4.48, the object store compatible with Amazon S3 (Simple Storage Service) | dataTier.objectStore |
릴리스 이미지 | 50Gi |
이 중 어느 것이든 직접 운영하는 것으로 대체할 수 있습니다. 해당 저장소의 mode을 external로 설정하고, 호스트를 지정한 뒤, 자격 증명을 보유한 Secret의 이름을 지정하십시오. 네임스페이스는 다른 모든 이그레스를 거부하므로 저장소의 주소도 networkPolicy.externalEgressCIDRs에 추가하십시오(아래 네트워크 정책 섹션 참조). 외부 저장소의 경우 차트는 해당 저장소에 대해 StatefulSet, Service, 볼륨 등 아무것도 렌더링하지 않습니다. 서비스는 사용자가 지정한 호스트에 연결됩니다.
# harrow-external-postgres.yaml (Helm values)
dataTier:
postgres:
mode: external
port: 5432
sslmode: verify-full
external:
host: pg-nexus.db.harrow.example
existingSecret: harrow-postgresSecret은 설치 전에 Nexus가 설치될 네임스페이스에 사용자가 직접 생성합니다. 차트는 오직 그 이름만 보유합니다. 자격 증명이 필요한 파드는 시작할 때 사용자의 Secret에서 이를 읽어오며, 차트 자체의 Secret으로는 아무것도 복사되지 않습니다. 자격 증명을 변경하고 이를 사용하는 파드를 재시작하십시오. 다시 렌더링할 것은 없습니다.
각 저장소는 해당 Secret에서 고정된 키 이름을 찾습니다.
| 저장소 | Secret 내의 키 |
|---|---|
| PostgreSQL | 해당 서버의 슈퍼유저를 위한 username 및 password, 그리고 서버의 인증서에 서명한 인증 기관(CA)인 ca.crt |
| Valkey | password |
| Neo4j | username 및 password |
| Qdrant | api-key |
| 객체 저장소 | access-key 및 secret-key |
셸 기록과 values 파일에 남지 않도록 각 값을 파일에서 불러오십시오.
kubectl create namespace nexus
kubectl -n nexus create secret generic harrow-postgres \
--from-file=username=./pg-username --from-file=password=./pg-password --from-file=ca.crt=./harrow-db-ca.crtSecret 이름이 지정되지 않은 외부 저장소는 호스트가 없는 경우와 똑같이 렌더링을 중단시킵니다.
PostgreSQL
외부 서버는 릴리스 이미지가 제공하는 것과 동일한 구성, 즉 PostGIS 3 및 pgvector가 포함된 PostgreSQL 16을 제공해야 합니다. 해당 서버로 향하는 트래픽은 항상 암호화되며 사용자의 Secret에 있는 ca.crt과 대조하여 확인됩니다. sslmode를 verify-full(서버의 인증서가 사용자가 지정한 호스트를 명시하는지도 함께 확인함) 또는 verify-ca로 설정하십시오. 외부 서버를 사용할 때 렌더링은 disable 및 require을 거부합니다. 클러스터 내부 Postgres는 그 반대입니다. 트래픽이 절대 네임스페이스를 벗어나지 않고 네트워크 정책이 이를 그 안에 가두며, disable만 허용합니다. 어떤 모드를 선택하든 일부 서비스는 연결할 때마다 이름을 확인하므로 인증서는 external.host에 있는 호스트를 명시해야 합니다.
설치 시 부트스트랩 Job이 사용자의 Secret에 있는 계정으로 서버에 연결하여 Nexus가 실행될 때 사용할 역할을 생성합니다. 스키마를 소유하는 마이그레이터 역할, 런타임 역할, 그리고 각 서비스당 하나의 로그인 역할을 생성합니다. Nexus는 이들의 비밀번호를 생성하고 보관합니다. 이 중 어느 것도 슈퍼유저가 아니며 행 수준 보안(RLS)을 우회할 수 없으므로 데이터베이스의 모든 격리 정책이 모든 서비스에 적용됩니다. 부트스트랩 자체에는 슈퍼유저가 필요합니다. 단계 중 하나가 내장 PostgreSQL 함수를 잠그는 것인데, 이는 슈퍼유저만 수행할 수 있기 때문입니다. 부트스트랩과 콘솔 자체의 프로비저닝 단계만 해당 계정을 사용합니다. 이러한 이유로 관리자 역할이 실제 슈퍼유저가 아닌 관리형 데이터베이스 서비스는 Nexus 데이터베이스를 호스팅할 수 없습니다.
Job은 서버를 건드리기 전에 먼저 확인합니다. 사용자의 Secret에 있는 계정이 슈퍼유저가 아니면 아무것도 변경하지 않고 중단됩니다. SUPERUSER 또는 BYPASSRLS 속성을 가진 nexus이라는 역할이 이미 존재하는 경우, Job은 nexus-db-bootstrap: role nexus exists with SUPERUSER or BYPASSRLS on this server; nexus_migrator will not be made a member of it. Nothing more was done.와 함께 중단됩니다. 해당 역할에서 그 속성들을 제거하거나 해당 이름이 비어 있는 서버를 사용하여 다시 설치하십시오.
Valkey, Neo4j, Qdrant 및 객체 저장소
나머지 네 개는 동일한 세 가지 설정(mode, external.host, external.existingSecret)을 사용합니다. 다음은 네 개 모두를 Harrow의 자체 저장소로 전환한 예입니다.
# harrow-external-stores.yaml (Helm values)
dataTier:
valkey:
mode: external
external: { host: valkey.db.harrow.example, existingSecret: harrow-valkey }
neo4j:
mode: external
external: { host: neo4j.db.harrow.example, existingSecret: harrow-neo4j }
qdrant:
mode: external
external: { host: qdrant.db.harrow.example, existingSecret: harrow-qdrant }
objectStore:
mode: external
external: { host: objects.db.harrow.example, existingSecret: harrow-objects }서비스가 사용하는 포트에서 위 표에 나열된 릴리스 이미지가 포함하는 버전을 실행하십시오. Valkey는 6379에서, Neo4j는 7687에서 수신 대기하며, Qdrant는 6333을, 객체 저장소는 8333을 사용합니다. 객체 저장소는 S3와 호환되어야 합니다. Valkey 비밀번호는 각 파드 내부의 연결 주소에 들어가므로 영문자와 숫자로만 유지하십시오(-._~ 문자도 괜찮습니다).
mode이 external이고 external.host이 비어 있으면 렌더링은 dataTier.<store>.external.host is required when mode is external와 함께 중단됩니다. 사람들이 Nexus를 사용한 후에 저장소를 클러스터 내부에서 외부로 이동하는 것은 직접 수행해야 하는 데이터 마이그레이션이며, 차트는 아무것도 대신 복사해 주지 않습니다. 첫 설치 전에 결정하십시오.
키 저장소인 OpenBao는 이 목록에 없으며 외부에 둘 수 없습니다. 이는 설치 환경의 ID 일부이며 모든 설치에서 클러스터 내부에서 실행됩니다.
퍼블릭 엣지의 TLS
tls.mode은 세 개의 퍼블릭 호스트가 인증서를 얻는 방법만 결정하며 그 외에는 아무것도 결정하지 않습니다. 서비스 간 트래픽은 모드에 관계없이 항상 cert-manager가 발급한 차트 자체의 로컬 CA 인증서를 사용하는 상호 TLS(mTLS)를 사용합니다. 서비스 메시는 없으며 istio.enabled는 false으로 유지됩니다.
tls.mode |
인증서 생성 주체 | 필수 설정 항목 |
|---|---|---|
existing (기본값) |
사용자. 하나의 Secret이 세 호스트 모두에 대한 인증서를 보유합니다. | tls.existingSecret |
cert-manager |
이미 운영 중인 ClusterIssuer. 차트가 호스트당 하나의 인증서를 요청합니다. | tls.clusterIssuer |
none |
클러스터 내부에는 없음. TLS는 클러스터 앞단의 로드 밸런서나 프록시에서 종료됩니다. | 없음(단, 아래 경고 참조) |
existing
# harrow-tls-existing.yaml (Helm values)
tls:
mode: existing
existingSecret: harrow-public-tls모든 Ingress는 harrow-public-tls Secret을 제공하므로, 해당 인증서는 console.harrow.example, api.harrow.example, auth.harrow.example를 명시해야 합니다. 설치하기 전에 네임스페이스에 이를 생성하십시오.
kubectl -n nexus create secret tls harrow-public-tls --cert=harrow-public.crt --key=harrow-public.key사전 점검(Preflight)은 이를 읽고 만료가 30일 이내로 남았을 때 경고하며, 누락된 경우 해당 Secret의 이름을 알려줍니다. 모드가 existing이고 이름이 비어 있으면 렌더링은 tls.existingSecret is required when tls.mode is existing와 함께 중단됩니다.
cert-manager
# harrow-tls-cert-manager.yaml (Helm values)
tls:
mode: cert-manager
clusterIssuer: harrow-internal-ca차트는 세 개의 Ingress 각각에 cert-manager.io/cluster-issuer 어노테이션을 추가하고, cert-manager는 nexus-console-tls, nexus-api-tls, nexus-auth-tls Secret을 생성합니다. tls.clusterIssuer가 없으면 렌더링은 tls.clusterIssuer is required when tls.mode is cert-manager와 함께 중단됩니다.
발급자(Issuer)가 HTTP-01 챌린지와 함께 ACME(Automatic Certificate Management Environment)를 사용하는 경우 다른 조치는 필요하지 않습니다. 차트는 자체 리다이렉트를 추가하지 않으므로 /.well-known/acme-challenge/에 대한 요청은 변경 없이 발급자의 솔버(solver)에 도달합니다. 인터넷이 없는 사이트에서는 솔버 또한 이미지입니다. cert-manager의 cert-manager-acmesolver 이미지를 레지스트리에 넣으십시오. 그렇지 않으면 모든 챌린지 파드가 ErrImagePull 상태에서 대기하게 됩니다.
없음
# harrow-tls-none.yaml (Helm values)
tls:
mode: none
proxy:
trustedCIDRs: "10.30.0.0/16"none을 사용하면 Ingress에 TLS 섹션이 포함되지 않습니다. 클러스터 앞단의 로드 밸런서나 리버스 프록시가 세 호스트에 대한 TLS를 종료할 때 이를 사용하십시오.
proxy.trustedCIDRs은 nexus-auth가 X-Forwarded-For 헤더를 신뢰하는 프록시 홉을 지정합니다. 기본값인 10.42.0.0/16은 인그레스 컨트롤러가 실행되는 k3s의 파드 네트워크입니다. 다른 클러스터에서는 로그인 속도 제한과 감사 기록이 프록시 주소가 아닌 사용자의 주소를 인식할 수 있도록 인그레스 컨트롤러의 파드가 사용하는 네트워크로 설정하십시오.
인그레스 컨트롤러
차트는 퍼블릭 호스트당 하나씩 세 개의 일반 Kubernetes Ingress를 생성합니다. 각각은 / 경로를 하나의 Service로 라우팅합니다.
| Ingress | 호스트 | Service 및 포트 |
|---|---|---|
nexus-console |
hosts.console |
nexus-alpha, 3000 |
nexus-api |
hosts.api |
nexus-gateway, 9092 |
nexus-auth |
hosts.auth |
nexus-auth, 9101 |
세 개의 값이 이들을 구성하며, 네트워크 정책의 값 하나가 이와 일치해야 합니다.
# harrow-ingress.yaml (Helm values)
ingress:
enabled: true
className: harrow-nginx
annotations:
"<annotation-key>": "<annotation-value>"
networkPolicy:
ingressNamespace: ingress-harrowingress.className은 IngressClass의 이름을 지정합니다. 비워 두면 차트는 클래스를 생략하고 클러스터의 기본 클래스가 세 개의 Ingress를 처리합니다. 사전 점검은 해당 클래스가 존재하는지, 또는 이름을 지정하지 않은 경우 정확히 하나의 클래스가 기본값으로 표시되어 있는지 확인합니다.ingress.annotations은 세 개의 Ingress 모두에 추가됩니다. 값은 문자열이므로 숫자와 불리언은 따옴표로 묶으십시오. 컨트롤러 자체 설정에 이를 사용하십시오.ingress.enabled: false은 다른 방식으로 세 개의 Service에 라우팅하는 사이트를 위해 Ingress를 전혀 렌더링하지 않습니다.networkPolicy.ingressNamespace은 인그레스 컨트롤러가 실행되는 네임스페이스입니다.
마지막 항목은 사람들이 흔히 놓치는 부분입니다. 차트의 네트워크 정책은 기본적으로 네임스페이스로 들어오는 모든 트래픽을 거부한 다음, 사용자가 이름을 지정한 네임스페이스에서 오는 경우에만 세 개의 퍼블릭 Service에 대한 인그레스 컨트롤러의 접근을 허용합니다. 기본값인 kube-system은 그곳에서 Traefik을 실행하는 k3s에 맞습니다. 다른 컨트롤러를 사용할 때 이를 변경하지 않고 그대로 두면 컨트롤러가 Nexus에 도달할 수 없습니다. Ingress는 존재하지만 컨트롤러는 연결 시간 초과를 기록하고 브라우저는 게이트웨이 오류를 받게 됩니다. 사전 점검의 "Ingress ports" 검사는 해당 네임스페이스에서 LoadBalancer 또는 NodePort로서 포트 80 및 443에 열려 있는 Service를 찾으며, fix 줄에 이 값을 명시합니다.
나머지 네트워크 정책
networkPolicy.enabled은 기본적으로 true이며 그대로 유지되어야 합니다. 이 설정을 사용하면 DNS(Domain Name System), 토큰 검토자를 위한 Kubernetes API(애플리케이션 프로그래밍 인터페이스), 그리고 사용자가 나열한 주소를 제외하고는 네임스페이스 내부의 어떤 것도 외부에 도달할 수 없습니다.
# harrow-network.yaml (Helm values)
networkPolicy:
apiServerCIDRs: ["10.30.0.1/32"]
externalEgressCIDRs: ["10.30.40.25/32"]apiServerCIDRs은 /32 CIDR(Classless Inter-Domain Routing) 형식의 API 서버 주소입니다. 비워 두면 차트는 설치 시 클러스터에서 이를 읽어옵니다. helm template에는 읽어올 클러스터가 없으므로 그곳에 직접 지정하십시오. externalEgressCIDRs은 워크로드가 도달할 수 있는 그 외의 모든 주소이며 기본적으로 비어 있습니다. Harrow는 여기에 메일 릴레이를 나열합니다. 네임스페이스 외부의 모든 외부 데이터 저장소도 여기에 나열해야 하며, 그렇지 않으면 기본 거부 정책으로 인해 서비스가 해당 저장소에 도달하지 못합니다.
API 서버와 통신하는 워크로드는 증거 서비스인 nexus-probitas, 오케스트레이터, 그리고 키 저장소의 보관(custody) Job뿐입니다. 이들은 다른 워크로드가 제시하는 서비스 계정 토큰을 확인합니다. 정책은 포트 6443 및 443의 API 서버 주소를 이 세 가지에만 부여하고 다른 것에는 부여하지 않습니다. 이 세 가지가 API 서버에 도달할 수 없으면 다른 워크로드가 제시하는 토큰을 확인할 수 없으므로, 가질 수 있는 모든 주소를 지정하십시오.
TLS 모드 선택
Harrow는 내부 CA를 ClusterIssuer로 하여 cert-manager을 선택했는데, 그 이유는 갱신 때문이었습니다. existing를 사용하면 사람이 만료 전에 Secret의 인증서를 갱신해야 하며, 사전 점검의 30일 전 경고가 유일한 알림입니다. cert-manager을 사용하면 갱신이 자동으로 이루어지므로 아무도 기억할 필요가 없습니다. none는 모든 퍼블릭 주소가 이미 여러 시스템의 TLS를 종료하는 로드 밸런서 뒤에 있고 해당 팀이 인증서를 소유하는 사이트에 적합합니다. 무엇을 선택하든 브라우저가 보는 인증서는 브라우저가 신뢰하는 것이어야 합니다. 사람들이 경고를 무시하고 클릭해서 넘어가는 자체 서명 인증서는 패스키를 작동하지 않게 만드는데, Chrome이 인증서 경고 뒤에서는 패스키를 생성하거나 사용하지 않기 때문입니다.
스토리지, 메일, 레플리카 및 리소스
스토리지 클래스
# harrow-storage.yaml (Helm values)
storage:
className: harrow-ssd
dataTier:
postgres:
size: 200Gi
objectStore:
size: 500Gistorage.className은 모든 데이터 계층 PVC(영구 볼륨 클레임)와 키 저장소의 볼륨에 적용됩니다. 비워 두면 클러스터의 기본 클래스를 의미하며, 기본값으로 표시된 클래스가 없고 이름을 지정하지도 않은 경우 사전 점검이 실패합니다. 각 클러스터 내부 저장소에는 자체 size가 있습니다. 키 저장소의 항목은 keys.openbao.storage.unsealer 및 keys.openbao.storage.keystore이며, 영수증용으로 keys.receiptsStorage가 있습니다. 1년간의 증가량을 고려하여 크기를 선택하십시오.
메일
# harrow-mail.yaml (Helm values)
smtp:
existingSecret: harrow-smtpNexus는 사용자의 메일 서버를 통해 초대장과 알림을 보냅니다. smtp.existingSecret은 메일 서버의 세부 정보를 담아 네임스페이스에 생성하는 Secret의 이름을 지정합니다. 모든 통합과 마찬가지로 차트는 Secret의 이름만 받으며 자격 증명은 절대 받지 않습니다. 네트워크 정책을 기억하십시오. 릴레이의 주소를 networkPolicy.externalEgressCIDRs에 추가하지 않으면 메일이 네임스페이스 경계에서 멈춥니다. 메일이 작동할 때까지 초대장을 보낼 수 없으며, 첫 번째 관리자의 체크리스트에 그렇게 표시됩니다.
레플리카 및 리소스
각 핵심 구성 요소에는 components 아래에 레플리카 수와 Kubernetes 리소스가 있으며, 각 클러스터 내부 저장소에는 dataTier 아래에 리소스가 있습니다.
# harrow-sizing.yaml (Helm values)
components:
console: { replicas: 2, resources: { requests: { cpu: 200m, memory: 512Mi }, limits: { memory: 1Gi } } }
auth: { replicas: 2 }
gateway: { replicas: 2, resources: { requests: { cpu: 400m, memory: 1Gi }, limits: { memory: 2Gi } } }
graphrag: { resources: { requests: { cpu: 400m, memory: 1Gi }, limits: { memory: 3Gi } } }
dataTier:
postgres:
resources: { requests: { cpu: "1", memory: 4Gi }, limits: { memory: 8Gi } }
neo4j:
heap: 2G
pagecache: 1G
resources: { requests: { cpu: 500m, memory: 4Gi }, limits: { memory: 4Gi } }기본 Neo4j 파드는 2 GiB를 요청하며 최대 4 GiB까지 사용할 수 있습니다. 3 GB의 힙 및 페이지 캐시를 사용하는 경우, 해당 메모리를 가진 노드에 파드가 배치되도록 요청(request) 값도 함께 높이십시오.
replicas 및 resources가 있는 구성 요소는 console, bff, auth, orchestrator, workflows, gateway, graphrag, probitas, skillsEngine입니다. 키 서비스인 keys는 resources만 받습니다. 이러한 핵심 구성 요소는 필수이며 끌 수 없습니다. 차트는 enabled 스위치 값에 관계없이 이들을 실행합니다. 데이터 계층 저장소는 각각 하나의 레플리카를 실행합니다.
느린 스토리지에서는 두 가지 추가 값을 통해 서비스가 시작될 시간을 확보할 수 있습니다. 시작 컨테이너가 이름으로 실패하기 전에 서비스가 데이터베이스 마이그레이션을 기다리는 시간인 probes.startupFailureThreshold(기본값 60)과 schemaWait.timeoutSeconds(1800)입니다.
로그인 세션, 속도 제한 및 프라이빗 모델 호스트
세 가지 작은 값 그룹은 첫날부터 사람들이 알아차리기 때문에 설치 전에 알아둘 가치가 있습니다.
# harrow-auth.yaml (Helm values)
auth:
accessTokenTTL: 15m
refreshTokenTTL: 12h
rateLimitPerMinute: 5000
ai:
installationHosts: [models.harrow.internal, .gpu.harrow.internal]auth.accessTokenTTL과 auth.refreshTokenTTL는 세션의 두 토큰이 지속되는 시간입니다. 기본값인 15분과 12시간은 저녁에 노트북을 닫은 사람이 아침에 다시 로그인함을 의미합니다. 정책에서 요구하는 경우 리프레시 토큰을 줄이고 더 잦은 로그인을 예상하십시오.
auth.rateLimitPerMinute은 로그인한 한 사람이 429 응답을 받기 전까지 1분 동안 로그인 서비스에 보낼 수 있는 최대 요청 수입니다. 기본값인 5000은 한 계정당 초당 약 83회로, 콘솔과 스크립트에 충분한 양입니다. 설치 환경에는 구독 플랜이 없으므로 모든 사람이 동일한 제한을 적용받습니다. 남용 방지를 강화하려면 이 값을 낮추고, 대규모 자동화를 위해서는 높이십시오. 계정 잠금 및 2차 인증 시도 제한과 같은 로그인 무차별 대입(brute-force) 방지는 별개이며 여기서 설정하지 않습니다.
ai.installationHosts은 사설 이름을 사용하는 조직 자체의 AI(인공지능) 모델 서버를 위해 설치 환경 내부에 추가 호스트 이름을 나열합니다. 각 항목은 호스트 이름, 그 아래의 모든 이름과 일치하는 .suffix, IP 주소 또는 IPv4 CIDR(Classless Inter-Domain Routing) 블록입니다. 라우터는 이들을 릴리스 자체 호스트와 나란히 설치 환경의 일부로 취급합니다. 모델 서버 자체는 ai.localProvider.baseUrl에 지정되며, 2.14장, AI 제공자 및 모델에서 이 두 가지를 모두 다룹니다.
절대 설정값이 될 수 없는 항목
사람들이 values 파일에서 찾는 일부 항목은 의도적으로 그곳에 없습니다.
| values 파일에 없는 항목 | 이유 및 실제 위치 |
|---|---|
| 라이선스 | 설치 후 콘솔에서 또는 nexusctl licence import <file>을 사용하여 가져옵니다. 라이선스는 절대 차트 값이나 마운트된 파일이 아닙니다. 자세한 내용은 2.13장, 라이선스에 있습니다. |
| 모델 키 | 각 조직은 콘솔에 입력된 자체 풀에 자체 키를 보관합니다. 어떤 AI 제공자 자격 증명도 차트 값이 될 수 없습니다. |
| 가입 보안 강화 | 인터넷 CAPTCHA와 가입 네트워크 차단 화면은 모두 설치 환경에서 꺼져 있으며, 둘 중 어느 것도 켤 수 있는 설정값이 없습니다. CAPTCHA는 가입할 때마다 인터넷이 필요할 것입니다. 네트워크 차단 화면은 차트에 포함되지 않은 라이선스 위치 정보 데이터베이스가 필요할 것입니다. 대신 2.12장, 첫 실행에서 설명하는 것처럼 외부인의 가입은 관리자의 승인을 위해 보류됩니다. |
| 텔레메트리 | 스키마는 telemetry.enabled에 대해 하나의 설정만 허용하며, 이는 false입니다. 어떤 것도 설치 환경을 벗어나지 않으며, 데이터 계층 자체의 보고 기능(Neo4j의 사용량 보고서, Qdrant의 텔레메트리)도 꺼져 있습니다. |
설치 전 전체 파일 확인
조각들을 하나의 파일로 병합한 후 워크스테이션에서 두 가지 검사를 실행하십시오. helm lint --strict은 차트의 스키마에 따라 모든 키의 유효성을 검사하고, helm template는 무언가 생성되기 전에 읽을 수 있도록 전체 릴리스를 렌더링합니다. 명령어는 Community 차트의 주소를 사용합니다. Enterprise의 경우 다운로드한 Enterprise 차트의 경로를 대신 지정하십시오(2.7장, Enterprise 설치 및 라이선스 적용). 워크스테이션에서의 렌더링은 클러스터에서 API 서버의 주소를 읽을 수 없으므로 파일에 먼저 networkPolicy.apiServerCIDRs을 설정하십시오.
두 가지 검사:
helm lint --strict oci://registry.adverant.ai/nexus/charts/nexus --version 1.0.0-alpha.1 -f harrow-prod-values.yaml
helm template nexus oci://registry.adverant.ai/nexus/charts/nexus --version 1.0.0-alpha.1 \
-n nexus -f harrow-prod-values.yaml > harrow-render.yaml철자가 틀린 키는 "additional properties"와 함께 린트(lint)에 실패하고 해당 키의 이름을 알려줍니다. 저장소가 외부일 때 호스트가 없는 것처럼 필수 값이 누락된 경우, 이 장에서 인용된 문장과 함께 렌더링에 실패합니다. helm template에는 읽을 클러스터가 없으므로 오프라인으로 렌더링할 때는 networkPolicy.apiServerCIDRs를 지정하십시오. 그렇지 않으면 중단되고 이를 요구합니다.
그런 다음 동일한 파일로 사전 점검을 실행하십시오. 사전 점검은 클러스터와 설정값을 함께 읽는 유일한 검사입니다. 누군가 설치 환경에 의존하기 전에 잘못된 인그레스 네임스페이스, 누락된 스토리지 클래스 또는 다음 주에 만료되는 인증서가 여기서 드러납니다.
관리형 Kubernetes
Nexus는 클라우드 제공업체의 관리형 서비스를 포함하여 표준을 준수하는 모든 Kubernetes 1.33 이상에서 실행됩니다. 차트의 어떤 것도 특정 제공업체에 종속되지 않습니다. k3s에서 달라지는 것은 위에서 다룬 몇 가지 값뿐입니다.
- 모든 클러스터에서와 마찬가지로 cert-manager v1.21.3이 먼저 설치됩니다. | 관리형 클러스터 항목 | 설정 또는 확인할 사항 | |---|---| | 스토리지 |
storage.className에 제공업체의 클래스 이름을 지정하거나 하나를 기본값으로 표시하십시오. | | 인그레스 | 사용하는 인그레스 컨트롤러를 설치하고, 포트 80 및 443에 노출하고, 기본값이 아닌 경우ingress.className를 설정하고,networkPolicy.ingressNamespace을 해당 네임스페이스로 설정하십시오. | | 프록시 홉 |proxy.trustedCIDRs를 해당 컨트롤러의 파드 네트워크로 설정하십시오. | | API 서버 | 설치 과정에서 클러스터로부터 API 서버의 주소를 읽을 수 없는 경우networkPolicy.apiServerCIDRs에 지정하십시오. | | 네트워크 정책 적용 | 차트의 정책은 클러스터의 네트워크 플러그인이 NetworkPolicy를 적용하는 경우에만 효력을 발휘합니다. 이를 적용하는 클러스터 구성을 선택하십시오. | | 이미지 | 노드는registry.adverant.ai또는global.imageRegistry에 지정된 자체 레지스트리에 도달해야 합니다. |
다른 무엇보다 먼저 사전 점검을 실행하십시오. 클러스터와 values 파일을 함께 읽고 각 항목을 행으로 출력하며, 누락된 모든 항목 옆에는 해결 방법을 표시합니다. 2.5장, nexusctl을 사용한 사전 점검에서 보고서를 보여줍니다.

