Zaloguj sięUmów spotkanie

Rozdział 2.17

Rozwiązywanie problemów

Problemy najczęściej napotykane przez operatorów, uporządkowane według objawów. Każdy przypadek zawiera przyczynę, polecenie potwierdzające oraz rozwiązanie, a rozdział kończy się instrukcją wysłania pakietu diagnostycznego.

Ta strona została przetłumaczona przez AI z angielskiego oryginału. W razie jakichkolwiek niejasności wersją wiążącą jest strona w języku angielskim. Przeczytaj tę stronę po angielsku

Czas czytania: 22 min

Większość problemów z instalacją systemu Nexus wynika z tych samych kilkunastu przyczyn, a niemal każdy z nich sygnalizowany jest odpowiednim kodem. Ten rozdział został uporządkowany według objawów, w kolejności, w jakiej najprawdopodobniej można je napotkać: instalacja, przejmowanie, licencjonowanie, a następnie działanie systemu. Dla każdego problemu podano przyczynę, polecenie pozwalające ją potwierdzić oraz rozwiązanie.

W przykładach wykorzystano instalację Harrow Port Authority: przestrzeń nazw nexus, wydanie nexus, hosty console.harrow.example, api.harrow.example oraz auth.harrow.example. Proszę zastąpić je własnymi wartościami. Trzy nawyki pozwalają zaoszczędzić czas przy każdym z opisanych tu problemów:

  1. Proszę najpierw odczytać kod, a dopiero potem komunikat. Każda odmowa w systemie Nexus kończy się kodem maszynowym i to właśnie według tych kodów indeksowany jest niniejszy rozdział.
  2. Proszę ponownie uruchomić nexusctl preflight po każdej zmianie w klastrze lub w pliku wartości (values). Polecenie to odczytuje stan klastra bez wprowadzania w nim zmian i zgłasza większość odmów chartu z nazwy, zanim zrobi to Helm.
  3. Proszę użyć --explain z dowolnym poleceniem nexusctl, co do którego nie mają Państwo pewności. Wypisze ono operacje kubectl oraz helm bez ich wykonywania.

Instalacja zawiesza się

Uruchomiono instalację, ale nie dobiegła ona końca. Polecenie helm nie zakończyło działania po piętnastu minutach albo zakończyło działanie, lecz pody nadal znajdują się w stanie Init lub Pending, bądź też adres konsoli nie odpowiada.

Najczęstszą przyczyną jest helm install --wait. Nexus tworzy swoją bazę danych, role oraz schemat każdej usługi w hookach poinstalacyjnych (post-install), a hook inicjalizujący (bootstrap) przekazuje każdej usłudze jej hasło do bazy danych. Przy użyciu --wait Helm czeka na gotowość zasobów Deployment przed uruchomieniem tych hooków, podczas gdy zasoby Deployment czekają na wykonanie hooków. Żaden z procesów nie postępuje naprzód. Nigdy nie należy instalować z flagą --wait; należy przeprowadzić instalację bez niej i zaczekać po jej zakończeniu.

Pionowa sekwencja ramek połączonych strzałkami skierowanymi w dół: „Utworzenie zasobów wydania (uruchomienie obiektów Deployment, z których każdy jest wstrzymywany przez swój kontener inicjujący wait-for-schema)”, następnie „Hook inicjujący bazę danych: baza danych, role, księga wydań”, następnie „Hooki migracji, po jednym na usługę, w ustalonej kolejności”, a następnie „Każdy hook zapisuje swój wiersz w księdze wydań”. Od ostatniej ramki strzałki rozchodzą się na boki do trzech małych ramek: „uruchomienie nexus-auth”, „uruchomienie nexus-gateway”, „uruchomienie pozostałych usług”. Notatka boczna obok górnej ramki, z przekreśloną strzałką prowadzącą na sam dół: „helm install --wait czeka w tym miejscu na obiekty Deployment, które czekają na hooki”.
Elementy uruchamiane po kolei podczas instalacji lub aktualizacji chartu.

Pozostałe przyczyny to typowe problemy środowiska Kubernetes. Obrazy nie mogą zostać pobrane, ponieważ global.imageRegistry wskazuje niewłaściwy rejestr lub instalacja Enterprise nie ma tokenu pobierania (pull token). Wolumen pozostaje w stanie Pending, ponieważ klasa pamięci masowej (storage class) nie istnieje. Brakuje komponentu cert-manager – w tym przypadku instalacja w ogóle się nie zawiesza, lecz kończy się niepowodzeniem w ciągu kilku sekund, ponieważ wystawcy certyfikatów w charcie wymagają zasobów komponentu cert-manager.

Proszę zacząć od sprawdzenia podów oraz zadań (Job) hooków:

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.io

Polecenie describe pokazuje w zdarzeniach błędy pobierania obrazów oraz niepowiązane wolumeny. Zadanie (Job) hooka, które wykazuje liczbę ukończeń 0/1 przy podzie zakończonym niepowodzeniem, zatrzymało instalację, ponieważ zadania hooków mają limit ponowień (backoff limit) równy 0 i nigdy nie są ponawiane po cichu. Przyczyna znajduje się w jego logu.

Oto jak rozwiązać każdą z przyczyn:

  • Jeśli Helm oczekuje z powodu flagi --wait, proszę go zatrzymać, odinstalować wydanie i zainstalować ponownie bez tej flagi. Następnie proszę zaczekać na usługi:
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
  • W przypadku błędów pobierania obrazów proszę sprawdzić global.imageRegistry, a dla wersji Enterprise – token pobierania na stronie „Pull tokens and install commands” na koncie użytkownika.
  • W przypadku wolumenów w stanie Pending proszę ustawić storage.className na klasę pamięci masowej dostępną w klastrze lub ustawić jedną z klas jako domyślną.
  • W przypadku braku komponentu cert-manager proszę zainstalować cert-manager v1.21.3 i ponownie uruchomić instalację.
  • W przypadku niepowodzenia hooka proszę naprawić problem wskazany w jego logu i ponownie uruchomić instalację.

Pod oczekuje na swój schemat

Pod usługi pozostaje w stanie Init:0/1 przez wiele minut. Każda usługa korzystająca z bazy danych posiada kontener inicjalizujący, wait-for-schema, który wstrzymuje uruchomienie poda, dopóki rejestr wydań (release ledger) nie wykaże, że migracje dla obrazu tego wydania zostały zastosowane. Jest to normalne zjawisko przez pierwsze minuty instalacji lub aktualizacji, gdy działają hooki migracji. Staje się to problemem, gdy stan ten nie ustępuje.

Proszę odczytać log kontenera inicjalizującego:

kubectl -n nexus logs <pod-name> -c wait-for-schema

Log wskazuje komponent, łańcuchy migracji, na które oczekuje, oraz limit czasu, a następnie wypisuje wiersz przy każdej zmianie swojego stanu:

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
Wiersz postępu wskazuje Co to oznacza
Które łańcuchy muszą jeszcze zostać zastosowane dla tego wydania Wymienione hooki migracji nie zakończyły działania. Proszę sprawdzić odpowiadające im zadania (Job).
Że nie można odczytać rejestru wydań, wraz z błędem bazy danych Postgres nie odpowiada lub rejestr nie istnieje, ponieważ inicjalizacja (bootstrap) bazy danych nie została uruchomiona.
FAILED (<component>): after <n>s, … Zrezygnowano po upływie schemaWait.timeoutSeconds (domyślnie 1800). Kontener inicjalizujący uruchamia się ponownie; sama usługa nigdy nie została uruchomiona.

Łańcuch, który nigdy nie zostaje zastosowany, niemal zawsze oznacza niepowodzenie zadania (Job) migracji. Proszę znaleźć je za pomocą kubectl -n nexus get jobs i odczytać jego log. Należy naprawić wskazany problem (pełny dysk, zewnętrzna baza danych nieosiągalna dla migratora, konflikt ról) i uruchomić helm upgrade z tymi samymi wartościami: hooki zostaną uruchomione ponownie, a każdy z nich można bezpiecznie uruchamiać wielokrotnie.

Wartość schemaWait.timeoutSeconds należy zwiększać tylko wtedy, gdy migracja przebiega powoli, ale prawidłowo, co może mieć miejsce podczas dużej pierwszej migracji na wolnej pamięci masowej. Zwiększanie jej w celu ukrycia nieudanego zadania (Job) sprawi jedynie, że pod będzie dłużej czekał na zdarzenie, które nigdy nie nastąpi.

Magazyn kluczy jest zapieczętowany

Po awarii zasilania, restarcie węzła lub restarcie środowiska uruchomieniowego kontenerów pody wracają do działania i konsola się ładuje, ale wszystko, co wymaga klucza, kończy się błędem lub oczekuje. Komponent odpieczętowania (unsealer) uruchamia się w stanie zapieczętowanym po każdym restarcie swojego węzła, a magazyn kluczy (key store) nie może się samoczynnie odpieczętować, dopóki komponent odpieczętowania nie zostanie otwarty.

Proszę odpytać OpenBao w każdym podzie:

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 $?"

Kod wyjścia 0 oznacza stan odpieczętowany, 2 oznacza stan zapieczętowany, a 1 oznacza brak odpowiedzi (proszę spróbować ponownie za minutę). Proszę uruchomić to samo polecenie dla openbao-0 z -tls-server-name=openbao dla magazynu kluczy. Jeśli komponent odpieczętowania jest odpieczętowany, a magazyn kluczy nie, oznacza to, że magazyn kluczy właśnie się odpieczętowywuje; proszę odczekać minutę.

Aby naprawić zapieczętowany komponent odpieczętowania, jeden z powierników (custodians) uruchamia skrypt unseal.sh chartu z własną tożsamością age. Pełne polecenie znajduje się w Rozdziale 2.15, Dzień drugi: obsługa systemu Nexus. Kod wyjścia skryptu informuje o rezultacie:

Kod wyjścia Znaczenie Co należy zrobić
0 Odpieczętowany Proszę sprawdzić kubectl -n nexus get deploy,statefulset w ciągu minuty.
1 Nadal zapieczętowany lub wywołanie odpieczętowania się nie powiodło Proszę odczytać wypisane wiersze udziałów (shares) i uruchomić skrypt ponownie.
2 Brak wymaganego elementu wstępnego Komunikat wskazuje brakujący element: AGE_IDENTITY, plik binarny taki jak age lub jq, albo ustawienie trybu bezpośredniego (direct-mode).
3 Ta tożsamość nie może odszyfrować udziałów Nie są Państwo powiernikiem tej instalacji. Nic nie zostało przesłane. Proszę znaleźć właściwego powiernika.

Nie można zalogować się przez HTTP

Konsola ładuje się pod adresem http:// lub przez kubectl port-forward do 127.0.0.1, a logowanie kończy się niepowodzeniem. Monit o klucz dostępu (passkey) nigdy się nie pojawia lub proces logowania zapętla się i wraca do początku.

Logowanie wymaga własnego źródła (origin) HTTPS konsoli. Konsola akceptuje logowanie wyłącznie z https://<hosts.console>, przechowuje sesję w pliku cookie __Host- oznaczonym jako Secure (który przeglądarka zapisuje tylko przez HTTPS), a klucz dostępu pierwszego administratora wymaga strony z ważnym certyfikatem. Przeglądarki odrzucają klucze dostępu w przypadku błędu certyfikatu. Przekierowanie portów (port-forward) do http://127.0.0.1 nigdy nie pozwoli na zalogowanie.

Proszę sprawdzić, z czym faktycznie połączyła się przeglądarka:

curl -sI https://console.harrow.example
kubectl -n nexus get ingress

Pierwsze polecenie powinno odpowiedzieć przez HTTPS z certyfikatem zaufanym przez Państwa komputer. Drugie powinno pokazać trzy hosty o nazwach ustawionych w hosts.*.

Aby to naprawić, należy połączyć się z konsolą pod adresem https://console.harrow.example, czyli dokładną nazwą z hosts.console, używając certyfikatu zaufanego przez przeglądarkę. W przypadku tls.mode: existing proszę sprawdzić, czy tls.existingSecret przechowuje certyfikat dla wszystkich trzech hostów. W przypadku tls.mode: cert-manager proszę sprawdzić, czy zasób ClusterIssuer go wystawił. W przypadku tls.mode: none szyfrowanie Transport Layer Security (TLS) kończy się na Państwa własnym load balancerze i to tam certyfikat musi być prawidłowy. W przypadku prywatnego urzędu certyfikacji (CA) należy zainstalować jego certyfikat na komputerach, z których logują się administratorzy.

Kod przypisania wygasł

Na stronie „Claim this installation” kod zostaje odrzucony z błędem CLAIM_CODE_EXPIRED (410). Kod przejęcia składa się z trzech grup po cztery znaki. Działa jednorazowo, przez 30 minut, z limitem 5 prób. Po tym czasie lub po piątej nieudanej próbie kod wygasa, a instalacja nie zostaje przejęta ani zmieniona.

Proszę wygenerować nowy kod w terminalu z dostępem do klastra:

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

Polecenie wypisze nowy kod oraz odcisk palca (fingerprint) instalacji. Proszę wprowadzić kod na stronie przejęcia w ciągu 30 minut i ponownie porównać odcisk palca.

Przejmij tę instalację
Przejmij tę instalację
Strona „Claim this installation”. Kod z terminala wprowadza się w trzech grupach, a strona wyświetla pełny odcisk palca w grupach po cztery znaki do porównania; wygasły kod zostaje odrzucony z błędem CLAIM_CODE_EXPIRED i instalacja nie zostaje przejęta.

Dwie powiązane odpowiedzi:

  • Błąd RATE_LIMITED (429) na stronie przejęcia oznacza, że w ciągu ostatniej minuty podjęto na niej kilka prób. Proszę odczekać podaną liczbę sekund. Jeśli to nie Państwo podejmowali te próby, ktoś inny w sieci próbuje użyć tej strony; przed przejęciem instalacji należy ustalić, kto to jest.
  • Błąd TRANSITION_NOT_PERMITTED (409) oznacza, że instalacja została już przejęta, a jej strona przejęcia została trwale wyłączona. Zamiast tego należy się zalogować. Jeśli to nie Państwo przejęli instalację, należy potraktować to jako incydent bezpieczeństwa.

Odcisk palca (fingerprint) nie zgadza się

Strona przejęcia wyświetla błąd CLAIM_FINGERPRINT_MISMATCH (403) lub widzą Państwo sami, że osiem grup po cztery znaki na stronie różni się od tych wypisanych w terminalu. Różnica nawet w jednej grupie oznacza, że przeglądarka komunikuje się z inną instalacją.

Proszę się zatrzymać. Nie należy wpisywać kodu na tej stronie. Pod tym adresem może odpowiadać coś innego niż Państwa instalacja – potencjalnie maszyna podstawiona w celu przechwycenia pierwszego administratora. Gdyby dokonali Państwo przejęcia, maszyna ta przejęłaby Państwa organizację. Państwa własna instalacja pozostaje niezmieniona i nadal nieprzejęta.

Proszę sprawdzić, dokąd wskazuje nazwa i który certyfikat odpowiedział:

nslookup console.harrow.example
kubectl -n nexus get ingress
curl -svI https://console.harrow.example

Adres powinien należeć do Państwa kontrolera ingress, a certyfikat powinien być tym zainstalowanym dla hosts.console.

Odcisk palca się nie zgadza
Odcisk palca się nie zgadza
Odciski palca różnią się w trzech z ośmiu grup. Strona nakazuje przerwanie operacji, wyjaśnia, kto może odpowiadać, i wymienia elementy do sprawdzenia przed podjęciem kolejnej próby.

Aby to naprawić, należy przekazać zespołowi ds. bezpieczeństwa adres, który odpowiedział, oraz zachować log instalacji, w którym zapisany jest odcisk palca wypisany przez instalację. Proszę poprawić rekord Domain Name System (DNS) lub serwer proxy, który przekierował ruch w inne miejsce. Następnie proszę wygenerować nowy kod przejęcia za pomocą nexusctl claim-code --administrator <email> i dokonać przejęcia z przeglądarki w zaufanej sieci, ponownie porównując wszystkie osiem grup.

Licencja została odrzucona

Import na stronie „Import the licence”, „Import a new licence” lub przez nexusctl licence import kończy się odmową. Odrzucony import niczego nie zmienia: obowiązująca licencja pozostaje w mocy, a dolny próg zegara (clock floor) nie ulega przesunięciu.

Proszę odczytać kod oraz krok:

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.json

Treść odmowy zawiera pola code, message, refused_at (krok, który zakończył się niepowodzeniem) oraz troubleshooting. Aby sprawdzić stan obowiązującej licencji, należy odczytać GET https://auth.harrow.example/api/v1/installation/licence/state przy użyciu tego samego tokenu.

Kod HTTP Typowa przyczyna Rozwiązanie
LICENCE_SIGNATURE_INVALID 422 Plik został zmodyfikowany, przeformatowany lub ponownie zapisany, albo brakuje jednego podpisu Pobrać plik ponownie z konta i zaimportować go bez modyfikacji
LICENCE_FORMAT_INVALID 422 To nie jest licencja: niewłaściwy plik, plik ucięty lub opakowany w inny obiekt Proszę przesłać plik dokładnie w takiej postaci, w jakiej przekazał go Adverant
LICENCE_ROOT_UNKNOWN 422 Podpisano kluczem, którego to wydanie nie posiada Zaktualizować system lub poprosić o licencję podpisaną dla Państwa wydania
LICENCE_MATRIX_MISMATCH 422 Wystawiono dla nowszej macierzy edycji lub przyznaje grupę nieznaną w tej kompilacji Zaktualizować system lub poprosić o licencję wystawioną dla Państwa wydania
LICENCE_OTHER_INSTALLATION 409 Wystawiono dla innej instalacji, często jest to licencja klastra testowego użyta na produkcji Poprosić o licencję dla tożsamości tej instalacji
LICENCE_REVOKED 403 Firma Adverant wycofała licencję Poprosić firmę Adverant o nową licencję
LICENCE_LOCKED 403 Wartość starts_on przypada po bieżącej dacie Zaimportować licencję w pierwszym dniu jej obowiązywania lub później
TRANSITION_NOT_PERMITTED 409 Ten identyfikator licencji został już wcześniej zaimportowany Brak konieczności działania, jeśli licencja obowiązuje; proszę skontaktować się z Adverant, jeśli warunki muszą ulec zmianie
RECORD_NOT_FOUND 404 Instalacja nie została zadeklarowana, więc nie ma jeszcze tożsamości Ukończyć krok pierwszego administratora, a następnie zaimportować licencję
TENANT_NOT_A_PARAMETER 403 Treść żądania wskazuje organizację na najwyższym poziomie struktury Wysłać sam plik licencji jako treść żądania

Dwie sytuacje wyglądają jak problemy z licencją, ale nimi nie są. Odczyt stanu zawierający LICENCE_CLOCK_BEHIND_FLOOR oznacza, że zegar węzła wskazuje czas wcześniejszy niż najpóźniejszy czas zarejestrowany przez instalację; należy poprawić czas węzła, a jeśli zegar spieszył się i przesunął dolny próg czasu (clock floor) do przodu, należy poprosić firmę Adverant o token resetowania czasu. Z kolei licencja, która daje się zaimportować, ale nadal wyświetla grupę w formie zapowiedzi (teaser), zazwyczaj nie przyznaje uprawnień do tej grupy: przed podjęciem innych kroków należy sprawdzić przyznane uprawnienia (grants) na stronie licencji.

Brak odpowiedzi od AI

Asystent sztucznej inteligencji (AI) wyświetla błąd MODEL_NOT_CONNECTED (503), krok przepływu pracy (workflow) kończy się błędem NO_PROVIDER_FOR_ROLE (422) lub odpowiedzi po prostu przestają napływać.

Pula organizacji nie posiada klucza, który może odpowiedzieć, lub router nie może połączyć się z dostawcą. Każda organizacja wnosi własny klucz modelu. Gdy w użyciu nie ma żadnego klucza, zgodnie z założeniami AI nie działa, a żaden klucz współdzielony go nie zastępuje.

Proszę sprawdzić pulę oraz wybór routera, w każdym przypadku używając własnego tokenu dostępu danej osoby:

GET https://console.harrow.example/api/v1/ai-providers
GET https://api.harrow.example/api/ai/routing-policy/effective

Pierwsze polecenie wyświetla listę wszystkich dostawców, informację o tym, czy mogą odpowiedzieć, a jeśli nie – to dlaczego („Brak klucza w użyciu: 1 wycofany, 1 wygasły”), oraz stan każdego klucza. Drugie zwraca model, którego router użyłby dla organizacji, lub słowną odmowę. Następnie proszę sprawdzić ścieżkę wyjściową z klastra za pomocą tych dwóch poleceń:

kubectl -n nexus get networkpolicy nexus-operator-egress -o yaml
kubectl -n nexus logs deploy/nexus-gateway

Co oznacza każdy z wyników:

Wynik Rozwiązanie
Brak klucza w puli Właściciel lub administrator dodaje klucz organizacji na tablicy rozdzielczej AI lub w sekcji Ustawienia, Modele AI
Klucze invalid, expired lub exhausted Proszę dodać nowy klucz; stary pozostanie na liście jako historia
Klucze resting Proszę zaczekać: niedziałający klucz odpoczywa przez 60 sekund, a po 5 niepowodzeniach z rzędu zostaje wyłączony (PROVIDER_KEY_SWITCHED_OFF)
NO_PROVIDER_FOR_ROLE z kluczami w użyciu Rola nie ma przypisania i nic nie pasuje; proszę ustawić rolę w polityce routingu
MODEL_CAPABILITY_UNAVAILABLE (422) Żądanie wymaga możliwości lub rezydencji danych, których nie oferuje żaden dostawca w puli; proszę włączyć dostawcę, który je zapewnia
Brak polityki nexus-operator-egress lub brakuje w niej zakresów dostawcy Proszę dodać zakresy zapisane w notacji Classless Inter-Domain Routing (CIDR) do networkPolicy.externalEgressCIDRs i przeprowadzić aktualizację
Lokalny serwer modeli, który nie odpowiada Proszę sprawdzić ai.localProvider.baseUrl, wskazać serwer w ai.installationHosts i zezwolić na jego zakres w networkPolicy.externalEgressCIDRs

Klucz hostowanego dostawcy, który działa z poziomu laptopa, a zawodzi w instalacji, to niemal zawsze kwestia polityki sieciowej. Przestrzeń nazw domyślnie blokuje ruch wychodzący.

Odpowiedzi 429

Klient otrzymuje odpowiedź 429 Too Many Requests. Nexus ma cztery miejsca, które mogą ją zwrócić, a treść odpowiedzi wskazuje, które to z nich.

Gdzie Kod i szczegóły Co należy zmienić
nexus-auth, na zalogowaną osobę RATE_LIMITED z limit, windowSeconds oraz retryAfterSeconds auth.rateLimitPerMinute (domyślnie 5000), dla intensywnej automatyzacji
Klucz skryptu, limit aplikacji lub jednostki (Enterprise) RATE_LIMITED wskazujący nazwę klucza i jego limit Limit w sekcji Ustawienia, Limity zapytań, wraz z uzasadnieniem
Strona przypisania przy pierwszym uruchomieniu RATE_LIMITED z retry_after_seconds Nic: proszę zaczekać i sprawdzić, kto jeszcze próbuje wywołać tę stronę
Dostawca modelu Router traktuje to jako przejściowy błąd i przechodzi do kolejnego dostawcy Proszę dodać kolejny klucz lub dostawcę, jeśli zdarza się to często

Każda odpowiedź zawiera nagłówek Retry-After. Prawidłowo działający klient odczekuje wskazany czas i nie ponawia próby wcześniej.

Jeśli wydaje się, że wszyscy użytkownicy naraz współdzielą jeden limit, proszę sprawdzić proxy.trustedCIDRs. Gdy nie obejmuje on sieci podów kontrolera ingress, nexus-auth nie może zaufać nagłówkowi X-Forwarded-For i traktuje każde żądanie jako pochodzące od kontrolera. Wartość domyślna, 10.42.0.0/16, pasuje wyłącznie do k3s.

kubectl get pods -A -o wide

Proszę znaleźć adres poda kontrolera ingress w wynikach i upewnić się, że proxy.trustedCIDRs go obejmuje.

Błędy aktualizacji

Aktualizacja została wycofana. Strona Aktualizacja pokazuje UPGRADE_ROLLED_BACK: krok się nie powiódł, każdy silnik powrócił do poprzedniego wydania, a dane nie zostały zmienione. Strona wskazuje nazwę tego kroku. Częstą przyczyną jest wolumin zbyt mały dla nowego układu magazynu. Proszę naprawić wskazany element, ponownie uruchomić nexusctl upgrade plan --bundle <file>, a następnie zastosować zmiany. W pierwszej kolejności ponownie zostanie wykonana kopia zapasowa.

Chart odmawia renderowania z błędem EXTERNAL_KEY_ENCRYPTION_KEY_INVALID. Zasób Secret nexus-generated przechowuje EXTERNAL_KEY_ENCRYPTION_KEY w postaci, której chart nie może użyć. Musi to być ciąg base64 z 32 bajtów lub surowy 32-bajtowy klucz ze starszej instalacji. Ktoś zmodyfikował lub zastąpił zasób Secret. Proszę przywrócić klucz, którym zapieczętowane są dane tej instalacji, jako base64 z jego 32 bajtów (printf %s "$OLD" | base64), i ponownie przeprowadzić aktualizację. Proszę nie pozwalać, aby chart wygenerował nowy klucz: dane zapieczętowane starym kluczem pozostałyby nieczytelne.

Skrypty są odrzucane z błędem TOKEN_ORG_MISSING po aktualizacji. Każda usługa sprawdzająca klucze interfejsu programowania aplikacji (API) za pośrednictwem nexus-auth odrzuca teraz klucz bez przypisanej organizacji, zwracając 403 TOKEN_ORG_MISSING. Proszę przypisać organizację do każdego takiego klucza lub wystawić nowy klucz.

Klucze zgłaszają nieprawidłową aplikację przez godzinę. Proszę wyczyścić zapisane wpisy kluczy w pamięci podręcznej nexus-auth, czyli w magazynie Valkey danej instalacji. Rozdział 2.15, Dzień drugi: obsługa systemu Nexus, zawiera odpowiednie polecenie dla magazynu wewnątrz klastra oraz dla magazynu zewnętrznego.

Hook migracji nie powiódł się. helm upgrade zgłasza niepowodzenie hooka przed aktualizacją (pre-upgrade). Schemat jest przenoszony przed wdrożeniem nowych podów, więc działające wydanie nadal obsługuje ruch. Proszę odczytać dziennik zadania (Job) za pomocą kubectl -n nexus logs job/<job-name>, naprawić wskazany problem i ponownie uruchomić aktualizację.

Usługi nie mogły korzystać ze swoich tabel przez kilka sekund. Podczas pierwszej aktualizacji instalacji utworzonej ze starszego chartu każda usługa traci swoje stare domyślne uprawnienia do tabel i odzyskuje własne uprawnienia ze swojej własnej migracji. Przerwa trwa kilka sekund. Proszę przeprowadzić aktualizację w okresie mniejszego ruchu lub najpierw przeskalować usługi do zera.

Wydanie na dysku zostało odrzucone. Import z nośnika pokazuje MEDIA_SIGNATURE_INVALID (422): pliki nie są podpisane kluczem wydania zainstalowanym w tej instalacji. Nic nie zostało załadowane, a bieżące wydanie nadal działa. Proszę zachować nośnik dla swojego zespołu ds. bezpieczeństwa i poprosić Adverant o nowy nośnik w ramach wymiany offline.

Odmowa renderowania pakietu chart

helm install, helm upgrade lub helm template zatrzymuje się przed zastosowaniem jakichkolwiek zmian, wyświetlając komunikat zaczynający się od kodu lub wskazujący wartość. Chart odrzuca wartości, których nie może bezpiecznie uruchomić. W klastrze nic się nie zmieniło.

Proszę wyrenderować sam chart, aby zobaczyć wszystkie odmowy bez ingerowania w klaster. W wersji Enterprise proszę użyć pobranego chartu Enterprise zamiast adresu oci:// oraz ustawić networkPolicy.apiServerCIDRs w wartościach, ponieważ renderowanie offline nie może odczytać tego z klastra:

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

Kontrola wstępna (preflight) sprawdza te same wartości tożsamości w swojej sekcji „czas i klucze” i zgłasza te same kody. Jej kod wyjścia to 0, gdy instalacja może być kontynuowana (ostrzeżenia nie blokują), 1, gdy co najmniej jedno sprawdzenie się nie powiodło, oraz 2, gdy nie udało się jej uruchomić.

Preflight nie może kontynuować
Preflight nie może kontynuować
Kontrola wstępna (preflight) nie może być kontynuowana. Testy zakończone niepowodzeniem są wyświetlane jako pierwsze, każdy wraz ze sposobem naprawy, a instalacja pozostaje zablokowana ze statusem PREFLIGHT_FAILED, dopóki nie zakończą się pomyślnie.
Odrzucenie Przyczyna Rozwiązanie
INSTALLATION_NAME_MISSING Wartość keys.installationName jest pusta Proszę ustawić tutaj własną nazwę tej instalacji, zgodną z ^[a-z][a-z0-9-]{0,62}$. Staje się ona stała po pierwszym uruchomieniu magazynu kluczy
INSTALLATION_NAME_EXAMPLE Nazwa jest taka sama jak w przykładowych plikach wartości chartu Proszę ustawić własną nazwę
keys.installationName "…" does not match … Wielkie litery, znaki podkreślenia lub cyfra na początku Proszę użyć małych liter, cyfr i myślników, zaczynając od litery
KEYS_CUSTODIAN_MISSING Wartość keys.custody.recipients jest pusta Proszę wymienić odbiorców age powierników (publiczne połowy kluczy)
KEYS_CUSTODIAN_EXAMPLE Odbiorcą jest przykładowy powiernik z plików wartości chartu, którego tożsamości nikt nie posiada Proszę zastąpić go odbiorcami własnych powierników
keys.custody.recipients: … Odbiorca w formacie, dla którego zadanie (Job) pieczy nie może przeprowadzić szyfrowania Proszę użyć age1…, age1tag1…, age1tagpq1…, age1pq1… lub age1se1…, zapisanych małymi literami
NEXUS_EDITION_INVALID edition nie ma wartości community ani enterprise Proszę ustawić jedną z tych dwóch wartości
edition=… but enterprise.enabled=… Obie wartości są ze sobą sprzeczne Proszę ustawić enterprise.enabled: true dokładnie wtedy, gdy edition ma wartość enterprise
global.imageRegistry is required Nie wskazano rejestru Proszę ustawić rejestr, z którego węzły pobierają obrazy
hosts.<name> is required Brakuje publicznego hosta Proszę ustawić hosts.console, hosts.api oraz hosts.auth
tls.existingSecret is required when tls.mode is existing Nie wskazano zasobu Secret certyfikatu Proszę wskazać nazwę zasobu Secret lub wybrać inny tls.mode
tls.clusterIssuer is required when tls.mode is cert-manager Nie wskazano wystawcy Proszę wskazać nazwę swojego zasobu ClusterIssuer
dataTier.<store>.external.host is required when mode is external Magazyn zewnętrzny bez adresu Proszę podać jego hosta oraz jego zasób Secret w existingSecret
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read helm template nie ma klastra, w którym mógłby je wyszukać Proszę podać adresy serwera API jako zakresy /32
EXTERNAL_KEY_ENCRYPTION_KEY_INVALID Wygenerowany klucz w nexus-generated ma nieprawidłową postać Proszę zobaczyć sekcję „Błędy aktualizacji” powyżej

Plik wartości używający klucza, którego chart nie posiada, lub wartości niewłaściwego typu, zostaje odrzucony przez schemat chartu przed którąkolwiek z powyższych kontroli. telemetry.enabled: true jest jednym z przykładów: schemat akceptuje wyłącznie false.

Wysyłanie pakietu diagnostycznego

Jeśli żadne z powyższych rozwiązań nie pomoże, proszę przesłać do Adverant pakiet diagnostyczny (support bundle) wraz ze zgłoszeniem serwisowym.

nexusctl support-bundle --out harrow-support-<request-number>.tar.gz

<request-number> to numer zgłoszenia otwartego na stronie Wsparcie i pakiety diagnostyczne na Państwa koncie. Ten sam pakiet można utworzyć na stronie Pakiet diagnostyczny w konsoli, w sekcji Ta instalacja.

Pakiet zawiera dzienniki silników z ostatnich 24 godzin, szczegóły dotyczące stanu zdrowia i wersji, ustawienia bez sekretów oraz raporty z kontroli wstępnej (preflight) i instalacji. Przed zapisaniem pakietu proces redakcji zastępuje nazwy, sekrety i adresy, a Państwo mogą przejrzeć podgląd dokładnych danych, które opuszczą system. Wiadomości, pliki ani pamięć użytkowników nie są nigdy gromadzone.

Proszę przesłać pakiet w ramach zgłoszenia na swoim koncie lub zapisać go na nośniku i przenieść, jeśli instalacja nie ma połączenia ze światem zewnętrznym. Otworzyć go mogą wyłącznie inżynierowie wsparcia wskazani w zgłoszeniu, a po 30 dniach zostaje on usunięty. Proszę napisać w zgłoszeniu, którego z powyższych problemów dotyczyła analiza i co wykazały sprawdzenia opisane w tym rozdziale: pozwoli to zaoszczędzić dodatkowej wymiany wiadomości.