Перейти к основному содержимому

Диагностика и поддержка YouGile Podman

Решение проблем с Podman Compose​

Проверьте, что пользовательский сокет Podman запущен:

systemctl --user status podman.socket

Настройте переменную окружения DOCKER_HOST для rootless Podman:

export DOCKER_HOST=unix:///run/user/$(id -u)/podman/podman.sock

Проверьте работу Podman напрямую, без compose:

podman ps
podman logs yougile

Проверьте текущее значение DOCKER_HOST:

echo $DOCKER_HOST

Запуск​

Проверьте, не заняты ли необходимые порты:

ss -tlnp | grep ':8080\|:8443'

Проверьте и исправьте права доступа к директориям проекта:

sudo chown -R $USER:$USER ./yougile ./nginx ./certbot
chmod -R 755 ./yougile ./nginx ./certbot

Если YouGile не запускается, проверьте лог ошибок приложения:

cat ./yougile/logs/error.log

Проверьте логи контейнера YouGile:

podman logs yougile

Диагностические команды​

Проверьте конфигурацию Nginx внутри контейнера:

podman exec nginx nginx -t

Проверьте сетевое соединение между контейнерами:

podman exec nginx curl -v http://yougile:8001

Восстановление после сбоя​

Полная пересборка контейнеров без использования кэша:

podman compose down
podman compose build --no-cache
podman compose up -d

Повторная инициализация YouGile:

./yougile-docker

Изменение портов​

По умолчанию используются порты 8080 (HTTP) и 8443 (HTTPS).
Для изменения портов создайте файл docker-compose.override.yml:

services:
  nginx:
    ports:
      - "80:80"
      - "443:443"

Примените изменения:

podman compose down
podman compose up -d

Резервное копирование​

Остановите контейнеры перед выполнением резервного копирования:

podman compose down

Создайте директорию для резервной копии:

mkdir backup-$(date +%Y%m%d)

Создайте резервную копию базы данных:

podman run --rm -v yougile_yougile_database:/data -v $(pwd)/backup-$(date +%Y%m%d):/backup alpine tar czf /backup/database.tar.gz -C /data .

Создайте резервную копию пользовательских данных:

podman run --rm -v yougile_yougile_userdata:/data -v $(pwd)/backup-$(date +%Y%m%d):/backup alpine tar czf /backup/userdata.tar.gz -C /data .

Скопируйте конфигурационные файлы:

cp -r yougile nginx certbot backup-$(date +%Y%m%d)/

Запустите контейнеры после завершения резервного копирования:

podman compose up -d

Поддержка​

  1. Проверьте логи: ./yougile/logs/ и ./nginx/logs/

  2. Соберите диагностику:

    mkdir support-package
    cp -r ./yougile/logs ./nginx/logs support-package/
    cp ./yougile/conf.json ./nginx/nginx.conf docker-compose.yml support-package/
    tar -czf support-package.tar.gz support-package/
    rm -rf support-package

  3. Напишите на inf@yougile.com с архивом support-package.tar.gz