Oturum açınToplantı planlayın

Bölüm 2.6

Kubernetes üzerinde Community kurulumu

cert-manager'dan tüm iş yüklerinin hazır olmasına kadar Helm ile adım adım numaralandırılmış Community sürümü kurulumu; anahtar bazında açıklanan değerler dosyası, neden --wait kullanılmadığı, paketin kancalarının çalışma sırası ve alternatif olarak nexusctl kurulum yolu.

Bu sayfa, İngilizce aslından YZ tarafından çevrilmiştir. Anlaşılmayan bir yer olursa İngilizce sayfa esas alınır. Bu sayfayı İngilizce okuyun

18 dakikalık okuma

Kurulumun kendisi tek bir helm install komutudur. Etrafındaki her şey, bu tek komutun ilk seferde çalışması için oradadır: öncesinde cert-manager, satır satır okuduğunuz bir values dosyası ve sonrasında neyi bekleyeceğini bilen bir bekleme adımı. Harrow Port Authority'de, altı haftalık bir pilot uygulama için planlama çalışma sayfamızdaki üç düğümlü k3s kümesine önce Community sürümünü kurduk. Sürüm yaklaşık yirmi dakika içinde çalışır durumdaydı ve biz sahiplenene kadar kimse oturum açamadı; olması gereken de budur.

Bu bölüm, üç şeyi zaten yaptığınızı varsayar: planlama çalışma sayfasını tamamladığınızı (bölüm 2.3, Kurulumu planlama), sürümü indirip kontrol ettiğinizi (bölüm 2.4, Sürümü edinme ve doğrulama) ve ön kontrolü çalıştırdığınızı (bölüm 2.5, nexusctl ile ön kontrol). Bunlardan herhangi biri hala açıksa geri dönün. Kurulum çoğu hatayı adıyla reddeder, ancak anahtarını zaten kaybettiğiniz bir emanetçi (custodian) gibi birkaç hatayı göremez.

Adım 1: araçlarınızı ve bağlamınızı doğrulayın

  1. Helm'in 4. sürüm olduğunu kontrol edin.

    helm version

    Kurulum, Helm 4'ün varsayılan olarak chart'ın kanca (hook) Job'larını beklemesine dayanır. Biz v4.3.1 kullandık.

  2. kubectl aracını çalışma sayfanızdaki kümeye yönlendirin ve doğrulayın.

    kubectl config use-context harrow-prod
    kubectl get nodes

    Her düğüm Ready demelidir. Ön kontrol bunu zaten denetledi, ancak ön kontrol ile kurulum arasında bir düğüm düşebilir ve bunu burada görmek daha hızlıdır.

Adım 2: önce cert-manager'ı kurun

Chart, cert-manager ile kendi yerel sertifika yetkilisini (CA) oluşturur ve her servis diğerleriyle bunun verdiği sertifikalarla konuşur: kendinden imzalı bir Issuer, on yıllık bir yerel CA sertifikası ve servisler için kısa ömürlü sertifikalar. Bu nedenle cert-manager, Nexus'tan önce çalışıyor olmalıdır. Sürüm v1.21.3 gerektirir ve trust-manager gerektirmez.

  1. cert-manager'ı özel kaynaklarıyla birlikte kendi chart'ından kurun:

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

    <cert-manager-chart>, cert-manager projesinin kendi sürümündeki cert-manager v1.21.3 chart'ıdır. Burada beklemek doğrudur; bu, başka hiçbir şeye bağımlı kancaları olmayan cert-manager'ın kendi kurulumudur.

  2. Her sertifika isteğinin içinden geçtiği webhook'unu bekleyin:

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

Adım 3: ad alanını ve TLS Secret nesnesini oluşturun

tls.mode: existing ile chart, kurulumdan önce sertifikanızı ad alanında (namespace) bir Kubernetes Secret olarak bekler. Üç adresin tamamı için Taşıma Katmanı Güvenliği (TLS) bu tek Secret'tan gelir, bu nedenle sertifikası üç ana bilgisayarı (host) da adlandırmalıdır.

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

harrow-public.crt zinciriyle birlikte sertifikadır ve harrow-public.key onun özel anahtarıdır. Bölüm 2.3, Kurulumu planlama içinde tls.mode: cert-manager veya none seçtiyseniz, Secret adımını atlayın; ad alanını yine de şimdi oluşturabilir veya 6. adımda --create-namespace ile bunu Helm'in yapmasına izin verebilirsiniz.

Adım 4: değerler dosyasını yazın

Bu, Harrow'un pilot uygulama için values dosyasıdır. İçindeki her anahtar, chart şemasının kabul ettiği bir anahtardır; şema diğerlerini reddeder, böylece yanlış yazılmış bir anahtar sessizce yok sayılmak yerine kurulumu başarısız kılar.

# 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>"

Her <recipient-...>, bir emanetçinin açık age alıcısıdır; size gönderdikleri age1... veya age1se1... satırıdır. İşte ayarladığımız her anahtar ve nedeni.

global.imageRegistry, düğümlerinizin çekim yaptığı kayıt defteridir (registry). Chart'ın varsayılanı yoktur; her imajı <this>/nexus/<service>@<digest> olarak oluşturur. Bağlantılı bir kurulum için bu registry.adverant.ai değeridir. İmajları kendi kayıt defterinize kopyaladıysanız, o ana bilgisayardır.

global.domain, üç adresin altında yer aldığı etki alanıdır (domain).

hosts.console, hosts.api ve hosts.auth kurulumun kimliğidir: insanların ve programların kullandığı üç ad. Her biri, ön kontrolün denetlediği Alan Adı Sistemi'nde (DNS) zaten çözümleniyor olmalıdır.

edition ve enterprise.enabled uyuşmalıdır: false ile community veya true ile enterprise. Chart başka her şeyi reddeder ve imaj kilidinin kendisi için yapılmadığı bir sürümü (edition) reddeder.

tls.mode ve tls.existingSecret, genel uç noktanın (public edge) sertifikasını nasıl alacağını seçer. cert-manager ile bunun yerine tls.clusterIssuer ayarlardınız ve none ile hiçbirini ayarlamazdınız.

ingress.className, ingress sınıfını adlandırır. Kümenin varsayılan sınıfını kullanmak için ayarlamadan bırakın.

storage.className, her veri birimi (volume) için depolama sınıfını adlandırır. Varsayılanı kullanmak için ayarlamadan bırakın.

networkPolicy.ingressNamespace, ingress denetleyicinizin çalıştığı ad alanıdır. Varsayılan kube-system, k3s'in Traefik'i için doğrudur; dosyanın bunu açıkça belirtmesi için yine de ayarladık.

networkPolicy.externalEgressCIDRs, DNS ve Kubernetes uygulama programlama arayüzü (API) sunucusunun ötesinde, servislerin ulaşabileceği ad alanı dışındaki adres aralıklarını Sınıfsız Alanlar Arası Yönlendirme (CIDR) gösterimiyle listeler. Bizimki posta aktarıcısının (mail relay) tek adresini tutar; liste boş olduğunda ad alanı dışındaki hiçbir şeye ulaşılamaz.

keys.installationName, anahtar deposunun kurulum kimliğini altında ürettiği kalıcı addır.

keys.custody.recipients, emanetçilerin açık age alıcılarını listeler. Emanet (custody) Job'ı, her mühür açma payını (unseal share) ve kurtarma anahtarını bunların her birine şifreler.

İhtiyaç duyabileceğiniz anahtarlar ve dokunulmaması gereken anahtarlar

Anahtar Ne zaman ayarlanmalı
networkPolicy.apiServerCIDRs Chart, API sunucusunun adreslerini kubernetes Endpoints'ten okuyamadığında. Bunları /32 aralıkları olarak verin
proxy.trustedCIDRs Ingress denetleyicinizin pod'ları k3s'in 10.42.0.0/16 üzerinde olmadığında
ai.localProvider.baseUrl Kuruluş kendi OpenAI uyumlu yapay zeka (YZ) model sunucusunu çalıştırdığında (bölüm 2.14, YZ sağlayıcıları ve modelleri)
ai.installationHosts Bu model sunucusu kurulum içinde özel adlarda yer aldığında
dataTier.<store>.size Bir deponun varsayılan biriminden daha fazlasına ihtiyacı olduğunda
dataTier.<store>.mode Kendinizin çalıştırdığı bir depo için external (bölüm 2.11, Çeşitlemeler: harici depolar, TLS ve ingress)
components.<service>.replicas, components.<service>.resources Bir servisin boyutunu büyüttüğünüzde
auth.rateLimitPerMinute Yoğun otomasyonun kişi başına dakikada 5.000'den fazla isteğe ihtiyacı olduğunda
schemaWait.timeoutSeconds Yavaş bir disk ilk taşıma işlemlerinin (migrations) 30 dakikadan uzun sürmesine neden olduğunda

istio.enabled anahtarını false olarak bırakın; Nexus'un servis ağına (service mesh) ihtiyacı yoktur. telemetry.enabled anahtarını false olarak bırakın; şema başka hiçbir değeri kabul etmez. orchestrator.platformServiceUserId ve probitas.flags anahtarlarını chart'ın ayarladığı gibi bırakın.

Hiçbir kimlik bilgisi asla bir chart değeri değildir. Bir model sağlayıcısının API anahtarı, bir posta parolası veya bir çekme belirteci (pull token) için anahtar yoktur. Servisler kendi dahili sırlarını kurulumda oluşturur ve yükseltmede korur; her kuruluşun model anahtarları ilk çalıştırmadan sonra konsoldan kendi anahtar havuzuna girer.

Adım 5: nihai dosyaya karşı ön kontrolü çalıştırın

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

Çalıştırma 0 failed ile bitmelidir. Bölüm 2.5, nexusctl ile ön kontrol, her satırı açıklar. Son çalıştırmadan bu yana bir boyut bile olsa herhangi bir şeyi değiştirdiyseniz tekrar çalıştırın.

Adım 6: --wait olmadan kurun

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. adımda ad alanını oluşturmadıysanız --create-namespace ekleyin. İndirip kontrol ettiğiniz bir chart dosyasından kurulum yapıyorsanız, oci:// referansının yerine onun yolunu koyun.

--wait eklemeyin. Chart'ın veritabanı önyüklemesi (bootstrap), sürümün kendi kaynakları var olduktan sonra bir kurulum sonrası kancası (post-install hook) olarak çalışır ve her servise veritabanı rolünü ve parolasını veren bu kancadır. --wait, her Deployment Available (Kullanılabilir) olana kadar kurulumu bekletir ve hiçbir Deployment, beklediği kanca çalışmadan önce Available olamaz. Servisler veritabanı oturum açma işlemlerini reddederek bekler ve Helm zaman aşımına kadar onları bekler. --wait olmadan, Helm 4 yine de her kanca Job'ını sırayla bekler ve istediğiniz bekleme budur.

Son kanca bittiğinde, Helm özetini yazdırır:

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

STATUS: deployed, her kancanın başarılı olduğu anlamına gelir. Henüz her servisin hizmet verdiği anlamına gelmez; 7. adım bunu bekler.

Ne, hangi sırayla çalışır

Helm kancaları ağırlığa göre, en düşükten başlayarak çalıştırır ve bir sonrakine geçmeden önce her birini bekler. Her taşıma (migration) Job'ında backoffLimit: 0 vardır: başarısız bir taşıma kurulumu başarısız kılar ve asla arkanızdan yeniden denenmez. Başarılı olan bir Job silinir; başarısız olan bir Job, okumanız için günlüğüyle birlikte kalır.

Ağırlık Kanca (Hook) Yaptığı iş
-30 Ön koşullar Kanca hesabı nexus-migrations, oluşturulan veritabanı kimlik bilgilerini içeren yalnızca kancaya özel Secret nexus-migrations-env ve emanet Job'ının hesabı, rolü, yapılandırması ve sertifikası
-20 nexus-db-bootstrap Hiçbiri süper kullanıcı (superuser) olmayan ve hiçbiri satır düzeyinde güvenliği (RLS) atlayamayan veritabanlarını ve rolleri oluşturur; aralarında PostGIS ve pgvector'ün de bulunduğu uzantıları ekler; sürüm defterini (release ledger) oluşturur
-15 nexus-openbao-custody-init Anahtar deposunu ve mühür açıcısını başlatır, payları ve kurtarma anahtarlarını emanetçilerinize şifreler, her iki kök belirteci (root token) iptal eder ve keys.installationName altında kurulum kimliğini üretir
-12 nexus-graphrag-migrations Önce graf servisinin şemasını yerleştirir, çünkü oturum açma servisinin şeması onun sahip olduğu nesnelere atıfta bulunur
-10 nexus-auth-migrations Oturum açma servisinin şemasını ve iki çalışma zamanı rolünü yerleştirir
-5 nexus-orchestrator-migrations, nexus-gateway-migrations, nexus-probitas-migrations Her servisin kendi şeması; probitas, önce auth'un tablolarını kontrol ettiği için auth'tan sonra çalışır
0 nexus-alpha-bff-migrations Ön uç için arka uç (BFF) veritabanını ve rollerini hazırlar, ardından taşımalarını uygular

Her taşıma kancası, sürüm defterine (nexus_release.schema_applied) bir satır yazarak sona erer: zincirinin adı ve onu çalıştıran imajın özeti (digest). Bu satırı yalnızca taşıma çalıştırıcısı hatasız bittikten sonra yazar. Önyükleme Job'ı db-bootstrap: done yazdırır; SQL taşıma kancaları son satırları olarak schema-ledger: recorded <chain> for this release's image yazdırır. Konsolun kendi taşıma kancası nexus-alpha-bff-migrations, satırını aynı şekilde kaydeder ve ardından bff-migrate: done yazdırır.

Soldan sağa uzanan, "helm install" etiketli yatay bir zaman çizelgesi. Üst şeritte sırasıyla yedi kanca kutusu: "-30 prerequisites", "-20 db-bootstrap", "-15 custody init", "-12 graphrag migrations", "-10 auth migrations", "-5 orchestrator, gateway, probitas migrations", "0 BFF migrations". Her taşıma kutusundan orta şeritteki "release ledger: nexus_release.schema_applied" etiketli bir silindire doğru inen küçük bir ok vardır. Alt şeritte, soldan başlayan "Deployments start, wait-for-schema holds each pod" etiketli uzun bir çubuk bulunur; ondan deftere doğru kısa dikey oklar yükselir ve kendi defter satırı göründüğünde her Deployment'ın çubuğu dolgulu hale gelir.
Kancalar ve iş yükleri yan yana olacak şekilde temiz bir kurulumun sırası.

Servisler şemalarını nasıl bekler

Deployment'lar, kancalar hala çalışırken Helm onları oluşturur oluşturmaz başlar. Rolü, parolası veya şeması olmayan bir veritabanına karşı başlayan bir servis, kancalar bitene kadar çöker ve yeniden başlar. Bu nedenle, veritabanını kullanan her Deployment, bunun yerine pod'u geride tutan bir başlatma konteyneri (init container) olan wait-for-schema taşır.

Sürüm defterini, yalnızca o tek tabloyu okuyabilen ve başka hiçbir şeyi okuyamayan bir oturum açma bilgisi olan nexus_ledger_reader olarak okur ve defter bu sürümün imaj özetleri için zincirlerini gösterene kadar bekler. Her schemaWait.intervalSeconds saniyede bir (varsayılan olarak 3) yoklar, değiştiğinde ve her yirminci yoklamada durumunu yazdırır ve servisi adlandıran bir hatayla schemaWait.timeoutSeconds saniye (varsayılan olarak 1.800) sonra vazgeçer.

Deployment Beklediği
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

Bir servisin beklemesini gerçekleşirken izlemek için başlatma konteynerinin günlüğünü okuyun:

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

Bekleme, dosya sayısına değil imaj özetine (digest) bağlı olduğundan, daha sonraki bir yükseltmenin pod'ları yeni sürümün satırlarını bekler ve yalnızca değer (values) değişikliğinden sonra yeniden başlayan bir pod satırını hemen bulur.

Adım 7: her iş yükünü bekleyin

Bir sınır belirleyerek Deployment'ları bekleyin:

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

Ardından StatefulSet'ler. İki anahtar deposu sunucusu yalnızca pod'larını sildiğinizde güncellenir ve kubectl rollout status bu güncelleme stratejisini reddeder, bu nedenle bunun yerine hazır sayısını bekleyin:

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

Her biri condition met yazdırır. Kümemizde her iki bekleme birlikte Helm döndükten sonra beş dakikadan az sürdü.

Hazır durumu nasıl görünür

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

On Deployment ve yedi StatefulSet, her biri hazır. Bunların yanında anahtar servisinin gece bakımını yapan üç CronJob (nexus-keys-rotate-epoch, nexus-keys-run-schedule ve nexus-keys-export-receipts) bulacaksınız. kubectl -n nexus get jobs hiçbir kanca Job'ı listelememelidir: başarılı olanlar silinmiştir.

Terminalden ayrılmadan önce iki şeyi yapmaya değer. Values dosyasını ekibinizin yapılandırmayı tuttuğu yere işleyin (commit edin); her yükseltme ondan başlar. Ve nexus-generated Secret'ına dokunmayın. Chart, dahili parolaları ve anahtarları kurulumda bir kez oluşturur, orada tutar ve her yükseltmede geri okur; bu nedenle onu silmek servisleri kendi verilerine ulaşamaz halde bırakır.

Hazır olması, platformun çalıştığı ve sahiplenilmediği anlamına gelir. https://console.harrow.example adresini açtığınızda bir oturum açma sayfasına değil, yükleyiciye ulaşırsınız: birisi kurulumu sahiplenene kadar kimse oturum açamaz. Bu ilk çalıştırmadır ve bölüm 2.12, İlk çalıştırma içinde yer alır.

Bu kurulum (Community)
Bu kurulum (Community)
Bir Community kurulumunun sahiplenildikten sonraki kendi sayfası: çalışan sürüm, motor sağlığı, disk kullanımı, yedeklemeler ve güvenlik düzeltmesi sözü; Enterprise bölümleri ise bunları kimin açabileceğini adlandıran tanıtımlar (teaser) olarak gösterilir.

Bu başarısız olursa

Çoğu hata kendini adlandırır. Herhangi bir şeyi değiştirmeden önce mesajı okuyun.

Gördüğünüz Neden Ne yapılmalı
INSTALLATION_NAME_MISSING veya INSTALLATION_NAME_EXAMPLE keys.installationName boş veya örnek değerde Kendi kalıcı adınızı ayarlayın
KEYS_CUSTODIAN_MISSING veya KEYS_CUSTODIAN_EXAMPLE Emanetçi yok veya örnekteki var Emanetçilerinizin kendi alıcılarını ayarlayın
keys.installationName ... does not match ^[a-z][a-z0-9-]{0,62}$ Büyük harfler, noktalar veya başta bir rakam Bir harfle başlayarak küçük harfler, rakamlar ve kısa çizgiler kullanın
keys.custody.recipients: ... ve bir neden Bir alıcı yanlış yazılmış, bir özel anahtar veya emanet Job'ının şifreleyemediği bir biçim Emanetçiden alıcısını tekrar isteyin
hosts.console is required (the installation identity) Bir ana bilgisayar (host) ayarlanmamış Üç ana bilgisayarı da ayarlayın
tls.existingSecret is required when tls.mode is existing Adlandırılmış Secret yok Ayarlayın veya tls.mode değerini değiştirin
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read Hesabınız API sunucusunun adreslerini okuyamıyor Bunları /32 aralıkları olarak verin
global.imageRegistry is required Kayıt defteri (registry) ayarlanmamış Ayarlayın
Helm zaman aşımına kadar bekler; nexus-auth, password authentication failed günlüğü kaydeder --wait verildi Kaldırın ve --wait olmadan tekrar kurun
Bir kancayı adlandıran Error: ... job failed Bir taşıma (migration) başarısız oldu kubectl -n nexus logs job/<hook-name> ve son satırlarını okuyun
Init içinde takılı kalmış bir pod Onun wait-for-schema konteyneri hala bekliyor Günlüğünü okuyun: eksik olduğu zinciri adlandırır
wait-for-schema: FAILED Zincirin kancası satırını hiç yazmadı Önce o kancanın hatasını bulun
ImagePullBackOff Düğüm global.imageRegistry üzerinden çekim yapamıyor Düğümün kayıt defterine ulaşabildiğini ve Enterprise için çekme belirtecine (pull token) sahip olduğunu kontrol edin

PostgreSQL'i bekleyen her kanca sınırlı bir süre bekler ve bunu waiting for postgres (12/60) olarak belirtir, böylece takılı kalmış bir veritabanı bir dakika içinde kancanın günlüğünde görünür.

nexusctl kurulum yolu

nexusctl install, etrafındaki kontroller sizin için çalıştırılarak aynı kurulumu yapar. Aynı values dosyasını alır:

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

Ön kontrolü tekrar çalıştırır ve herhangi bir kontrol başarısız olmaya başlamışsa durur. Chart paketinin imzasını sürüm anahtarına karşı doğrular. Ardından kurar, kancalar ve iş yükleri boyunca bekler ve her adımı ne kadar sürdüğüyle birlikte yazdırır. --edition community, sürümü (edition) dosyada olduğu gibi komut satırında da belirtir. --ca-bundle <file>, ön kontrolde olduğu gibi kendi CA sertifikalarınızı ekler. Çalıştırmadan, çalıştıracağı helm ve kubectl işlemlerini görmek için --explain ekleyin:

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

Bittiğinde, sahiplenme adresini, tek kullanımlık bir sahiplenme kodunu ve kurulumun parmak izini yazdırır:

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>

Kod üç gruptan oluşur ve beş denemeye izin verir; parmak izi dört karakterlik sekiz gruptan oluşur ve tarayıcı, sahiplenmeden önce karşılaştırmanız için aynı sekiz grubu gösterir.

Kuruluyor
Kuruluyor
Operatörün terminalinde çalışan kurulum. Her adım süresiyle birlikte yazdırılır ve çalıştırma tek kullanımlık bir kod ve kurulumun parmak iziyle sona erer; kurulum bir tarayıcıda sahiplenilene kadar kimse oturum açamaz.

İlk çalıştırmaya devir

Helm ile kurduysanız, ilk yönetici olacak kişiyi adlandırarak sahiplenme kodunu kendiniz oluşturun:

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

Küme erişiminizle nexus-keys pod'unda anahtar servisinin kendi sahiplenme kodu komutunu çalıştırır ve yukarıdaki gibi adresi, kodu ve parmak izini yazdırır. Kod 30 dakika boyunca çalışır; yeni bir tane için tekrar çalıştırın.

Buradan itibaren kontrolü tarayıcı devralır: kurulumu sahiplenin, bir geçiş anahtarıyla (passkey) ilk yöneticiyi oluşturun ve herhangi biri oturum açmadan önce altı adımı tamamlayın. Bu, bölüm 2.12, İlk çalıştırma konusudur. Enterprise sürümünü hemen lisanslayacaksanız, önce bölüm 2.7, Enterprise kurulumu ve lisans uygulama bölümünü okuyun, çünkü lisans bu altı adımdan biridir.