Oturum açınToplantı planlayın

Bölüm 2.8

Tek makineli kurulumlar

Nexus'u nexusctl ile tek bir Linux sunucusuna kurun veya k3d ile bir dizüstü bilgisayarda değerlendirin ve oturum açma ile geçiş anahtarlarının (passkey) çalışması için konsola HTTPS üzerinden erişin.

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

Harrow Port Authority, Nexus'u üretim kümesine koymadan önce Tomás Reilly iki küçük kurulum istedi. Bunlardan biri, sistemi ilk deneyecek on iki kişi için operasyon binasındaki yedek bir Linux sunucusunda yapılacak bir pilot kurulumdu. Diğeri ise kimse fark etmeden bir şeyleri bozabilmesi için kendi dizüstü bilgisayarında çalışıyordu. Bu bölüm her ikisini de kapsar. Tam bir Kubernetes kurulumuyla aynı chart'ı, aynı imajları ve aynı ilk çalıştırmayı kullanırlar; dolayısıyla tek bir makinede öğrendikleriniz diğerine de aktarılır.

Sunucu yolu tek bir komuttur: nexusctl install --single-node makinede bir k3s kümesi oluşturur, cert-manager'ı kurar ve ardından Nexus'u kurar. Dizüstü bilgisayar yolu daha uygulamalıdır. Bir k3d kümesini kendiniz oluşturur, cert-manager'ı ve chart'ı Helm ile kurar ve ardından neredeyse herkesin takıldığı ek bir işi yaparsınız: konsolu kendi makinenizde HTTPS arkasına alırsınız, çünkü düz bir port-forward kimsenin oturum açmasını sağlayamaz.

Makinenin ne kadar büyük olması gerekir

Nexus, chart'ın varsayılan değerleriyle taleplerde yaklaşık 2.05 CPU (merkezi işlem birimi) çekirdeği ve 6.7 GiB bellek ister ve birimleri toplamda 142 GiB tutar. Bu toplam; PostgreSQL 50, Valkey 5, Neo4j 20, Qdrant 10, nesne deposu 50, iki OpenBao deposu 1 ve 5 ve makbuz birimi 1 şeklindedir. Talepler zamanlayıcının ayırdığı miktardır ve insanlar çalışmaya başladığında gerçek kullanım daha yüksek seyreder.

Makine CPU Bellek (RAM, rastgele erişimli bellek) Disk
Önerilen tek düğüm 8 vCPU 32 GiB 250 GB SSD (katı hal sürücüsü)
Değerlendirme için asgari 4 vCPU 16 GiB 200 GB

Değerlendirme için asgari gereksinimleri karşılayan bir dizüstü bilgisayar Nexus'u çalıştıracaktır, ancak dizüstü bilgisayarın değil, Docker'ın kendi bellek sınırı geçerlidir. Başlamadan önce Docker'a en az 16 GiB verin.

Her iki yol da Kubernetes 1.33 veya sonrasını gerektirir. Tek düğümlü yol kendisininkini getirir: her sürümün üzerinde test edildiği dağıtım olan k3s v1.33.6+k3s1.

Birinci bölüm: nexusctl ile tek bir Linux sunucusu

Tomás'ın pilot sunucusu, üzerinde başka hiçbir şey olmayan güncel bir Linux çalıştıran, 32 GiB belleğe ve 500 GB SSD'ye sahip 8 çekirdekli bir makinedir. Kurulum, k3s'i bir sistem hizmeti olarak kurduğu için root yetkisi gerektirir.

nexusctl'yi edinin ve kontrol edin

  1. Mimariniz için nexusctl dosyasını, sürüm açık anahtarıyla birlikte https://downloads.adverant.ai/nexus/1.0.0-alpha.1/ adresinden indirin. Anahtarı release.pub olarak kaydedin. Bir sürümü edinme ve doğrulama başlıklı Bölüm 2.4, anahtarın parmak izini Adverant'ın yayınladığı parmak iziyle nasıl karşılaştıracağınızı açıklar.
  2. İkili dosyayı ve sürümü anahtarla kontrol edin:
nexusctl version --json
nexusctl verify

nexusctl verify, indirilen dosyayı Adverant sürüm anahtarıyla karşılaştırır ve doğrulayamadığı her şeyi reddeder. Başarısız olursa durun ve tekrar indirin. Doğrulanmamış bir dosyadan asla kurulum çalıştırmayın.

Yediemin anahtarını oluşturun

Kurulumun anahtar deposu, kurtarma anahtarlarını bir veya daha fazla yediemine mühürler. Yediemin, çevrimdışı olarak bir age kimlik dosyası tutan kişidir ve chart en az bir yediemin olmadan kurulmayı reddeder. Yedieminin kendi makinesinde:

age-keygen -o custodian.key

Dosya # public key: age1... satırıyla başlar. Değerler dosyasına giren kısım bu açık yarıdır. Kimlik dosyasının kendisi yedieminin makinesinden asla çıkmaz. Secure Enclave bulunan bir Mac'te age-plugin-se keygen --access-control=any-biometry -o custodian.key, kullanmak için Touch ID gerektiren bir anahtar oluşturur ve bunun açık yarısı age1se1 ile başlar.

Değerler dosyasını yazın

# harrow-pilot-values.yaml (Helm values)
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
keys:
  installationName: harrow-pilot
  custody:
    recipients:
      - "<custodian-age-recipient>"

<custodian-age-recipient>, custodian.key içindeki age1... satırıdır. Her yediemin için bir liste girdisi ekleyin.

keys.installationName kalıcıdır. Anahtar deposunun ilk başlatılışı, kurulumun kimliğini bu ad altında üretir ve sonrasında hiçbir şey bunu yeniden adlandıramaz. Şununla eşleşmelidir: ^[a-z][a-z0-9-]{0,62}$; küçük harf, bir harfle başlayan, en fazla 63 karakter. Chart'ın kendi örnek dosyalarından nexus-example değerini veya örnek alıcıyı kopyalamayın. Chart her ikisini de adlarıyla reddeder ve ön kontrol (preflight) önce aynı kodları bildirir.

Bu üç ana bilgisayar adı kurulumun kimliğidir. Bunlar olmadan her hizmet başlamayı reddeder ve her oturum açma işlemi, çerez ve geçiş anahtarı (passkey) hosts.console değerine bağlıdır. Beş yıl sonra bile isteyeceğiniz adları seçin.

Üç adı sunucuya yönlendirin

Kullanıcılar konsola, API'ye (uygulama programlama arayüzü) ve oturum açma hizmetine k3s'in yerleşik ingress denetleyicisi olan Traefik üzerinden, sunucunun 80 ve 443 numaralı bağlantı noktalarından ulaşır. Her biri sunucunun adresini gösteren console.harrow.example, api.harrow.example ve auth.harrow.example için üç DNS (Alan Adı Sistemi) kaydı ekleyin. Ön kontrol her adı kontrol eder ve hangisinin kaydı olmadığını size söyler.

Chart'ın ağ politikası, üç açık hizmete yalnızca bir ad alanının (namespace) ulaşmasına izin verir. Varsayılan değeri olan kube-system, k3s'in Traefik'i çalıştırdığı yerdir; bu nedenle tek bir düğümde networkPolicy.ingressNamespace değerine dokunmazsınız.

Ön kontrolü çalıştırın, ardından kurun

  1. Ön kontrolü tek düğüm bayrağıyla çalıştırın. Makineyi ve değerler dosyanızı okur ve hiçbir şeyi değiştirmez.
sudo nexusctl preflight --single-node --values harrow-pilot-values.yaml
  1. Sondaki özet satırını okuyun. Bir uyarı kurulumu asla engellemez ancak bir hata engeller ve başarısız olan her satır bir fix satırı taşır.
 ────────────────────────────────────────────────────────────
 9 passed · 1 warning · 0 failed   You can install. Warnings do not block; fix them when you can.
 Report saved to preflight-2026-11-12-0902.txt · nothing was changed
  1. Kurun. --edition bayrağı, değerler dosyasındaki edition ile uyuşmalıdır.
sudo nexusctl install --single-node --values harrow-pilot-values.yaml --edition community
  1. Çalışmasını izleyin. Ön kontrolü tekrar çalıştırır, k3s v1.33.6+k3s1 kurar, cert-manager v1.21.3 kurar, Nexus'u kurar ve her hizmetin sağlık kontrolüne yanıt vermesini bekler. Tomás'ın sunucusunda bu işlem on dakikadan biraz az sürdü.
 done   Preflight again        9 passed · 1 warning
 done   k3s v1.33.6+k3s1       node Ready
 done   cert-manager v1.21.3   ready
 done   Database and search    ready
 done   Engines                started
 done   Console                https://console.harrow.example
 Installed. 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:
 3F9A C21B 77E0 5D4C 9B12 A6F3 0E88 41D7

Bu parmak izini ekranda tutun. Kurulumu kodla sahiplenirken bunu tarayıcıda karşılaştıracaksınız. Kodu siz kullanmadan önce süresi dolarsa, nexusctl claim-code --administrator <email> yeni bir kod oluşturur. İlk çalıştırma başlıklı Bölüm 2.12 buradan devralır.

Community sürümünü kurun
Community sürümünü kurun
Tek bir sunucuda Community kurulumu; indirme, kontrol etme, ön kontrol ve kurulum, ardından ilk yöneticiden ibarettir. Lisans adımı yoktur.

Sertifikayı yerine koyun

tls.mode: existing ile, üç ingress yönlendirmesi tls.existingSecret tarafından adlandırılan Secret içindeki sertifikayı sunar. Bu sertifika her üç ana bilgisayar adını da kapsamalıdır. Ön kontrol, mevcut olduğunda bu Secret'ı okur ve sertifikanın süresi 30 gün içinde doluyorsa uyarır. Secret henüz orada olmadığında, satır size onu oluşturmanızı söyler ve bu bir hata değil, bir uyarıdır.

Tek bir düğümde küme, kurulum onu oluşturana kadar mevcut değildir; bu nedenle Secret'ı kurulumdan hemen sonra oluşturun. Önce kümenin kubeconfig dosyasını dışarı yazın (bu bölümün son kısmı bunu açıklar), ardından onunla Secret'ı oluşturun:

sudo nexusctl kubeconfig > harrow-pilot.kubeconfig
chmod 600 harrow-pilot.kubeconfig
export KUBECONFIG=$PWD/harrow-pilot.kubeconfig
kubectl -n nexus create secret tls harrow-public-tls --cert=harrow-public.crt --key=harrow-public.key

harrow-public.crt sertifikayı ve ardından gelen tüm ara sertifikaları, harrow-public.key ise bunun özel anahtarını tutar. Sertifikalarınız özel bir CA'dan (sertifika yetkilisi) geliyorsa, zinciri kontrol edebilmeleri için nexusctl preflight ve nexusctl install, --ca-bundle <file> alır. TLS'i (Taşıma Katmanı Güvenliği) yönetmenin diğer yolları, Varyasyonlar: harici depolar, TLS ve ingress başlıklı bölüm 2.11'dedir.

Bu başarısız olursa

Gördüğünüz Anlamı Ne yapılmalı
PREFLIGHT_FAILED (409) Ön kontrol bir hata buldu, bu yüzden kurulum başlamadı. Hiçbir şey kurulmadı. Başarısız olan her satırı fix satırını kullanarak düzeltin ve kurulumu tekrar çalıştırın.
INSTALLATION_NAME_MISSING keys.installationName boş. Kurulumun kendi kalıcı adını ayarlayın.
INSTALLATION_NAME_EXAMPLE Ad, chart'ın örnek değerlerindeki addır. Kendi adınızı seçin.
KEYS_CUSTODIAN_MISSING keys.custody.recipients boş. Her yedieminin açık age1... alıcısını ekleyin.
KEYS_CUSTODIAN_EXAMPLE Bir alıcı, kimliğini kimsenin tutmadığı, chart'ın örnek yedieminidir. Bunu kendi yedieminlerinizin alıcılarıyla değiştirin.

nexusctl devam edebildiğinde 0, bir kontrol onu engellediğinde 1 ve hiç çalışamadığında (okunamayan bir değerler dosyası, yanlış bir bayrak) 2 ile çıkar. Bir betik bu üç duruma göre dallanabilir.

İkinci bölüm: k3d ile bir dizüstü bilgisayarda değerlendirme

k3d, k3s'i Docker kapsayıcıları içinde çalıştırır; böylece tüm bir küme bir dizüstü bilgisayarda yaşar ve tek bir komutla kaybolur. Her Nexus sürümünü test eden sürüm araçları kümelerini tam olarak bu şekilde oluşturur ve onların ayarlarını kopyalamak, halihazırda karşılaştıkları sorunları yeniden keşfetmekten sizi kurtarır.

Docker, k3d 5.8.3, kubectl, Helm v4 ve Chrome'a ihtiyacınız vardır. Tomás kendi Mac'ini kullandı.

Kümeyi oluşturun

k3d cluster create harrow-eval --agents 0 --wait --timeout 300s \
  --image rancher/k3s:v1.33.6-k3s1 \
  --k3s-arg "--disable=traefik@server:0"
k3d kubeconfig get harrow-eval > harrow-eval.kubeconfig
chmod 600 harrow-eval.kubeconfig
export KUBECONFIG=$PWD/harrow-eval.kubeconfig

Her bayrağın bir nedeni vardır.

  • --agents 0 bir sunucu düğümü verir ve işçi (worker) düğüm vermez. Nexus tek bir düğümde sorunsuzca çalışır ve ikincisi yalnızca bellek maliyetine yol açar.
  • --image rancher/k3s:v1.33.6-k3s1, her sürümün üzerinde test edildiği k3s sürümünü sabitler. Bu olmadan, k3d'nin varsayılanı neyse onu alırsınız.
  • --disable=traefik@server:0 Traefik'i dışarıda bırakır. Bir dizüstü bilgisayarın hizmet verecek açık bir adresi yoktur ve konsola bunun yerine kendi HTTPS ön uç noktanız üzerinden ulaşırsınız (aşağıda).
  • --wait --timeout 300s yalnızca küme yanıt verdiğinde döner veya beş dakika sonra başarısız olur.

Sürüm kayıt defterini (registry) dizüstü bilgisayarınızda yansıtıyorsanız (mirror), imaj çekme işlemlerini yansıya göndermek için --registry-config <registries.yaml> ve hiçbir şeyin üst (upstream) kayıt defterine geri dönmemesi için --k3s-arg "--disable-default-registry-endpoint@server:0" ekleyin. Sürüm araçları, her imaj yalnızca yansı üzerinden gelecek şekilde bu biçimde çalışır.

cert-manager'ı kurun

Chart, bir cert-manager yayıncısı (issuer) olarak kendi yerel CA'sını, yani nexus-local-ca öğesini oluşturur ve her hizmet sertifikasını ondan alır. Kümede cert-manager kaynakları olmadan, helm install saniyeler içinde chart'ı reddeder. Önce cert-manager projesinin yayınladığı chart'tan cert-manager v1.21.3'ü kurun:

helm install cert-manager cert-manager-v1.21.3.tgz -n cert-manager \
  --create-namespace --set crds.enabled=true --wait --timeout 10m

Nexus'un cert-manager'dan başka hiçbir şeye ve özellikle de trust-manager'a ihtiyacı yoktur.

Nexus'u kurun

  1. Dizüstü bilgisayar için bir değerler dosyası yazın. TLS kendi ön uç noktanızda sonlanır, bu nedenle tls.mode değeri none olur.
# harrow-eval-values.yaml (Helm values)
global:
  imageRegistry: registry.adverant.ai
  domain: harrow.example
hosts:
  console: console.harrow.example
  api: api.harrow.example
  auth: auth.harrow.example
edition: community
tls:
  mode: none
keys:
  installationName: harrow-eval
  custody:
    recipients:
      - "<custodian-age-recipient>"
  1. Chart'ı kayıt defterinden kurun ve --wait bayrağını dışarıda bırakın (aşağıdaki uyarı nedenini açıklar).
helm install nexus oci://registry.adverant.ai/nexus/charts/nexus --version 1.0.0-alpha.1 \
  -n nexus --create-namespace -f harrow-eval-values.yaml --timeout 45m
  1. Ardından iş yüklerini kendiniz bekleyin:
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
for s in $(kubectl -n nexus get sts -o name); do
  want=$(kubectl -n nexus get "$s" -o jsonpath='{.spec.replicas}')
  kubectl -n nexus wait "$s" --for=jsonpath='{.status.readyReplicas}'="$want" --timeout=900s
done

StatefulSet döngüsü oradadır çünkü bunlardan bazıları istek üzerine her seferinde bir pod günceller ve kubectl rollout status bunları reddeder. readyReplicas üzerinde beklemek her güncelleme stratejisi için çalışır.

Her iki komut da döndüğünde, her Deployment kullanılabilir (Available) durumdadır ve her StatefulSet'in pod'ları hazırdır. Henüz kimse oturum açamaz. Bu doğrudur: kurulum henüz sahiplenilmemiştir.

Port yönlendirme (port-forward) neden hiçbir zaman oturum açmanızı sağlayamaz

Akla gelen bir sonraki hamle kubectl port-forward svc/nexus-alpha 3000:3000 ve http://127.0.0.1:3000 üzerinde bir tarayıcı açmaktır. Konsolun sayfaları yüklenir, bu yüzden çalışıyormuş gibi görünür. Çalışmaz ve hiçbir ayar onu çalıştırmaz. Her biri kasıtlı olarak konmuş üç şey buna engel olur.

Onu ne durdurur Nedeni
Köken (origin) Konsolun oturum açma işlemi, kökeni https://<hosts.console>, yani burada https://console.harrow.example olmayan bir isteği reddeder. http://127.0.0.1:3000 adresinden sunulan bir sayfa yanlış kökene sahiptir, bu nedenle oturum açma işlemi asla başlamaz.
Çerez Oturum, Secure olarak işaretlenmiş bir __Host- çerezidir. Tarayıcılar böyle bir çerezi yalnızca HTTPS üzerinden, alan adı özniteliği olmadan, yalnızca onu ayarlayan ana bilgisayar için saklar. Düz HTTP üzerinden tarayıcı bunu atar.
Geçiş anahtarı İlk yönetici bir geçiş anahtarıyla oturum açar ve bir geçiş anahtarı, geçerli bir sertifikaya sahip güvenli bir bağlam gerektirir. Chrome, tıklayıp geçmiş olsanız bile bir sertifika uyarısının arkasında geçiş anahtarı oluşturmayı reddeder.

Dolayısıyla tarayıcının güvendiği bir sertifikayla https://console.harrow.example ile konuşması ve bu adın dizüstü bilgisayarınıza çıkması gerekir.

Dizüstü bilgisayarınızda konsola HTTPS üzerinden erişme

Aşağıdaki yöntem; sertifikayı vermek için chart'ın kendi CA'sını, konsola ulaşmak için bir port-forward'ı ve yalnızca bu CA'ya güvenen ve konsolun adını dizüstü bilgisayarınızla eşleyen ayrı bir Chrome profilini kullanır. Sistem güven deponuz ve /etc/hosts olduğu gibi kalır.

Şema solda "ayrı profil: yalnızca nexus-local-ca'ya güvenir; console.harrow.example:443, 127.0.0.1:28443 adresine eşlenmiş" etiketli Chrome'u gösterir. "HTTPS" etiketli bir ok, "127.0.0.1:28443 üzerinde HTTPS ön uç noktası (sertifika nexus-local-ca'dan)" kutusuna gider. "HTTP, Host korunur, X-Forwarded-Proto https" etiketli bir ok "kubectl port-forward 127.0.0.1:3000" kutusuna gider ve son bir ok k3d kümesi kutusunun içindeki "Service nexus-alpha, port http (3000)" öğesine gider. Küme içindeki cert-manager'dan ön uç kutusuna giden noktalı bir çizgi "sertifikayı verir" olarak etiketlenmiştir.
Dizüstü bilgisayardaki bir tarayıcı, k3d kümesindeki konsola HTTPS üzerinden nasıl ulaşır.

Konsolun adı için bir sertifika verin

  1. cert-manager'dan konsol ana bilgisayarı için chart'ın yayıncısı tarafından imzalanmış bir sertifika isteyin:
# console-front-certificate.yaml (a cert-manager Certificate)
apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
  name: nexus-console-front
  namespace: nexus
spec:
  secretName: nexus-console-front-tls
  dnsNames: [console.harrow.example]
  duration: 24h
  usages: [server auth, digital signature, key encipherment]
  privateKey: { algorithm: ECDSA, size: 256, rotationPolicy: Always }
  issuerRef: { name: nexus-local-ca, kind: Issuer, group: cert-manager.io }
kubectl apply -f console-front-certificate.yaml
kubectl -n nexus wait --for=condition=Ready certificate/nexus-console-front --timeout=120s

cert-manager bunu küme içinde imzalar. CA'nın özel anahtarını asla okumazsınız.

  1. Sertifikayı, anahtarını ve CA sertifikasını Secret'tan dışarı kopyalayın:
kubectl -n nexus get secret nexus-console-front-tls -o jsonpath='{.data.tls\.crt}' | base64 -d > tls.crt
kubectl -n nexus get secret nexus-console-front-tls -o jsonpath='{.data.tls\.key}' | base64 -d > tls.key
kubectl -n nexus get secret nexus-console-front-tls -o jsonpath='{.data.ca\.crt}' | base64 -d > ca.crt
chmod 600 tls.key
  1. CA'nın pin değerini hesaplayın. Chrome, güvenilen bir anahtarı açık anahtarının base64 SHA-256 değeriyle tanımlar:
openssl x509 -in ca.crt -pubkey -noout | openssl pkey -pubin -outform der | openssl dgst -sha256 -binary | base64

Sertifikanın değil, CA'nın anahtarını sabitleyin (pin). Sertifika bir gün geçerlidir ve cert-manager onu her yenilediğinde yeni bir anahtar alır, oysa CA aynı kalır.

Bir port-forward'ın önüne bir HTTPS ön uç noktası koyun

  1. Konsolun Service kaynağını yönlendirin. Bağlantı noktası, bu sürümde 3000 olan ve http olarak adlandırılan bağlantı noktasıdır:
kubectl -n nexus port-forward svc/nexus-alpha 3000:3000
  1. 127.0.0.1:28443 üzerinde, 127.0.0.1:3000 adresine yönlendirme yapan bir HTTPS dinleyicisi çalıştırın. Halihazırda güvendiğiniz herhangi bir ters vekil sunucu (reverse proxy), şu dört şeyi yaptığı sürece iş görecektir:
    • zincir olarak tls.crt ve ardından ca.crt dosyalarını, tls.key ile sunar;
    • Host üstbilgisini console.harrow.example olarak tutar;
    • X-Forwarded-Proto: https ayarlar;
    • WebSocket yükseltmelerini geçirir, çünkü konsol bunları kullanır.

Bir Service kaynağına yapılan port-forward, başladığında seçtiği tek pod'a bağlanır. Bir yükseltme veya yeniden başlatma konsol pod'unu değiştirdikten sonra, yönlendirme açık kalır ve hiçbir yere yönlendirme yapmaz ve tarayıcı hatalı ağ geçidi (bad gateway) gösterir. Konsol pod'u her değiştiğinde port-forward'ı yeniden başlatın.

Chrome'u pin ve ad eşlemesiyle açın

Bir Mac'te:

open -na "Google Chrome" --args --user-data-dir="$HOME/.nexus-eval-chrome" \
  "--host-resolver-rules=MAP console.harrow.example:443 127.0.0.1:28443" \
  "--ignore-certificate-errors-spki-list=<ca-pin>" \
  https://console.harrow.example/install

<ca-pin>, openssl satırının çıktısıdır. Linux'ta Chrome'u aynı üç bayrakla başlatın.

Üç bayrak birlikte çalışır. --host-resolver-rules, yalnızca bu profil içinde 443 numaralı bağlantı noktasındaki console.harrow.example trafiğini ön uç noktanıza gönderir. --ignore-certificate-errors-spki-list, yalnızca bu CA anahtarı tarafından verilen sertifikalara güvenir ve Chrome bunu yalnızca --user-data-dir ile dikkate alır. Ayrı profil, istisnayı günlük tarama işlemlerinizden uzak tutar. Bu, genel bir "sertifika hatalarını yoksay" anahtarı değildir: kümenin CA'sı tarafından imzalanmamış her şey yine başarısız olur.

Bu profil açıkken https://console.harrow.example/install sahiplenme sayfasına gider ve bir geçiş anahtarı oluşturulabilir. İlk çalıştırma başlıklı Bölüm 2.12 buradan devam eder.

Dizüstü bilgisayar yeniden başladığında

Anahtar deposunun iki parçası vardır: anahtar deposunun kendisi ve kilit açma anahtarını tutan küçük bir mühür açıcı (unsealer). Düğümün herhangi bir yeniden başlatılmasından sonra (bir Docker yeniden başlatması, dizüstü bilgisayarın yeniden başlatılması, k3d cluster stop ve start) mühür açıcı mühürlü olarak başlar. Anahtar deposu kendi mührünü onun üzerinden açar; bu nedenle bir yediemin kendi age kimliğiyle mühür açıcının mührünü açana kadar anahtara ihtiyaç duyan hiçbir şey çalışmaz. Bu, tasarımın bir özelliğidir ve bir üretim kümesinde de aynıdır. İkinci gün: Nexus'u işletme başlıklı Bölüm 2.15 mühür açma işlemini gösterir.

Değerlendirmeyi bitirdiğinizde:

k3d cluster delete harrow-eval

Kümeyi silmek, kurulumu ve içindeki her şeyi siler.

nexusctl kubeconfig

nexusctl install --single-node komutunun oluşturduğu bir küme nexusctl aracına aittir. Ona kubectl, helm veya başka herhangi bir araçla ulaşmak için kubeconfig dosyasını isteyin:

sudo nexusctl kubeconfig > harrow-pilot.kubeconfig
chmod 600 harrow-pilot.kubeconfig
export KUBECONFIG=$PWD/harrow-pilot.kubeconfig
kubectl -n nexus get deploy,statefulset

Bu dosya kümeye tam yönetici erişimi sağlar. Dosyayı 600 modunda, kurulumu yürüten kişilerin makinelerinde tutun ve başka hiçbir yerde bulundurmayın. Kısım 2'de --context alan veya KUBECONFIG okuyan sonraki her komut, bu dosya aracılığıyla tek bir düğüme karşı çalışır. Aynı durum bir yükseltme için de geçerlidir: tek bir düğümde nexusctl upgrade plan --bundle <file> ve nexusctl upgrade apply --bundle <file>, nexusctl aracının sahip olduğu k3s kümesini de yükseltir.

Şema, "tek bir Linux sunucusu" etiketli bir kutu üzerinde dört katmandan oluşan bir yığındır. Alttan yukarıya: "k3s v1.33.6+k3s1 (kube-system içinde Traefik, bağlantı noktaları 80 ve 443)", ardından "cert-manager v1.21.3 ve chart'ın yerel CA'sı nexus-local-ca", ardından "Nexus veri katmanı: PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS, OpenBao", ardından "Nexus hizmetleri: konsol, oturum açma, ağ geçidi ve geri kalanlar". Sağda, en üst katmandan çıkan üç ok kutudan ayrılarak console.harrow.example, api.harrow.example ve auth.harrow.example olarak etiketlenir. Solda, "nexusctl kubeconfig" etiketli bir uçbirim simgesi k3s katmanını işaret eder.
nexusctl install --single-node komutunun tek bir Linux sunucusuna kurdukları.

Bir kümeye neler taşınır

Tek bir makinede yaptığınız her şeyin bir kümede karşılığı vardır. Varyasyonlar: harici depolar, TLS ve ingress başlıklı bölüm 2.11'in gösterdiği gibi, değerler dosyası farklı bir kayıt defteri, TLS modu veya depolama sınıfına sahip aynı dosyadır. İlk çalıştırma birebir aynıdır. Aktarılmayan şey kurulumun kendisidir: kurulum adı kalıcı olarak sabitlenir ve bir kurulum bir dizüstü bilgisayardan alınıp bir sunucuya taşınamaz. Tomás dizüstü bilgisayarından pilot sunucuya geçtiğinde yeni bir adla, yani harrow-pilot ile baştan başladı ve harrow-eval kurulumunu denemeler için tuttu.