Обзор развертывания Gitea на сервере¶
Предварительные требования¶
Для корректной работы приложения требуются следующие параметры и настройки системы:
-
Операционная система: Ubuntu.
-
Права доступа: Пользователь
root. -
Часовой пояс:
Europe/Moscow. -
Порты:
-
3000(внутренний порт приложения). -
222(SSH для Git). -
443(HTTPS внешний доступ).
FQDN итоговой панели на домене hostkey.in¶
| Параметр | Значение | | Префикс | gitea | | Домен | hostkey.in | | Полный шаблон | gitea{Server_ID_from_Invapi}.hostkey.in |
Структура файлов и каталогов¶
В системе используются следующие директории для хранения конфигураций и данных:
-
/opt/gitea— рабочая директория приложения и файл развертывания Docker Compose. -
/srv/gitea— основное хранилище данных Gitea. -
/root/nginx— конфигурация прокси-сервера для управления SSL. -
/data/nginx/user_conf.d— директория с конфигурационными файлами Nginx.
Процесс установки приложения¶
Развертывание выполняется в несколько этапов:
-
Подготовка системы: Установка среды Docker и создание необходимых каталогов (
/opt/gitea,/srv/gitea). -
Настройка окружения: Установка системного часового пояса
Europe/Moscowчерез конфигурационные файлы/etc/timezoneи/etc/localtime. -
Развертывание контейнера: Использование Docker Compose для запуска основного сервиса Gitea версии
1.22.2. -
Настройка проксирования: Создание конфигурации Nginx с использованием Certbot для обеспечения работы по протоколу HTTPS и перенаправления трафика на внутренний порт приложения.
Права доступа и безопасность¶
-
Для каталогов данных установлены права доступа
0755. -
Владельцем директории
/srv/giteaявляется пользовательroot. -
Приложение работает в изолированной сети Docker.
Базы данных¶
В данной конфигурации база данных не вынесена в отдельный контейнер и должна быть настроена внутри приложения или подключена как внешняя служба (согласно параметрам Gitea). Данные хранятся в томе, привязанном к /srv/gitea.
Контейнеры Docker и их запуск¶
Приложение использует один основной контейнер для работы сервиса:
| Имя образа | Имя контейнера | Порты | Тома (volumes) | Переменные окружения | Политика перезапуска |
|---|---|---|---|---|---|
gitea/gitea:1.22.2 | gitea | 3000:3000, 222:22 | /srv/gitea:/data, /etc/timezone:/etc/timezone:ro, /etc/localtime:/etc/localtime:ro | USER_UID=1000, USER_GID=1000 | always |
Также используется вспомогательный контейнер для управления SSL-сертификатами:
-
Образ:
jonasal/nginx-certbot:latest. -
Сеть:
host. -
Тома:
nginx_secrets:/etc/letsencrypt,/data/nginx/user_conf.d:/etc/nginx/user_conf.d.
Инструкция по обновлению приложения¶
Для обновления основного приложения Gitea необходимо выполнить следующие действия:
-
Перейти в директорию с файлом конфигурации:
-
Выполнить обновление образа и перезапуск контейнера: