Перейти к содержанию

Обзор развертывания 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.

Процесс установки приложения

Развертывание выполняется в несколько этапов:

  1. Подготовка системы: Установка среды Docker и создание необходимых каталогов (/opt/gitea, /srv/gitea).

  2. Настройка окружения: Установка системного часового пояса Europe/Moscow через конфигурационные файлы /etc/timezone и /etc/localtime.

  3. Развертывание контейнера: Использование Docker Compose для запуска основного сервиса Gitea версии 1.22.2.

  4. Настройка проксирования: Создание конфигурации 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 необходимо выполнить следующие действия:

  1. Перейти в директорию с файлом конфигурации:

    cd /opt/gitea
    

  2. Выполнить обновление образа и перезапуск контейнера:

    docker compose pull && docker compose up -d
    

question_mark
Я могу вам чем-то помочь?
question_mark
ИИ Помощник ×