Hub-ты орналастыру кезіндегі типтік мәселелер және оларды шешу жолдары

Орнату кезіндегі ақауларды жою

Бұл бөлім Hub-ты орналастыратын адамға арналған: мұнда іске қосу, Core-ға қосу және белсендіру кезіндегі типтік мәселелер, сондай-ақ оларды шешу жолдары сипатталған.

Hub іске қосылмайды

Логтарды тексеріңіз

bash
docker compose logs hub
docker compose logs postgres

PostgreSQL әлі дайын емес

Симптом: Hub іске қосылған соң бірден дерекқорға қосылу қатесімен құлайды.

Себебі: Hub PostgreSQL байланысты қабылдағаннан бұрын стартады.

Шешім: Docker Compose PostgreSQL дайындығын health check арқылы күтеді — өзгертусіз түпнұсқа docker-compose.yml файлын пайдаланғаныңызды тексеріңіз. Егер мәселе қайталанса, қайта іске қосыңыз:

bash
docker compose restart hub

Дұрыс емес орта айнымалылары

Симптом: Hub іске қосылды, бірақ дұрыс жұмыс істемейді.

Шешім: .env файлындағы барлық міндетті айнымалылардың толтырылғанын тексеріңіз. Әсіресе DATABASE_PASSWORD-ты тексеріңіз — ол PostgreSQL инициализациясы кезінде қолданылған мәнмен сәйкес келуі керек.

!

Егер сіз алғашқы іске қосудан кейін DATABASE_PASSWORD-ты өзгерткен болсаңыз, дерекқор оны қабылдамайды. Томды жойып, қайтадан бастау керек: docker compose down -v. Бұл кезде барлық деректер жойылады.

Hub Core-ға қосылмайды

Hub логтарын тексеріңіз

Core-мен байланыс күйі Hub логтарында көрінеді:

bash
docker compose logs -f hub

Hub Core-мен байланысты жаңа орнатып жатқан кезде логтарда қайталанған әрекеттер туралы хабарлар пайда болуы мүмкін — алғашқы іске қосудан кейін бірнеше минут ішінде бұл қалыпты. Егер байланыс орнатылмаса, төмендегі кестемен салыстырыңыз.

Ықтимал себептер

Логтардағы симптомСебебіШешімі
SslHandler бар UNAVAILABLE: io exceptionCore-мен қосылу кезіндегі TLS-қатеCORE_GRPC_HOST дұрыстығын тексеріңіз; мекенжай дұрыс болса — қолдау қызметіне жүгініңіз
UNAVAILABLE: Connection refusedCore қолжетімсіз немесе мекенжай дұрыс емесCORE_GRPC_HOST пен 443 порттың қолжетімділігін тексеріңіз
Connection timed outCore-ға дейін желі қолжетімділігі жоқФайервол/желі ережелерін тексеріңіз

Желі қолжетімділігін тексеріңіз

bash
# Hub контейнерінен
docker compose exec hub curl -v https://${CORE_GRPC_HOST}:443

Docker-образды жүктеу мүмкін емес

Симптом: docker compose pull қатемен аяқталады.

Шешім: .env файлындағы HUB_IMAGE мәні вендор бергендей дәлме-дәл көрсетілгенін және серверде образды жүктеу үшін интернетке қолжетімділік барын тексеріңіз.

Симптом: docker compose up -d (немесе docker compose pull) кезінде образды жүктеу failed to copy: httpReadSeeker: failed open ... EOF түріндегі қатемен үзіледі.

Шешім: Бұл — реестрден образды жүктеу кезіндегі уақытша желі ақауы. Жай ғана команданы қайталаңыз — Docker жетіспейтін қабаттарды жүктеп алады. Кейде бірнеше әрекет қажет.

Hub күйі — OUT_OF_SERVICE

Бұл қалыпты, егер Core уақытша қолжетімсіз болса. Hub жұмысын жалғастырады: интерфейске кіре аласыз, баптауларды өңдей аласыз. Тек сауда (ставкаларды есептеу) қолжетімсіз.

Байланыс автоматты түрде қалпына келеді — Hub қайталанған әрекеттерде экспоненциалды кері шегінуді қолданады.

Портал арқылы Hub-ты белсендіру мүмкін емес

Симптом: Порталға өтіп, «Байланыстыру» түймесін басқаннан кейін қайта бағыттау Hub-қа қайтармайды немесе Hub белсендіру қатесін көрсетеді.

Шешімдер:

  • Порталға оралып, «Байланыстыру» түймесін қайта басыңыз.
  • Hub браузерді ашып тұрған мекенжай бойынша қолжетімді екенін тексеріңіз.
  • .env файлындағы CORE_PORTAL_URL дұрыс көрсетілгенін тексеріңіз.

WB-токен қабылданбайды

Бұл сұрақ Hub-ты орналастыруға емес, оның интерфейсімен жұмысқа қатысты. Толығырақ — WB-аккаунтты қосу және Hub ақауларын жою бөлімдерінде.

Health-статустарды түсіндіру

Компонент статусыМағынасы
r2dbc: UPДерекқор қосылған
grpcChannel: READYCore қосылған, Hub толық режимде
grpcChannel: TRANSIENT_FAILURECore қолжетімсіз, Hub қайта қосылып жатыр
diskSpace: UPДискіде орын жеткілікті
status: OUT_OF_SERVICECore қолжетімсіз (Hub жұмыс істейді, сауда тоқтатылған)

Әкімшілендіру кезіндегі жиі қойылатын сұрақтар

Hub-ты басқа серверге көшіруге бола ма?

Иә. Процедура:

1
PostgreSQL дерекқорының резервтік көшірмесін жасаңыз.
2
Жаңа серверде Hub-ты сол орта айнымалыларымен орналастырыңыз (әсіресе CIPHER_SALT маңызды — ол түпнұсқамен сәйкес болуы керек).
3
Дерекқорды резервтік көшірмеден қалпына келтіріңіз.
4
Core порталы арқылы белсендіруді қайталаңыз.
!

CIPHER_SALT токендерді шифрлау үшін қолданылады. Егер ол өзгерсе, Hub сақталған кілттерді шеше алмайды — барлық API-токендерді қайта жасау қажет болады.

Hub үшін HTTPS қолдалады ма?

Hub HTTP арқылы жұмыс істейді. HTTPS үшін кері прокси (nginx, Traefik және т.б.) немесе Kubernetes жағдайында Ingress пайдаланыңыз.

Kubernetes-тегі Hub-ты TLS-пен Ingress арқылы да баптауға болады — қараңыз: Kubernetes арқылы орнату.