DigiVC документация

DigiVC документация

Отстраняване на проблеми

Причина: PostgreSQL client пакетът не е инсталиран.

psql или pg_isready липсва

Причина: PostgreSQL client пакетът не е инсталиран.

На Oracle Linux 9 PostgreSQL client съдържа psql и pg_isready; server пакетът е отделен. Production installer-ът трябва да осигури клиента автоматично. Проверка:

command -v psql
command -v pg_isready
psql --version

server does not support SSL, but SSL was required

PostgreSQL server няма SSL, а е избран require/verify-*.

Решение: стартирайте setup отново и изберете правилния SSL mode. За защитена вътрешна връзка без SSL използвайте disable.

Липсва bootstrap.key

  • При HTTP listener TLS bootstrap key не трябва да е необходим.
  • При HTTPS listener installer/lifecycle трябва автоматично да създаде и валидира key/certificate pair.

Не създавайте произволен key ръчно, освен при официална recovery процедура.

Не мога да вляза от Desktop Client

Проверете:

  • server URL е само origin, например https://digivc.example;
  • username/password са правилни;
  • акаунтът е Active;
  • няма задължителна смяна на временната парола;
  • сертификатът е доверен от операционната система.

needs update или tree version conflict

Remote repository е по-нов. Изпълнете Update, разрешете конфликтите и опитайте commit отново.

Commit е блокиран от validation

Отворете Repository → Checks и прегледайте finding-ите. Поправете syntax error, forbidden path или потенциален secret. Не заобикаляйте gate-а чрез ръчно променяне на server данни.

Repository е read-only

Това е административно state. Свържете се с owner/administrator и посочете repository и причината, поради която е нужен commit.

CLI password file е отказан

Проверете:

ls -l ~/.digivc-password
chmod 600 ~/.digivc-password

Файлът не трябва да е symlink и трябва да е собственост на текущия user.

Импортът е бавен

Пълната source история може да е голяма. Проверете active stage, progress и storage. Не рестартирайте насилствено сървъра, ако worker-ът има активност. При прекъсване job-ът трябва да се маркира като interrupted/failed, а partial repository да не изглежда успешно.

Какво да изпратя на поддръжката

  • точен час;
  • username и засегнат project/repository;
  • correlation ID;
  • операцията, която сте изпълнили;
  • screenshot или копие на видимото съобщение;
  • при build — target build log и името на build/release артефакта.

Не изпращайте пароли, access tokens или private keys.