Sürüm 1.0.0-alpha.1en son
Bölüm 2.17
Sorun giderme
Operatörlerin en sık karşılaştığı, gördüğünüz belirtilere göre düzenlenmiş sorunlar. Her biri nedeni, bunu doğrulayan komutu ve çözümü verir ve bölüm bir destek paketi gönderilmesiyle sona erer.
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

Bir Nexus kurulumunda ters giden şeylerin çoğu aynı bir düzine yoldan biriyle ters gider ve neredeyse tamamı kendisini bir kodla belli eder. Bu bölüm, her bir sorunla kabaca karşılaşacağınız sıraya göre, gördüklerinize dayalı olarak düzenlenmiştir: kurulum, sahiplenme, lisanslama ve ardından çalıştırma. Her biri için nedeni, bunu doğrulayan bir komutu ve çözümü bulacaksınız.
Örneklerde Harrow Port Authority'nin kurulumu kullanılmaktadır: ad alanı nexus, sürüm nexus, ana bilgisayarlar console.harrow.example, api.harrow.example ve auth.harrow.example. Bunları kendinizinkilerle değiştirin. Buradaki her sorunda zaman kazandıran üç alışkanlık şunlardır:
- Mesajdan önce kodu okuyun. Nexus'taki her ret bir makine koduyla biter ve bu bölümün dizini bu koda göre oluşturulmuştur.
- Kümede veya değerler dosyasında yapılan herhangi bir değişiklikten sonra
nexusctl preflightkomutunu tekrar çalıştırın. Kümeyi değiştirmeden okur ve çoğu chart reddini Helm'den önce adıyla bildirir. - Emin olmadığınız herhangi bir
nexusctleyleminde--explainkullanın.kubectlvehelmişlemlerini çalıştırmadan yazdırır.
Kurulum takılıyor
Kurulumu çalıştırdınız ve bitmedi. helm on beş dakika sonra yanıt vermedi ya da yanıt verdi ancak pod'lar hâlâ Init veya Pending durumunda ya da konsol adresi yanıt vermiyor.
En yaygın neden helm install --wait kullanımıdır. Nexus; veritabanını, rollerini ve her hizmetin şemasını kurulum sonrası kancalarında (post-install hooks) oluşturur ve her hizmete veritabanı parolasını veren de önyükleme kancasıdır (bootstrap hook). --wait kullanıldığında Helm, bu kancaları çalıştırmadan önce Deployment'ların hazır olmasını beklerken, Deployment'lar da kancaları bekler. İkisi de ilerleyemez. Asla --wait ile kurulum yapmayın; onsuz kurun ve sonrasında bekleyin.
Diğer nedenler sıradan Kubernetes sorunlarıdır. global.imageRegistry yanlış kayıt defterini (registry) belirttiği için veya bir Enterprise kurulumunda çekme belirteci (pull token) olmadığından imajlar çekilemiyordur. Depolama sınıfı (storage class) mevcut olmadığı için bir birim Pending durumunda kalıyordur. cert-manager eksiktir; bu durumda kurulum hiç takılmaz: chart'ın sertifika verenlerinin (certificate issuers) cert-manager kaynaklarına ihtiyaç duyması nedeniyle saniyeler içinde başarısız olur.
Pod'lar ve kanca Job'ları ile başlayın:
kubectl -n nexus get pods,jobs
kubectl -n nexus describe pod <pod-name>
kubectl -n nexus logs job/<job-name>
kubectl get crd certificates.cert-manager.iodescribe, olaylarında imaj çekme hatalarını ve bağlanmamış birimleri gösterir. Başarısız bir pod ile 0/1 tamamlanma gösteren bir kanca Job'ı kurulumu durdurmuştur; çünkü kanca Job'larının geri çekilme sınırı (backoff limit) 0'dır ve asla sessizce yeniden denenmezler. Günlüğü (log) nedenini söyler.
Her bir nedenin çözümü aşağıda açıklanmıştır:
- Helm
--waitile bekliyorsa durdurun, kaldırın ve bayrak (flag) olmadan tekrar kurun. Ardından hizmetleri bekleyin:
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s- Çekme hataları için
global.imageRegistrydeğerini ve Enterprise için hesabınızın Çekme belirteçleri ve kurulum komutları (Pull tokens and install commands) sayfasındaki çekme belirtecini kontrol edin. Pendingbirimleri içinstorage.classNamedeğerini kümenin sahip olduğu bir depolama sınıfına ayarlayın veya bir tanesini varsayılan yapın.- Eksik bir cert-manager için cert-manager v1.21.3 kurun ve kurulumu tekrar çalıştırın.
- Başarısız bir kanca için, günlüğünde belirtilen sorunu düzeltin ve kurulumu tekrar çalıştırın.
Bir pod şemasını bekliyor
Bir hizmetin pod'u dakikalarca Init:0/1 durumunda bekliyor. Veritabanını kullanan her hizmetin, sürüm defteri (release ledger) bu sürümün imajı için taşıma işlemlerinin (migrations) uygulandığını gösterene kadar pod'u bekleten wait-for-schema adlı bir başlatma kapsayıcısı (init container) vardır. Bu, bir kurulumun veya yükseltmenin ilk dakikalarında, taşıma kancaları çalışırken normaldir. Bitmediğinde ise bir sorundur.
Başlatma kapsayıcısının günlüğünü okuyun:
kubectl -n nexus logs <pod-name> -c wait-for-schemaGünlük; bileşeni, beklediği taşıma zincirlerini ve süre sınırını belirtir, ardından durumu her değiştiğinde bir satır yazdırır:
wait-for-schema: nexus-auth waits for nexus_release.schema_applied (read as nexus_ledger_reader) to show: nexus-auth-migrations=sha256:…; gives up after 1800s
| İlerleme satırının söylediği | Anlamı |
|---|---|
| Bu sürüm için hâlâ uygulanması gereken zincirler | Belirtilen taşıma kancaları bitmemiştir. Bu Job'lara bakın. |
| Veritabanı hatasıyla birlikte sürüm defterinin okunamadığı | Postgres yanıt vermiyordur veya veritabanı önyüklemesi çalışmadığı için defter mevcut değildir. |
FAILED (<component>): after <n>s, … |
schemaWait.timeoutSeconds (varsayılan olarak 1.800) sonrasında vazgeçmiştir. Başlatma kapsayıcısı yeniden başlar; hizmetin kendisi hiç başlamamıştır. |
Hiçbir zaman uygulanmayan bir zincir, neredeyse her zaman taşıma Job'ının başarısız olduğu anlamına gelir. kubectl -n nexus get jobs ile bulun ve günlüğünü okuyun. Belirttiği sorunu (dolu bir disk, taşıyıcının ulaşamadığı harici bir veritabanı, bir rol çakışması) düzeltin ve aynı değerlerle helm upgrade komutunu çalıştırın: kancalar tekrar çalışır ve her birinin yeniden çalıştırılması güvenlidir.
schemaWait.timeoutSeconds değerini yalnızca bir taşıma işlemi yavaş ve sağlıklı olduğunda (yavaş depolama alanındaki büyük bir ilk taşıma işleminin olabileceği gibi) artırın. Başarısız bir Job'ı gizlemek için bu değeri artırmak, pod'un asla gerçekleşmeyecek bir şey için daha uzun süre beklemesine neden olur.
Anahtar deposu mühürlü
Bir elektrik kesintisi, düğümün (node) yeniden başlatılması veya kapsayıcı çalışma zamanının (container runtime) yeniden başlatılmasından sonra pod'lar geri gelir ve konsol yüklenir, ancak anahtar gerektiren her şey başarısız olur veya bekler. Mühür açıcı (unsealer), düğümünün her yeniden başlatılmasından sonra mühürlü olarak başlar ve mühür açıcı açılana kadar anahtar deposu (key store) kendi mührünü açamaz.
Her pod'daki OpenBao'ya sorun:
kubectl -n nexus exec openbao-unsealer-0 -c openbao -- \
bao status -format=json -address=https://127.0.0.1:8200 \
-ca-cert=/openbao/tls/ca.crt -tls-server-name=openbao-unsealer
echo "exit $?"0 çıkış kodu mührün açık olduğunu, 2 mühürlü olduğunu ve 1 yanıt veremediğini gösterir (bir dakika sonra tekrar sorun). Anahtar deposu için -tls-server-name=openbao ile openbao-0 üzerinde de aynısını çalıştırın. Mühür açıcının mührü açıksa ve anahtar deposununki değilse, anahtar deposu kendi mührünü açıyordur; bir dakika bekleyin.
Mühürlü bir mühür açıcıyı düzeltmek için, bir emanetçi (custodian) kendi age kimliğiyle chart'ın unseal.sh betiğini çalıştırır. Bölüm 2.15, İkinci gün: Nexus'u işletme, tam komutu içerir. Betiğin çıkış kodu size ne olduğunu söyler:
| Çıkış kodu | Anlamı | Ne yapılmalı |
|---|---|---|
| 0 | Mühür açıldı | Bir dakika içinde kubectl -n nexus get deploy,statefulset kontrolü yapın. |
| 1 | Hala mühürlü veya mühür açma çağrısı başarısız oldu | Yazdırdığı pay (share) satırlarını okuyun; tekrar çalıştırın. |
| 2 | Bir ön koşul eksik | Mesaj bunu belirtir: AGE_IDENTITY, age veya jq gibi bir ikili dosya (binary) ya da bir doğrudan mod ayarı. |
| 3 | Bu kimlik payların şifresini çözemiyor | Bu kurulumun emanetçisi değilsiniz. Hiçbir şey gönderilmedi. Emanetçi olan birini bulun. |
HTTP üzerinden oturum açamıyorsunuz
Konsol bir http:// adresinde veya 127.0.0.1 hedefine bir kubectl port-forward üzerinden yükleniyor ve oturum açma başarısız oluyor. Geçiş anahtarı (passkey) istemi hiç görünmüyor veya oturum açma işlemi başa dönüp duruyor.
Oturum açma işlemi konsolun kendi HTTPS kökenine (origin) ihtiyaç duyar. Konsol yalnızca https://<hosts.console> üzerinden oturum açmayı kabul eder, oturumu Secure olarak işaretlenmiş bir __Host- çerezinde tutar (ki bir tarayıcı bunu yalnızca HTTPS üzerinden saklar) ve ilk yöneticinin geçiş anahtarı geçerli bir sertifikaya sahip bir sayfaya ihtiyaç duyar. Tarayıcılar bir sertifika hatasının arkasındaki geçiş anahtarlarını reddeder. http://127.0.0.1 hedefine yapılan bir port yönlendirme (port-forward) ile asla oturum açılamaz.
Tarayıcının gerçekte neye ulaştığını kontrol edin:
curl -sI https://console.harrow.example
kubectl -n nexus get ingressİlki, makinenizin güvendiği bir sertifikayla HTTPS üzerinden yanıt vermelidir. İkincisi, hosts.* içinde ayarladığınız adlara sahip üç ana bilgisayarı göstermelidir.
Bunu düzeltmek için, tarayıcının güvendiği bir sertifikayla hosts.console içindeki tam ad olan https://console.harrow.example adresinden konsola ulaşın. tls.mode: existing ile, tls.existingSecret kaynağının her üç ana bilgisayar için de bir sertifika tuttuğunu kontrol edin. tls.mode: cert-manager ile, ClusterIssuer'ın sertifikayı verdiğini kontrol edin. tls.mode: none ile, Taşıma Katmanı Güvenliği (TLS) kendi yük dengeleyicinizde sonlanır ve sertifikanın doğru olması gereken yer orasıdır. Özel bir sertifika yetkilisi (CA) için, sertifikasını yöneticilerinizin oturum açtığı makinelere kurun.
Sahiplenme kodunun süresi doldu
Bu kurulumu sahiplen (Claim this installation) sayfasında, sayfa kodu CLAIM_CODE_EXPIRED (410) ile reddediyor. Sahiplenme kodu dört karakterlik üç gruptan oluşur. 30 dakika boyunca, 5 deneme hakkıyla bir kez çalışır. Bundan sonra veya beşinci yanlış denemeden sonra geçersiz olur ve hiçbir şey sahiplenilmez veya değiştirilmez.
Küme erişimi olan uçbirimden (terminal) yeni bir kod oluşturun:
nexusctl claim-code --administrator aoife.brennan@harrow.exampleYeni bir kod ve kurulumun parmak izini yazdırır. Kodu 30 dakika içinde sahiplenme sayfasına girin ve parmak izini tekrar karşılaştırın.
İlgili iki yanıt:
- Sahiplenme sayfasındaki
RATE_LIMITED(429), sayfada son bir dakika içinde birkaç deneme yapıldığı anlamına gelir. Verdiği saniye sayısı kadar bekleyin. Bu denemeleri siz yapmadıysanız, ağınızdaki başka biri sayfayı deniyordur; sahiplenmeden önce kimin denediğini öğrenin. TRANSITION_NOT_PERMITTED(409), kurulumun zaten sahiplenildiği ve sahiplenme sayfasının tamamen kapatıldığı anlamına gelir. Bunun yerine oturum açın. Kurulumu siz sahiplenmediyseniz, bunu bir güvenlik olayı olarak ele alın.
Parmak izi eşleşmiyor
Sahiplenme sayfası CLAIM_FINGERPRINT_MISMATCH (403) gösteriyor veya sayfadaki sekiz adet dörtlü grubun uçbiriminizin yazdırdıklarından farklı olduğunu kendiniz görebiliyorsunuz. Tek bir grubun bile farklı olması, tarayıcının farklı bir kurulumla konuştuğu anlamına gelir.
Durun. Kodu o sayfaya yazmayın. O adreste kurulumunuz dışında bir şey, muhtemelen ilk yöneticiyi yakalamak için kurulmuş bir makine yanıt veriyor olabilir. Sahiplenirseniz, o makine kuruluşunuzu ele geçirir. Kendi kurulumunuz ise değişmemiştir ve hâlâ sahiplenilmemiştir.
Adın nereyi işaret ettiğini ve hangi sertifikanın yanıt verdiğini kontrol edin:
nslookup console.harrow.example
kubectl -n nexus get ingress
curl -svI https://console.harrow.exampleAdres, ingress denetleyicinizin adresi olmalı ve sertifika, hosts.console için kurduğunuz sertifika olmalıdır.
Bunu düzeltmek için, güvenlik ekibinize yanıt veren adresi verin ve kurulumun yazdırdığı parmak izini kaydeden kurulum günlüğünü saklayın. Sizi başka bir yere gönderen Alan Adı Sistemi (DNS) kaydını veya vekil sunucuyu (proxy) düzeltin. Ardından nexusctl claim-code --administrator <email> ile yeni bir sahiplenme kodu oluşturun ve sekiz grubun tamamını tekrar karşılaştırarak güvendiğiniz bir ağdaki tarayıcıdan sahiplenin.
Lisans reddedildi
Lisansı içe aktar (Import the licence), Yeni bir lisans içe aktar (Import a new licence) veya nexusctl licence import üzerindeki içe aktarma işlemi bir ret ile yanıt veriyor. Reddedilen bir içe aktarma hiçbir şeyi değiştirmez: yürürlükteki lisans yürürlükte kalır ve saat tabanı (clock floor) hareket etmez.
Kodu ve adımı okuyun:
curl --fail-with-body -X POST https://auth.harrow.example/api/v1/installation/licence \
-H "Authorization: Bearer <access-token>" \
-H "Content-Type: application/json" \
--data-binary @harrow-2027.licence.jsonRet gövdesi code, message, refused_at (başarısız olan adım) ve troubleshooting bilgilerini taşır. Yürürlükteki lisansın durumunu görmek için aynı belirteçle GET https://auth.harrow.example/api/v1/installation/licence/state uç noktasını okuyun.
| Kod | HTTP | Olağan neden | Çözüm |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Dosya düzenlenmiş, yeniden biçimlendirilmiş veya yeniden kaydedilmiş ya da bir imza eksik | Hesabınızdan tekrar indirin ve dokunmadan içe aktarın |
LICENCE_FORMAT_INVALID |
422 | Lisans değil: yanlış dosya, kesilmiş veya başka bir nesnenin içine sarılmış | Dosyayı tam olarak Adverant'ın verdiği gibi gönderin |
LICENCE_ROOT_UNKNOWN |
422 | Bu sürümün taşımadığı bir anahtarla imzalanmış | Yükseltme yapın veya sürümünüz için imzalanmış bir lisans isteyin |
LICENCE_MATRIX_MISMATCH |
422 | Daha yeni bir sürüm matrisi için yazılmış veya bu yapının bilmediği bir gruba yetki veriyor | Yükseltme yapın veya sürümünüze göre yazılmış bir lisans isteyin |
LICENCE_OTHER_INSTALLATION |
409 | Başka bir kurulum için verilmiş; genellikle üretim ortamında test kümesinin lisansı kullanılmıştır | Bu kurulumun kimliği için bir lisans isteyin |
LICENCE_REVOKED |
403 | Adverant lisansı geri çekti | Adverant'tan yeni bir lisans isteyin |
LICENCE_LOCKED |
403 | starts_on değeri geçerli tarihten sonra |
İlk gününde veya sonrasında içe aktarın |
TRANSITION_NOT_PERMITTED |
409 | Bu lisans kimliği zaten içe aktarılmış | Yürürlükteyse yapılacak bir şey yok; koşulların değişmesi gerekiyorsa Adverant'a danışın |
RECORD_NOT_FOUND |
404 | Kurulum bildirilmemiş, bu nedenle henüz bir kimliği yok | İlk yönetici adımını tamamlayın, ardından içe aktarın |
TENANT_NOT_A_PARAMETER |
403 | Gövde, en üst düzeyinde bir kuruluş adı belirtiyor | Gövde olarak yalnızca lisans dosyasını gönderin |
İki durum lisans sorunu gibi görünür ancak değildir. LICENCE_CLOCK_BEHIND_FLOOR taşıyan bir durum okuması, düğümün saatinin kurulumun gördüğü en son zamandan daha eskiyi gösterdiği anlamına gelir; düğümün saatini düzeltin ve saat ileri gitmiş ve tabanı da beraberinde taşımışsa Adverant'tan bir zaman sıfırlama belirteci isteyin. Ayrıca, içe aktarılan ancak bir grubu hâlâ tanıtım (teaser) olarak gösteren bir lisans genellikle o gruba yetki vermiyordur: her şeyden önce lisans sayfasındaki yetkileri okuyun.
YZ yanıtı yok
Yapay zeka (YZ) asistanı MODEL_NOT_CONNECTED (503) gösteriyor, bir iş akışı adımı NO_PROVIDER_FOR_ROLE (422) ile başarısız oluyor veya yanıtlar tamamen duruyor.
Kuruluşun havuzunda yanıt verebilecek bir anahtar yoktur veya yönlendirici (router) sağlayıcıya ulaşamıyordur. Her kuruluş kendi model anahtarını getirir. Kullanımda anahtar olmadığında, tasarım gereği YZ de olmaz ve hiçbir paylaşılan anahtar boşluğu doldurmaz.
Havuzu ve yönlendiricinin seçimini, her birini kişinin kendi erişim belirteciyle kontrol edin:
GET https://console.harrow.example/api/v1/ai-providers
GET https://api.harrow.example/api/ai/routing-policy/effective
İlki; her sağlayıcıyı, yanıt verip veremeyeceğini ve neden veremediğini ("No key in use: 1 withdrawn, 1 lapsed") ve her anahtarın durumunu listeler. İkincisi, yönlendiricinin kuruluş için kullanacağı modeli veya reddini sözcüklerle yanıtlar. Ardından şu iki komutla küme dışına çıkan yolu kontrol edin:
kubectl -n nexus get networkpolicy nexus-operator-egress -o yaml
kubectl -n nexus logs deploy/nexus-gatewayHer bir bulgunun anlamı:
| Bulgunuz | Çözüm |
|---|---|
| Havuzda anahtar yok | Bir sahip veya yönetici, YZ santrali (AI switchboard) veya Ayarlar, YZ modelleri (Settings, AI models) üzerinden bir kuruluş anahtarı ekler |
Anahtarlar invalid, expired veya exhausted durumunda |
Yeni bir anahtar ekleyin; eskisi geçmiş olarak listelenmeye devam eder |
Anahtarlar resting durumunda |
Bekleyin: başarısız olan bir anahtar 60 saniye dinlenir ve üst üste 5 başarısızlıktan sonra kapatılır (PROVIDER_KEY_SWITCHED_OFF) |
Kullanımda anahtarlar varken NO_PROVIDER_FOR_ROLE |
Rolün ataması yoktur ve hiçbir şey eşleşmiyordur; yönlendirme politikasında rolü ayarlayın |
MODEL_CAPABILITY_UNAVAILABLE (422) |
İstek, havuzdaki hiçbir sağlayıcının sunmadığı bir yetenek veya veri yerleşimi (residency) gerektiriyordur; bunu sunan bir sağlayıcıyı etkinleştirin |
nexus-operator-egress politikası yok veya sağlayıcının aralıkları politikada eksik |
Sınıfsız Alanlar Arası Yönlendirme (CIDR) gösterimiyle yazılmış aralıkları networkPolicy.externalEgressCIDRs içine ekleyin ve yükseltin |
| Yanıt vermeyen yerel bir model sunucusu | ai.localProvider.baseUrl kontrolü yapın, sunucuyu ai.installationHosts içinde listeleyin ve aralığına networkPolicy.externalEgressCIDRs içinde izin verin |
Bir dizüstü bilgisayardan çalışan ve kurulumda başarısız olan barındırılan (hosted) bir sağlayıcı anahtarı, neredeyse her zaman ağ politikasından kaynaklanır. Ad alanı varsayılan olarak dışa çıkışı (egress) reddeder.
429 yanıtları
Bir istemciye 429 Too Many Requests yanıtı veriliyor. Nexus'ta bunu söyleyebilecek dört yer vardır ve gövde size hangisi olduğunu söyler.
| Nerede | Kod ve ayrıntı | Değiştirilecek şey |
|---|---|---|
| nexus-auth, oturum açmış kişi başına | limit, windowSeconds ve retryAfterSeconds ile RATE_LIMITED |
Yoğun otomasyon için auth.rateLimitPerMinute (varsayılan 5000) |
| Bir betik anahtarı, uygulama veya birim sınırı (Enterprise) | Anahtarı ve sınırını belirten RATE_LIMITED |
Bir gerekçeyle birlikte Ayarlar, Hız sınırları (Settings, Rate limits) üzerindeki sınır |
| İlk çalıştırma sahiplenme sayfası | retry_after_seconds ile RATE_LIMITED |
Hiçbir şey: bekleyin ve sayfayı başka kimin denediğini öğrenin |
| Bir model sağlayıcısı | Yönlendirici bunu geçici bir hata olarak ele alır ve bir sonraki sağlayıcıya geçer | Sık sık oluyorsa başka bir anahtar veya sağlayıcı ekleyin |
Her biri bir Retry-After üstbilgisi (header) taşır. Düzgün çalışan bir istemci o süre kadar bekler ve daha erken yeniden denemez.
Aynı anda tüm kullanıcılar tek bir sınırı paylaşıyor gibi görünüyorsa proxy.trustedCIDRs değerini kontrol edin. Ingress denetleyicinizin pod ağını kapsamadığında, nexus-auth X-Forwarded-For üstbilgisine güvenemez ve her isteği denetleyiciden geliyormuş gibi görür. Varsayılan değer olan 10.42.0.0/16, yalnızca k3s için uygundur.
kubectl get pods -A -o wideÇıktıda ingress denetleyicisinin pod adresini bulun ve proxy.trustedCIDRs değerinin bunu kapsadığından emin olun.
Yükseltme hataları
Yükseltme geri alındı. Yükseltme (Upgrade) sayfası UPGRADE_ROLLED_BACK gösteriyor: bir adım başarısız oldu, her motor önceki sürüme geri döndü ve veriler değiştirilmedi. Sayfa, adımı belirtir. Yaygın nedenlerden biri, bir deponun yeni düzeni için çok küçük kalan bir birimdir. Belirttiği sorunu düzeltin, nexusctl upgrade plan --bundle <file> komutunu tekrar çalıştırın ve ardından uygulayın. Önce yedekleme tekrar alınır.
Chart, EXTERNAL_KEY_ENCRYPTION_KEY_INVALID ile işlenmeyi (render) reddediyor. nexus-generated Secret'ı, EXTERNAL_KEY_ENCRYPTION_KEY değerini chart'ın kullanamayacağı bir biçimde tutuyor. 32 baytın base64 hali veya daha eski bir kurulumun ham 32 baytlık anahtarı olmalıdır. Birisi Secret'ı düzenlemiş veya değiştirmiştir. Bu kurulumun verilerinin altında mühürlendiği anahtarı, 32 baytının base64 hali olarak (printf %s "$OLD" | base64) geri koyun ve tekrar yükseltin. Chart'ın yeni bir tane oluşturmasına izin vermeyin: eski anahtar altında mühürlenen veriler okunamaz halde kalır.
Yükseltmeden sonra betikler TOKEN_ORG_MISSING ile reddediliyor. Uygulama programlama arayüzü (API) anahtarlarını nexus-auth üzerinden kontrol eden her hizmet, artık kuruluşu olmayan bir anahtarı 403 TOKEN_ORG_MISSING ile reddeder. Bu tür her anahtara bir kuruluş verin veya yeni bir anahtar oluşturun.
Anahtarlar bir saat boyunca yanlış uygulamayı bildiriyor. Kurulumun Valkey deposu olan nexus-auth önbelleğindeki önbelleğe alınmış anahtar girdilerini temizleyin (flush). Bölüm 2.15, İkinci gün: Nexus'u işletme, küme içi depo ve harici depo için gerekli komutu içerir.
Bir taşıma kancası başarısız oldu. helm upgrade, başarısız bir yükseltme öncesi (pre-upgrade) kancası bildiriyor. Şema, yeni pod'lar devreye girmeden önce taşınır, bu nedenle çalışan sürüm hizmet vermeye devam etmektedir. kubectl -n nexus logs job/<job-name> ile Job'ın günlüğünü okuyun, belirttiği sorunu düzeltin ve yükseltmeyi tekrar çalıştırın.
Hizmetler birkaç saniye boyunca tablolarını kullanamadı. Daha eski bir chart'tan yapılmış bir kurulumun ilk yükseltmesinde, her hizmet eski varsayılan tablo haklarını kaybeder ve kendi taşıma işleminden kendi haklarını geri alır. Aradaki boşluk birkaç saniyedir. Sakin bir dönemde yükseltme yapın veya önce hizmetleri sıfıra ölçeklendirin.
Diskteki sürüm reddedildi. Ortamdan içe aktarma (Import from media) MEDIA_SIGNATURE_INVALID (422) gösteriyor: dosyalar bu kuruluma yüklenen sürüm anahtarıyla imzalanmamış. Hiçbir şey yüklenmedi ve çalışan sürüm çalışmaya devam ediyor. Ortamı güvenlik ekibiniz için saklayın ve çevrimdışı değişim yoluyla Adverant'tan yeni ortam isteyin.
Bir chart oluşturma reddi
helm install, helm upgrade veya helm template, hiçbir şey uygulanmadan önce, bir kodla başlayan veya bir değer adı belirten bir mesajla duruyor. Chart, güvenli bir şekilde çalıştıramayacağı değerleri reddeder. Kümede hiçbir şey değişmemiştir.
Kümeye dokunmadan her reddi görmek için chart'ı tek başına işleyin (render). Enterprise üzerinde oci:// adresi yerine indirdiğiniz Enterprise chart'ını kullanın ve değerlerde networkPolicy.apiServerCIDRs ayarını yapın; çünkü çevrimdışı bir işleme bunu kümeden okuyamaz:
helm template nexus oci://registry.adverant.ai/nexus/charts/nexus --version <version> \
-n nexus -f harrow-values.yaml > /dev/null
nexusctl preflight --context harrow-prod --values harrow-values.yamlÖn kontrol (Preflight), "zaman ve anahtarlar" (time and keys) bölümünde aynı kimlik değerlerini kontrol eder ve aynı kodları bildirir. Çıkış kodu; kurulum devam edebildiğinde 0 (uyarılar engellemez), en az bir kontrol başarısız olduğunda 1 ve çalışamadığında 2 olur.
| Reddetme | Neden | Çözüm |
|---|---|---|
INSTALLATION_NAME_MISSING |
keys.installationName boş |
^[a-z][a-z0-9-]{0,62}$ ile eşleşecek şekilde bu kurulumun kendi adına ayarlayın. Anahtar deposu ilk kez başladıktan sonra bu ad kalıcıdır |
INSTALLATION_NAME_EXAMPLE |
Ad, chart'ın örnek değerler dosyalarındaki addır | Kendi adınızı ayarlayın |
keys.installationName "…" does not match … |
Büyük harfler, alt çizgiler veya başta bir rakam | Bir harfle başlayarak küçük harfler, rakamlar ve kısa çizgiler kullanın |
KEYS_CUSTODIAN_MISSING |
keys.custody.recipients boş |
Emanetçilerinizin age alıcılarını (açık yarıları) listeleyin |
KEYS_CUSTODIAN_EXAMPLE |
Alıcı, chart'ın değerler dosyalarındaki kimliğini kimsenin tutmadığı örnek emanetçidir | Kendi emanetçilerinizin alıcılarıyla değiştirin |
keys.custody.recipients: … |
Emanet Job'ının şifreleyemeyeceği bir biçimdeki alıcı | Küçük harflerle age1…, age1tag1…, age1tagpq1…, age1pq1… veya age1se1… kullanın |
NEXUS_EDITION_INVALID |
edition ne community ne de enterprise |
İkisinden birini ayarlayın |
edition=… but enterprise.enabled=… |
İkisi uyuşmuyor | enterprise.enabled: true değerini yalnızca ve tam olarak edition değeri enterprise olduğunda ayarlayın |
global.imageRegistry is required |
Kayıt defteri belirtilmemiş | Düğümlerinizin imajları çektiği kayıt defterini ayarlayın |
hosts.<name> is required |
Genel bir ana bilgisayar eksik | hosts.console, hosts.api ve hosts.auth değerlerini ayarlayın |
tls.existingSecret is required when tls.mode is existing |
Sertifika Secret'ı belirtilmemiş | Secret'ı belirtin veya başka bir tls.mode seçin |
tls.clusterIssuer is required when tls.mode is cert-manager |
Sertifika veren (issuer) belirtilmemiş | ClusterIssuer'ınızı belirtin |
dataTier.<store>.external.host is required when mode is external |
Adresi olmayan harici bir depo | Ana bilgisayarını ve existingSecret içindeki Secret'ını verin |
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read |
helm template bunları arayacağı bir kümeye sahip değil |
API sunucusunun adreslerini /32 aralıkları olarak verin |
EXTERNAL_KEY_ENCRYPTION_KEY_INVALID |
nexus-generated içinde oluşturulan anahtar yanlış biçimde |
Yukarıdaki "Yükseltme hataları" bölümüne bakın |
Chart'ta bulunmayan bir anahtarı veya yanlış türde bir değeri kullanan bir değerler dosyası, bunların herhangi birinden önce chart'ın şeması tarafından reddedilir. telemetry.enabled: true buna bir örnektir: şema yalnızca false kabul eder.
Destek paketi gönderme
Bunların hiçbiri sorunu çözmezse, destek talebinizle birlikte Adverant'a bir destek paketi (support bundle) gönderin.
nexusctl support-bundle --out harrow-support-<request-number>.tar.gz<request-number>, hesabınızın Destek ve destek paketleri (Support and support bundles) sayfasında açtığınız talebin numarasıdır. Aynı paketi konsolun Bu kurulum (This installation) altındaki Destek paketi (Support bundle) sayfasından da oluşturabilirsiniz.
Paket; son 24 saatin motor günlüklerini, sağlık ve sürüm ayrıntılarını, gizli bilgileri olmadan ayarları ve ön kontrol ile kurulum raporlarını tutar. Yazılmadan önce, sansürleme (redaction) işlemi adları, gizli bilgileri ve adresleri değiştirir ve dışarıya tam olarak neyin çıktığının bir önizlemesini okursunuz. Kişilerin mesajları, dosyaları ve belleği asla toplanmaz.
Hesabınızdaki talebe yükleyin veya kurulumun dış bağlantısı yoksa bir ortama kaydedip dışarı taşıyın. Paketi yalnızca talepte adı geçen destek mühendisleri açabilir ve paket 30 gün sonra silinir. Talepte, yukarıdaki sorunlardan hangisine baktığınızı ve bu bölümdeki kontrollerin ne gösterdiğini belirtin: bu, gereksiz yazışmaları önler.


