gromov/gitea-server
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
1c4d5c093b6499fd628b96a244ebfa50edec715f
gitea-server/README.md
S.Gromov 1c4d5c093b init gitea server
2025-10-23 02:17:39 +03:00

8.8 KiB
Raw Blame History

Инструкция по развертыванию и настройке Gitea

Данная инструкция предназначена для запуска Git сервера на локальной машине с URL 127.0.0.1.

Это дает возможность протестировать:

  • ✅ Git сервер
  • ✅ Ранеры (Gitea Actions)
  • ✅ Отправку писем (SMTP)
  • ✅ Интеграцию с S3

⚠️ Ограничения локального режима: В локальном режиме не доступен Container Registry, так как для его работы требуется https.

Оглавление

  1. Настройка и запуск GIT сервера
  2. Настройка и запуск ранеров
  3. Возможные проблемы и их решение

Настройка и запуск GIT сервера

В этом разделе описано, как поднять сервер Gitea локально на своем ПК. Инструкции по настройке производственной среды (прода) находятся в разделе Настройка прод сервера.

Шаг 1: Конфигурация

  1. Перейдите в директорию server: 
    cd server
  2. Скопируйте файл env.example в .env в корневой директории проекта: 
    cp env.example .env

Шаг 2: Запуск сервера

  1. Убедитесь, что у вас установлен Docker и Docker Compose.
  2. Выполните следующую команду для запуска Gitea в фоновом режиме: 
    docker-compose up -d
  3. Сервер будет доступен по адресу http://127.0.0.1:8080 (по умолчанию) или по адресу, указанному в переменной GITEA__server__INSTANCE в файле .env.
  4. При первом входе вы увидите страницу Начальная конфигурация. Базовую настройку лучше не трогать. Вам нужно только указать:
    • Название сайта: Имя вашего Gitea-сервиса.
    • Настройки учётной записи администратора: Создайте логин и пароль для главного администратора.
    • По желанию можно изучить Расширенные настройки, чтобы включить капчу, отключить публичную регистрацию и т.д.
  5. Поздравляем! На этом этапе вы уже можете работать с вашим GIT сервером: создавать репозитории, клонировать и пушить.

Шаг 3: Настройка темы GitHub (по желанию)

Для выполнения этих шагов, вы должны находиться в директории server/.

  1. Остановите сервер Gitea.

    docker-compose down

  2. Найдите последнюю версию темы. Перейдите на страницу релизов gitea-github-theme и скопируйте номер последней версии (например, v1.24.5).

  3. Создайте директорию, скачайте тему и установите права. Выполните следующие команды, подставив актуальную версию вместо v1.24.5.

    # Создаем директорию для кастомных тем
mkdir -p data/gitea/custom/public/assets/css/

# Скачиваем архив и распаковываем его содержимое (пропуская папку 'dist')
curl -L https://github.com/lutinglt/gitea-github-theme/releases/download/v1.24.5/theme-github.tar.gz | tar -xz --strip-components=1 -C data/gitea/custom/public/assets/css/

# Меняем владельца директории, чтобы у Gitea был доступ
chown -R 1000:1000 data/gitea/custom

  4. Измените тему по умолчанию. Откройте файл .env и измените значение переменной GITEA__ui__DEFAULT_THEME:

    GITEA__ui__DEFAULT_THEME=github-auto

  5. Запустите сервер. Перезапустите Gitea, чтобы применить изменения.

    docker-compose up -d --force-recreate

  6. Проверьте установку. После запуска сервера перейдите в "Настройки профиля" => "Внешний вид" и убедитесь, что тема по умолчанию установлена как github-auto. В списке доступных тем также должны появиться github-light, github-dark и github-soft-dark.

Настройка и запуск ранеров

  1. Перейдите в админ-панель Gitea по адресу http://127.0.0.1:8080/-/admin/actions/runners/ и нажмите "Создать новый раннер".
  2. Скопируйте полученный токен.
  3. Откройте файл runners/docker-compose.yaml и вставьте токен в переменную GITEA_RUNNER_REGISTRATION_TOKEN. 
    environment:
  - GITEA_RUNNER_REGISTRATION_TOKEN=СЮДА_ВСТАВИТЬ_ВАШ_ТОКЕН
  4. Перейдите в директорию runners и запустите раннер: 
    cd runners
docker-compose up -d
  5. Перейдите на вкладку http://127.0.0.1:8080/-/admin/actions/runners/ и убедитесь что появился новый раннер, индикатор "Статус" - горит зеленым.

Возможные проблемы и их решение

1. Изменения в конфигурации сервера не применяются

Если вы изменили значения в файле .env, необходимо перезапустить сервер с ключом --force-recreate для принудительного пересоздания контейнера:

cd server
docker-compose down
docker-compose up -d --force-recreate

2. Проблемы с ранерами после изменения конфигурации

Если вы изменили настройки ранера или возникли проблемы с его работой, самый эффективный способ решения:

  1. Остановите ранер:

    cd runners
docker-compose down

  2. Удалите директорию с данными ранера:

    sudo rm -rf gitea-runner-1

  3. Создайте новый токен регистрации:

  4. Обновите токен в конфигурации: Откройте файл runners/docker-compose.yaml и замените значение GITEA_RUNNER_REGISTRATION_TOKEN на новый токен.

  5. Запустите ранер с принудительным пересозданием:

    docker-compose up -d --force-recreate