Диагностика проблем Self-Hosted GitFlic

Данный раздел может помочь при диагностике и устранении неполадок Self-Hosted GitFlic.

Общие советы

Просмотр логов приложения

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

Путь до файла с логами указывается в конфигурационном файле GitFlic (application.properties). Путь до файла по умолчанию: /var/log/gitflic/server.log.

# ======= Настройки логирования =======

# Настройки название и пути файла логов
# Свойcтво logging.file.name должно содержать в себе название файла. Стандартное значение server.log.
# Название файла может содержать в себе как относительный путь к директории из которой происходит запуска приложения
# так и точный путь, если он начинается с /
# Обратите внимание, что на каждый запущенный инстанс можно указать свой файл логов, в ином случае будет использован один
# файл для всех инстансов
#logging.file.name=/opt/gitflic/log/server.log

Далее приведены ошибки, которые чаще всего возникали у пользователей:

Проблема 1:

Unable to connect to Redis; nested exception is io.lettuce.core.RedisConnectionException: Unable to connect to example.com:6379

Решение: Проверить работоспособность Redis, указать корректные credentials для подключения в application.properties GitFlic

Проблема 2:

Ошибка создания репозитория

Превышен лимит репозиториев, которые вы можете создать

Решение: Данная ошибка встречается из-за того, что не была создана папка, где должны храниться репозитории, указанная в файле application.properties

Обратите внимание: данная проблема актуальна только для GitFlic версий 2..

Запуск GitFlic в Docker

Неправильно отображается маршрут для проекта в GitFlic, запущенного в docker:

В Docker маршрут для transport.url формируется в трех местах (default-config/application.properties, docker-compose.yml, ENV). Для изменения transport.url рекомендую внести изменения в docker-composer.yml, по умолчанию он определён, как GITFLIC_TRANSPORT_URL: http://${GITFLIC_TRANSPORT_URL}:${SERVER_PORT} Если ваш сервис доступен по 443 или 80 порту, то измените данный параметр на GITFLIC_TRANSPORT_URL: https://gitflic.ru. Указывать порт при работе с этими портами не нужно.

Установка и настройка postgresql

При настройке postgresql выходит ошибка запуска расширение pgcrypto:

Проверить что команда CREATE EXTENSION pgcrypto; прописана для правильной базы (например, gitflic). (Подробная информация)
Проверить, что установлен компонент postgresql-contrib.
В файле: /var/lib/pgsql/data/pg_hba.conf или /etc/postgresql/12/main/pg_hba.conf замените строку host all all 127.0.0.1/32 ident на host all all 127.0.0.1/32 md5 для использования аутентификации по паролю.
Если выходит ошибка "Не найден pg_hba.conf". Выполняем следующие команды:
```
sudo -i -u postgres
psql -t -P format=unaligned -c 'show hba_file';
```