Версія 1.0.0-alpha.1найновіша
Розділ 2.17
Усунення несправностей
Проблеми, з якими оператори стикаються найчастіше, згруповані за зовнішніми проявами. Для кожної наведено причину, команду для її підтвердження та спосіб вирішення, а завершується розділ надсиланням пакета діагностики до служби підтримки.
Цю сторінку перекладено за допомогою ШІ з англійського оригіналу. Якщо щось незрозуміло, орієнтуйтеся на англійську версію сторінки. Читати цю сторінку англійською

Більшість проблем, що трапляються під час установлення Nexus, виникають із тих самих десятка причин, і майже всі вони повідомляють про себе кодом. Цей розділ упорядковано за тим, що ви бачите, приблизно в тому порядку, в якому ви б зіткнулися з кожною проблемою: установлення, заявлення прав, ліцензування, а потім експлуатація. Для кожної проблеми наведено причину, команду для її підтвердження та спосіб виправлення.
У прикладах використовується інсталяція Harrow Port Authority: простір імен nexus, реліз nexus, хости console.harrow.example, api.harrow.example та auth.harrow.example. Замініть їх на власні. Три звички заощадять час під час вирішення кожної наведеної тут проблеми:
- Читайте код перед повідомленням. Кожна відмова в Nexus закінчується машинним кодом, і саме за цими кодами проіндексовано цей розділ.
- Запускайте
nexusctl preflightзнову після будь-якої зміни в кластері чи файлі значень. Це зчитує кластер без внесення змін і повідомляє про більшість відмов чарта за назвою ще до того, як це зробить Helm. - Використовуйте
--explainдля будь-якої діїnexusctl, у якій ви не впевнені. Це виводить операціїkubectlтаhelmбез їх виконання.
Встановлення зависає
Ви запустили установлення, і воно не завершилося. helm не повернув керування через п'ятнадцять хвилин, або повернув, але поди все ще перебувають у стані Init чи Pending, або адреса консолі не відповідає.
Найпоширенішою причиною є helm install --wait. Nexus створює свою базу даних, ролі та схему кожного сервісу в хуках після установлення, а хук початкового завантаження передає кожному сервісу його пароль до бази даних. З --wait Helm чекає на готовність об'єктів Deployment перед тим, як запустити ці хуки, тоді як об'єкти Deployment чекають на хуки. Жоден із них не рухається далі. Ніколи не встановлюйте з --wait; установлюйте без нього та зачекайте після завершення.
Інші причини є звичайними для 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.iodescribe показує у своїх подіях помилки завантаження образів і незв'язані томи. Завдання 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 хвилин і знову порівняйте відбиток.
Дві пов'язані відповіді:
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, коли її не вдалося запустити.
| Відмова | Причина | Виправлення |
|---|---|---|
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 днів він видаляється. Укажіть у запиті, яку саме з наведених вище проблем ви розглядали і що показали перевірки з цього розділу: це заощадить час на додаткове листування.


