УвійтиЗамовити брифінг

Розділ 2.17

Усунення несправностей

Проблеми, з якими оператори стикаються найчастіше, згруповані за зовнішніми проявами. Для кожної наведено причину, команду для її підтвердження та спосіб вирішення, а завершується розділ надсиланням пакета діагностики до служби підтримки.

Цю сторінку перекладено за допомогою ШІ з англійського оригіналу. Якщо щось незрозуміло, орієнтуйтеся на англійську версію сторінки. Читати цю сторінку англійською

22 хв читання

Більшість проблем, що трапляються під час установлення Nexus, виникають із тих самих десятка причин, і майже всі вони повідомляють про себе кодом. Цей розділ упорядковано за тим, що ви бачите, приблизно в тому порядку, в якому ви б зіткнулися з кожною проблемою: установлення, заявлення прав, ліцензування, а потім експлуатація. Для кожної проблеми наведено причину, команду для її підтвердження та спосіб виправлення.

У прикладах використовується інсталяція Harrow Port Authority: простір імен nexus, реліз nexus, хости console.harrow.example, api.harrow.example та auth.harrow.example. Замініть їх на власні. Три звички заощадять час під час вирішення кожної наведеної тут проблеми:

  1. Читайте код перед повідомленням. Кожна відмова в Nexus закінчується машинним кодом, і саме за цими кодами проіндексовано цей розділ.
  2. Запускайте nexusctl preflight знову після будь-якої зміни в кластері чи файлі значень. Це зчитує кластер без внесення змін і повідомляє про більшість відмов чарта за назвою ще до того, як це зробить Helm.
  3. Використовуйте --explain для будь-якої дії nexusctl, у якій ви не впевнені. Це виводить операції kubectl та helm без їх виконання.

Встановлення зависає

Ви запустили установлення, і воно не завершилося. helm не повернув керування через п'ятнадцять хвилин, або повернув, але поди все ще перебувають у стані Init чи Pending, або адреса консолі не відповідає.

Найпоширенішою причиною є helm install --wait. Nexus створює свою базу даних, ролі та схему кожного сервісу в хуках після установлення, а хук початкового завантаження передає кожному сервісу його пароль до бази даних. З --wait Helm чекає на готовність об'єктів Deployment перед тим, як запустити ці хуки, тоді як об'єкти Deployment чекають на хуки. Жоден із них не рухається далі. Ніколи не встановлюйте з --wait; установлюйте без нього та зачекайте після завершення.

Вертикальна послідовність блоків, з'єднаних стрілками вниз: «Створено ресурси релізу (запускаються об'єкти Deployment, кожен утримується своїм ініціалізаційним контейнером wait-for-schema)», далі «Хук початкового завантаження бази даних: база даних, ролі, реєстр релізів», далі «Хуки міграції, по одному на сервіс, у фіксованому порядку», далі «Кожен хук записує свій рядок у реєстр релізів». Від останнього блока стрілки розходяться вбік до трьох менших блоків: «запускається nexus-auth», «запускається nexus-gateway», «запускаються інші сервіси». Бічна примітка біля верхнього блока з перекресленою стрілкою донизу: «helm install --wait чекає тут на об'єкти Deployment, які чекають на хуки».
Що і в якому порядку запускається під час установлення або оновлення чарта.

Інші причини є звичайними для Kubernetes. Образи не вдається завантажити, оскільки global.imageRegistry указує на неправильний реєстр або в інсталяції Enterprise немає токена завантаження. Том залишається в стані Pending, тому що клас сховища не існує. Відсутній cert-manager — у цьому разі установлення взагалі не зависає: воно завершується помилкою за лічені секунди, оскільки видавцям сертифікатів чарта потрібні ресурси cert-manager.

Почніть із подів і завдань Job для хуків:

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

describe показує у своїх подіях помилки завантаження образів і незв'язані томи. Завдання Job для хука, яке показує кількість завершень 0/1 зі збійним подом, зупинило установлення, оскільки завдання Job для хуків мають ліміт повторних спроб 0 і ніколи не повторюються непомітно. У його журналі вказано причину.

Ось як виправити кожну причину:

  • Якщо Helm очікує з --wait, зупиніть його, видаліть реліз і встановіть знову без цього прапорця. Потім дочекайтеся готовності сервісів:
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
  • У разі помилок завантаження перевірте global.imageRegistry і, для редакції Enterprise, токен завантаження зі сторінки токенів завантаження та команд установлення вашого облікового запису.
  • Для томів у стані Pending укажіть у storage.className клас сховища, наявний у кластері, або зробіть один із них класом за замовчуванням.
  • Якщо відсутній cert-manager, установіть cert-manager v1.21.3 і запустіть установлення знову.
  • Якщо стався збій хука, виправте те, на що вказує його журнал, і запустіть установлення знову.

Под очікує на свою схему

Под сервісу залишається в стані Init:0/1 протягом кількох хвилин. Кожен сервіс, який використовує базу даних, має ініціалізаційний контейнер wait-for-schema, що утримує под, доки реєстр релізів не покаже, що його міграції застосовано для образу цього релізу. Це нормально протягом перших хвилин установлення або оновлення, поки виконуються хуки міграції. Це стає проблемою, коли очікування не закінчується.

Перегляньте журнал ініціалізаційного контейнера:

kubectl -n nexus logs <pod-name> -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=sha256:…; gives up after 1800s
У рядку перебігу виконання зазначено Що це означає
Які ланцюжки ще мають бути застосовані для цього релізу Названі хуки міграції ще не завершилися. Перевірте відповідні завдання Job.
Що реєстр релізів неможливо прочитати, з помилкою бази даних Postgres не відповідає, або реєстр не існує, тому що не виконано початкове завантаження бази даних.
FAILED (<component>): after <n>s, … Він припинив спроби після schemaWait.timeoutSeconds (1 800 за замовчуванням). Ініціалізаційний контейнер перезапускається; сам сервіс так і не запустився.

Ланцюжок, який ніколи не застосовується, майже завжди означає, що відповідне завдання Job для міграції завершилося збоєм. Знайдіть його за допомогою kubectl -n nexus get jobs і прочитайте його журнал. Виправте зазначену там проблему (переповнений диск, зовнішня база даних, до якої мігратор не може підключитися, конфлікт ролей) і запустіть helm upgrade з тими самими значеннями: хуки виконаються знову, і кожен із них безпечний для повторного запуску.

Збільшуйте schemaWait.timeoutSeconds лише тоді, коли міграція відбувається повільно, але без помилок, як це буває під час великої першої міграції на повільному сховищі. Збільшення цього значення для приховування збійного завдання Job лише змусить под довше чекати на те, що ніколи не настане.

Сховище ключів заблоковано (sealed)

Після знеструмлення, перезавантаження вузла або перезапуску середовища виконання контейнерів поди відновлюють роботу і консоль завантажується, але все, для чого потрібен ключ, завершується помилкою або чекає. Розблокувальник запускається заблокованим після кожного перезапуску свого вузла, а сховище ключів не може розблокувати себе, доки не відкрито розблокувальник.

Опитайте OpenBao у кожному поді:

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 означає розблокований стан, 2 — заблокований, а 1 означає, що він не зміг відповісти (повторіть запит через хвилину). Виконайте те саме для openbao-0 з -tls-server-name=openbao для сховища ключів. Якщо розблокувальник розблоковано, а сховище ключів — ні, то сховище ключів саме розблоковується; зачекайте хвилину.

Щоб виправити заблокований розблокувальник, один із зберігачів ключів запускає скрипт чарта unseal.sh зі своїм власним ідентифікатором age. Розділ 2.15, День другий: експлуатація Nexus, містить повну команду. Код виходу скрипту повідомляє, що сталося:

Код виходу Значення Що робити
0 Розблоковано Перевірте kubectl -n nexus get deploy,statefulset протягом хвилини.
1 Досі заблоковано, або виклик розблокування завершився помилкою Прочитайте виведені рядки часток ключа; запустіть скрипт знову.
2 Відсутня необхідна передумова У повідомленні вказано її назву: AGE_IDENTITY, виконуваний файл, наприклад age чи jq, або параметр прямого режиму.
3 Цей ідентифікатор не може розшифрувати частки ключа Ви не є зберігачем ключів цієї інсталяції. Нічого не було надіслано. Знайдіть чинного зберігача ключів.

Не вдається увійти через HTTP

Консоль завантажується за адресою http:// або через kubectl port-forward до 127.0.0.1, але вхід не вдається. Запит ключа доступу (passkey) не з'являється, або вхід зациклюється і повертається на початок.

Для входу потрібен власний HTTPS-оригінал (origin) консолі. Консоль приймає вхід лише з https://<hosts.console>, зберігає сеанс у файлі cookie __Host- з позначкою Secure (який браузер зберігає лише через HTTPS), а для ключа доступу першого адміністратора потрібна сторінка з дійсним сертифікатом. Браузери відхиляють ключі доступу за наявності помилки сертифіката. Через перенаправлення портів (port-forward) на http://127.0.0.1 увійти неможливо.

Перевірте, куди фактично звернувся браузер:

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

Перша команда має відповісти через HTTPS із сертифікатом, якому довіряє ваша машина. Друга має показати три хости з іменами, які ви задали в hosts.*.

Щоб виправити це, відкривайте консоль за адресою https://console.harrow.example — точним іменем у hosts.console — із сертифікатом, якому довіряє браузер. Якщо використовується tls.mode: existing, перевірте, чи tls.existingSecret містить сертифікат для всіх трьох хостів. Якщо використовується tls.mode: cert-manager, перевірте, чи видав його ClusterIssuer. Якщо використовується tls.mode: none, дія протоколу Transport Layer Security (TLS) завершується на вашому власному балансувальнику навантаження, і саме там сертифікат має бути правильним. Для приватного центру сертифікації встановіть його сертифікат на машинах, з яких входять ваші адміністратори.

Термін дії коду активації минув

На сторінці заявлення прав на цю інсталяцію (Claim this installation) система відхиляє код із помилкою CLAIM_CODE_EXPIRED (410). Код заявлення прав складається з трьох груп по чотири символи. Він діє один раз, протягом 30 хвилин, і дає 5 спроб. Після цього або після п'ятої невдалої спроби він стає недійсним, при цьому права не заявлено і нічого не змінено.

Створіть новий код із термінала, який має доступ до кластера:

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

Команда виведе новий код і відбиток інсталяції. Уведіть код на сторінці заявлення прав протягом 30 хвилин і знову порівняйте відбиток.

Підтвердити цю інсталяцію
Підтвердити цю інсталяцію
Заявлення прав на цю інсталяцію. Код із термінала вводиться трьома групами, а сторінка показує повний відбиток групами по чотири символи для порівняння; прострочений код відхиляється з помилкою CLAIM_CODE_EXPIRED, і права не заявляються.

Дві пов'язані відповіді:

  • RATE_LIMITED (429) на сторінці заявлення прав означає, що за останню хвилину на сторінці було зроблено кілька спроб. Зачекайте вказану кількість секунд. Якщо ці спроби робили не ви, хтось інший у вашій мережі намагається скористатися сторінкою; з'ясуйте, хто це, перш ніж заявляти права.
  • TRANSITION_NOT_PERMITTED (409) означає, що права на інсталяцію вже заявлено, і сторінку заявлення прав вимкнено назавжди. Натомість виконайте вхід. Якщо права заявляли не ви, розглядайте це як інцидент безпеки.

Відбиток не збігається

Сторінка заявлення прав показує CLAIM_FINGERPRINT_MISMATCH (403), або ви самі бачите, що вісім груп по чотири символи на сторінці відрізняються від тих, які вивів ваш термінал. Навіть одна відмінна група означає, що браузер взаємодіє з іншою інсталяцією.

Зупиніться. Не вводьте код на цій сторінці. За цією адресою може відповідати щось інше, а не ваша інсталяція — можливо, машина, налаштована для перехоплення даних першого адміністратора. Якби ви заявили на неї права, ця машина отримала б дані вашої організації. Ваша власна інсталяція залишається незмінною, і права на неї все ще не заявлено.

Перевірте, куди вказує ім'я та який сертифікат відповів:

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

Адреса має належати вашому ingress-контролеру, а сертифікат має бути тим, який ви встановили для hosts.console.

Відбиток не збігається
Відбиток не збігається
Відбитки відрізняються у трьох із восьми груп. Сторінка наказує зупинитися, пояснює, хто може відповідати, і наводить перелік того, що слід перевірити перед повторною спробою.

Щоб виправити це, передайте своїй команді з безпеки адресу, яка відповіла, і збережіть журнал установлення, у якому записано відбиток, виведений інсталяцією. Виправте запис Domain Name System (DNS) або проксі-сервер, який спрямував вас в інше місце. Потім створіть новий код заявлення прав за допомогою nexusctl claim-code --administrator <email> і заявіть права з браузера в мережі, якій ви довіряєте, знову порівнявши всі вісім груп.

Ліцензію відхилено

Імпорт на сторінці імпорту ліцензії (Import the licence), імпорту нової ліцензії (Import a new licence) або через nexusctl licence import відповідає відмовою. Відхилений імпорт нічого не змінює: чинна ліцензія залишається чинною, а нижня межа годинника не зсувається.

Прочитайте код і крок:

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

Тіло відповіді про відмову містить code, message, refused_at (крок, на якому стався збій) та troubleshooting. Щоб побачити стан чинної ліцензії, зчитайте GET https://auth.harrow.example/api/v1/installation/licence/state із тим самим токеном.

Код HTTP Звичайна причина Виправлення
LICENCE_SIGNATURE_INVALID 422 Файл було відредаговано, переформатовано чи перезбережено, або відсутній один із підписів Завантажте його знову зі свого облікового запису та імпортуйте без змін
LICENCE_FORMAT_INVALID 422 Це не ліцензія: неправильний файл, файл обрізано або загорнуто в інший об'єкт Надішліть файл точно в тому вигляді, в якому його надала система Adverant
LICENCE_ROOT_UNKNOWN 422 Підписано ключем, якого немає в цьому релізі Оновіть систему або попросіть ліцензію, підписану для вашого релізу
LICENCE_MATRIX_MISMATCH 422 Створено для новішої матриці редакцій або надає групу, невідому цій збірці Оновіть систему або попросіть ліцензію, створену для вашого релізу
LICENCE_OTHER_INSTALLATION 409 Видано для іншої інсталяції, часто це ліцензія тестового кластера на продуктивному середовищі Попросіть ліцензію для ідентифікатора цієї інсталяції
LICENCE_REVOKED 403 Adverant відкликав її Попросіть у Adverant нову ліцензію
LICENCE_LOCKED 403 Її значення starts_on пізніше за поточну дату Імпортуйте її в перший день дії або пізніше
TRANSITION_NOT_PERMITTED 409 Цей ідентифікатор ліцензії вже було імпортовано Нічого не потрібно робити, якщо вона чинна; зверніться до Adverant, якщо потрібно змінити умови
RECORD_NOT_FOUND 404 Інсталяцію ще не оголошено, тому вона ще не має ідентифікатора Завершіть крок першого адміністратора, а потім виконайте імпорт
TENANT_NOT_A_PARAMETER 403 Тіло запиту вказує організацію на верхньому рівні Надішліть лише сам файл ліцензії як тіло запиту

Дві речі виглядають як проблеми з ліцензією, але ними не є. Зчитування стану, яке містить LICENCE_CLOCK_BEHIND_FLOOR, означає, що годинник вузла показує раніший час, ніж останній час, зафіксований інсталяцією; виправте час на вузлі, а якщо годинник забіг уперед і посунув за собою нижню межу часу, попросіть у Adverant токен скидання часу. А ліцензія, яка імпортується, але все одно показує групу як ознайомчу (teaser), зазвичай не надає прав на цю групу: насамперед перевірте надані права на сторінці ліцензії.

ШІ не відповідає

Помічник на базі штучного інтелекту (ШІ) показує MODEL_NOT_CONNECTED (503), крок робочого процесу завершується помилкою NO_PROVIDER_FOR_ROLE (422) або відповіді просто припиняються.

У пулі організації немає ключа, який може відповісти, або маршрутизатор не може зв'язатися з постачальником. Кожна організація використовує власний ключ моделі. Якщо немає жодного активного ключа, ШІ не працює за задумом, і жоден спільний ключ не підставляється на заміну.

Перевірте пул і вибір маршрутизатора, використовуючи в обох випадках власний токен доступу користувача:

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

Перший запит виводить список усіх постачальників, інформацію про те, чи може він відповісти і чому ні («Немає активного ключа: 1 відкликано, 1 прострочено»), а також стан кожного ключа. Другий повідомляє модель, яку маршрутизатор використав би для організації, або текст відмови. Потім перевірте шлях виходу з кластера за допомогою цих двох команд:

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

Що означає кожен результат:

Виявлено Виправлення
У пулі немає ключа Власник або адміністратор додає ключ організації на комутаційній панелі ШІ або в розділі Налаштування, Моделі ШІ
Ключі у стані invalid, expired або exhausted Додайте новий ключ; старий залишиться у списку для історії
Ключі у стані resting Зачекайте: ключ, який дав збій, відпочиває протягом 60 секунд, а після 5 збоїв поспіль вимикається (PROVIDER_KEY_SWITCHED_OFF)
NO_PROVIDER_FOR_ROLE за наявності активних ключів Роль не має призначення, і нічого не збігається; задайте роль у політиці маршрутизації
MODEL_CAPABILITY_UNAVAILABLE (422) Запит потребує можливості або регіону розміщення даних, які не пропонує жоден постачальник у пулі; увімкніть постачальника, який це підтримує
Немає політики nexus-operator-egress або в ній відсутні діапазони адрес постачальника Додайте діапазони в нотації Classless Inter-Domain Routing (CIDR) до networkPolicy.externalEgressCIDRs та виконайте оновлення
Локальний сервер моделей не відповідає Перевірте ai.localProvider.baseUrl, укажіть сервер у ai.installationHosts та дозвольте його діапазон у networkPolicy.externalEgressCIDRs

Якщо ключ хмарного постачальника працює з ноутбука, але дає збій в інсталяції, причиною майже завжди є мережева політика. Простір імен за замовчуванням забороняє вихідний трафік (egress).

Відповіді 429

Клієнт отримує відповідь 429 Too Many Requests. У Nexus є чотири місця, які можуть повернути цей код, і тіло відповіді вказує, яке саме з них спрацювало.

Де Код і подробиці Що змінити
nexus-auth, на кожного авторизованого користувача RATE_LIMITED з limit, windowSeconds та retryAfterSeconds auth.rateLimitPerMinute (за замовчуванням 5000), для інтенсивної автоматизації
Ліміт ключа скрипту, застосунку або підрозділу (Enterprise) RATE_LIMITED із зазначенням ключа та його ліміту Ліміт у розділі Налаштування, Ліміти запитів, із зазначенням причини
Сторінка заявлення прав під час першого запуску RATE_LIMITED з retry_after_seconds Нічого: зачекайте та з'ясуйте, хто ще намагається скористатися сторінкою
Постачальник моделей Маршрутизатор розглядає це як тимчасовий збій і переходить до наступного постачальника Додайте інший ключ або постачальника, якщо це трапляється часто

Кожна така відповідь містить заголовок Retry-After. Коректно налаштований клієнт чекає вказаний час і не повторює спробу раніше.

Якщо здається, що всі користувачі одночасно ділять один спільний ліміт, перевірте proxy.trustedCIDRs. Коли цей параметр не охоплює мережу подів вашого ingress-контролера, nexus-auth не може довіряти заголовку X-Forwarded-For і сприймає кожен запит як такий, що надходить від самого контролера. Значення за замовчуванням, 10.42.0.0/16, підходить лише для k3s.

kubectl get pods -A -o wide

Знайдіть у виведених даних адресу пода ingress-контролера і переконайтеся, що proxy.trustedCIDRs охоплює її.

Помилки під час оновлення

Оновлення було відкочено. Сторінка оновлення (Upgrade) показує UPGRADE_ROLLED_BACK: на одному з кроків стався збій, усі рушії повернулися до попереднього релізу, а дані не змінилися. На сторінці вказано назву цього кроку. Поширеною причиною є замалий том для нової структури сховища. Виправте зазначену проблему, запустіть nexusctl upgrade plan --bundle <file> знову, а потім застосуйте зміни. Спершу буде знову створено резервну копію.

Чарт відмовляється рендеритися з помилкою EXTERNAL_KEY_ENCRYPTION_KEY_INVALID. Об'єкт Secret nexus-generated містить EXTERNAL_KEY_ENCRYPTION_KEY у форматі, який чарт не може використати. Це має бути рядок base64 із 32 байтів або необроблений 32-байтовий ключ старішої інсталяції. Хтось відредагував або замінив цей об'єкт Secret. Поверніть ключ, яким запечатано дані цієї інсталяції, у форматі base64 з його 32 байтів (printf %s "$OLD" | base64), і повторіть оновлення. Не дозволяйте чарту створювати новий ключ: дані, запечатані старим ключем, залишаться нечитабельними.

Скрипти відхиляються з помилкою TOKEN_ORG_MISSING після оновлення. Кожен сервіс, який перевіряє ключі інтерфейсу програмування застосунків (API) через nexus-auth, тепер відхиляє ключі без організації з помилкою 403 TOKEN_ORG_MISSING. Призначте кожному такому ключу організацію або випустіть новий ключ.

Ключі повідомляють неправильний застосунок протягом години. Очистьте кешовані записи ключів у кеші nexus-auth — сховищі Valkey цієї інсталяції. Розділ 2.15, День другий: експлуатація Nexus, містить команду як для внутрішньокластерного сховища, так і для зовнішнього.

Стався збій хука міграції. helm upgrade повідомляє про збій хука перед оновленням. Схема оновлюється до розгортання нових подів, тому поточний реліз продовжує обслуговувати запити. Прочитайте журнал завдання Job за допомогою kubectl -n nexus logs job/<job-name>, виправте зазначену проблему та запустіть оновлення знову.

Сервіси не могли використовувати свої таблиці протягом кількох секунд. Під час першого оновлення інсталяції, створеної зі старішого чарта, кожен сервіс втрачає свої старі права на таблиці за замовчуванням і отримує власні права зі своєї міграції. Цей проміжок триває лічені секунди. Проводьте оновлення в період низького навантаження або спершу масштабуйте сервіси до нуля.

Реліз на диску було відхилено. Імпорт із носія показує MEDIA_SIGNATURE_INVALID (422): файли не підписано ключем релізу, встановленим у цій інсталяції. Нічого не було завантажено, і поточний реліз продовжує працювати. Збережіть носій для своєї команди з безпеки та попросіть у Adverant новий носій через офлайн-обмін.

Відмова рендерингу чарту

helm install, helm upgrade або helm template зупиняється до застосування будь-яких змін із повідомленням, яке починається з коду або називає значення. Чарт відхиляє значення, з якими він не може безпечно працювати. У кластері нічого не змінилося.

Відрендерте чарт окремо, щоб побачити всі відмови, не зачіпаючи кластер. Для редакції Enterprise використовуйте завантажений чарт Enterprise замість адреси oci:// і задайте networkPolicy.apiServerCIDRs у значеннях, оскільки під час офлайн-рендерингу неможливо зчитати це з кластера:

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

Попередня перевірка (preflight) перевіряє ті самі значення ідентифікації у своєму розділі «час і ключі» та повідомляє ті самі коди. Її код виходу становить 0, коли установлення можна продовжувати (попередження не блокують процес), 1, коли принаймні одна перевірка завершилася збоєм, і 2, коли її не вдалося запустити.

Попередню перевірку неможливо продовжити
Попередню перевірку неможливо продовжити
Попередня перевірка не може продовжитися. Спершу виводяться невдалі перевірки, кожна зі способом виправлення, а установлення залишається заблокованим зі статусом PREFLIGHT_FAILED, доки вони не пройдуть успішно.
Відмова Причина Виправлення
INSTALLATION_NAME_MISSING Значення keys.installationName порожнє Задайте власне ім'я цієї інсталяції, що збігається з ^[a-z][a-z0-9-]{0,62}$. Воно стає постійним після першого запуску сховища ключів
INSTALLATION_NAME_EXAMPLE Ім'я збігається з тим, що вказане у прикладах файлів значень чарта Задайте власне ім'я
keys.installationName "…" does not match … Великі літери, символи підкреслення або цифра на початку Використовуйте малі літери, цифри та дефіси, починаючи з літери
KEYS_CUSTODIAN_MISSING Значення keys.custody.recipients порожнє Укажіть отримувачів age ваших зберігачів ключів (відкриті частини ключів)
KEYS_CUSTODIAN_EXAMPLE Отримувачем є тестовий зберігач ключів із файлів значень чарта, ідентифікатором якого ніхто не володіє Замініть його на отримувачів ваших власних зберігачів ключів
keys.custody.recipients: … Отримувач у форматі, для якого завдання Job зберігання ключів не може виконати шифрування Використовуйте age1…, age1tag1…, age1tagpq1…, age1pq1… або age1se1… у нижньому регістрі
NEXUS_EDITION_INVALID edition не дорівнює ні community, ні enterprise Установіть одне з двох значень
edition=… but enterprise.enabled=… Ці два параметри суперечать один одному Установлюйте enterprise.enabled: true лише тоді, коли edition має значення enterprise
global.imageRegistry is required Не вказано реєстр Укажіть реєстр, з якого ваші вузли завантажують образи
hosts.<name> is required Відсутній публічний хост Задайте hosts.console, hosts.api та hosts.auth
tls.existingSecret is required when tls.mode is existing Не вказано об'єкт Secret сертифіката Укажіть ім'я об'єкта Secret або виберіть інший tls.mode
tls.clusterIssuer is required when tls.mode is cert-manager Не вказано видавця Укажіть ім'я вашого ClusterIssuer
dataTier.<store>.external.host is required when mode is external Зовнішнє сховище без адреси Укажіть його хост і його об'єкт Secret у existingSecret
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read helm template не має кластера, у якому їх можна було б знайти Укажіть адреси сервера API як діапазони у /32
EXTERNAL_KEY_ENCRYPTION_KEY_INVALID Згенерований ключ у nexus-generated має неправильний формат Див. розділ «Помилки оновлення» вище

Файл значень, у якому використано ключ, відсутній у чарті, або значення неправильного типу, відхиляється схемою чарта ще до будь-якої з цих перевірок. Одним із прикладів є telemetry.enabled: true: схема приймає лише false.

Надсилання пакета діагностики до підтримки

Якщо нічого з цього не допомогло, надішліть у Adverant пакет підтримки разом зі своїм запитом до служби підтримки.

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

<request-number> — це номер запиту, який ви відкрили на сторінці підтримки та пакетів підтримки свого облікового запису. Ви можете створити такий самий пакет зі сторінки пакета підтримки (Support bundle) у консолі в розділі Ця інсталяція (This installation).

Пакет містить журнали рушіїв за останні 24 години, відомості про працездатність і версії, налаштування без секретів, а також звіти попередньої перевірки та установлення. Перед записом пакета засіб цензурування замінює імена, секрети й адреси, і ви бачите у попередньому перегляді все, що буде надіслано. Повідомлення, файли та пам'ять користувачів ніколи не збираються.

Завантажте його у запит у своєму обліковому записі або збережіть на носій і перенесіть вручну, якщо інсталяція не має зовнішнього з'єднання. Відкрити його можуть лише інженери підтримки, зазначені в запиті, і через 30 днів він видаляється. Укажіть у запиті, яку саме з наведених вище проблем ви розглядали і що показали перевірки з цього розділу: це заощадить час на додаткове листування.