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

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

Это дает возможность протестировать:
- ✅ Git сервер
- ✅ Ранеры (Gitea Actions)
- ✅ Отправку писем (SMTP)
- ✅ Интеграцию с S3

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

## Оглавление
1. [Настройка и запуск GIT сервера](#настройка-и-запуск-git-сервера)
    - [Шаг 1: Конфигурация](#шаг-1-конфигурация)
    - [Шаг 2: Запуск сервера](#шаг-2-запуск-сервера)
    - [Шаг 3: Настройка темы GitHub (по желанию)](#шаг-3-настройка-темы-github-по-желанию)
2. [Настройка и запуск ранеров](#настройка-и-запуск-ранеров)
3. [Возможные проблемы и их решение](#возможные-проблемы-и-их-решение)
    - [1. Изменения в конфигурации сервера не применяются](#1-изменения-в-конфигурации-сервера-не-применяются)
    - [2. Проблемы с ранерами после изменения конфигурации](#2-проблемы-с-ранерами-после-изменения-конфигурации)


---

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

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

### Шаг 1: Конфигурация
1.  Перейдите в директорию `server`:
    ```bash
    cd server
    ```
2.  Скопируйте файл `env.example` в `.env` в корневой директории проекта:
    ```bash
    cp env.example .env
    ```

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

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

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

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

1.  **Остановите сервер Gitea.**
    ```bash
    docker-compose down
    ```

2.  **Найдите последнюю версию темы.**
    Перейдите на страницу релизов [gitea-github-theme](https://github.com/lutinglt/gitea-github-theme/releases) и скопируйте номер последней версии (например, `v1.24.5`).

3.  **Создайте директорию, скачайте тему и установите права.**
    Выполните следующие команды, подставив актуальную версию вместо `v1.24.5`.
    ```bash
    # Создаем директорию для кастомных тем
    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, чтобы применить изменения.
    ```bash
    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/](http://127.0.0.1:8080/-/admin/actions/runners/) и нажмите **"Создать новый раннер"**.
2.  Скопируйте полученный токен.
3.  Откройте файл `runners/docker-compose.yaml` и вставьте токен в переменную `GITEA_RUNNER_REGISTRATION_TOKEN`.
    ```yaml
    environment:
      - GITEA_RUNNER_REGISTRATION_TOKEN=СЮДА_ВСТАВИТЬ_ВАШ_ТОКЕН
    ```
4.  Перейдите в директорию `runners` и запустите раннер:
    ```bash
    cd runners
    docker-compose up -d
    ```
5.  Перейдите на вкладку [http://127.0.0.1:8080/-/admin/actions/runners/](http://127.0.0.1:8080/-/admin/actions/runners/) и убедитесь что появился новый раннер, индикатор "Статус" - горит зеленым.

---

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

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

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

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

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

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

1. **Остановите ранер:**
   ```bash
   cd runners
   docker-compose down
   ```

2. **Удалите директорию с данными ранера:**
   ```bash
   sudo rm -rf gitea-runner-1
   ```

3. **Создайте новый токен регистрации:**
   - Перейдите в админ-панель [http://127.0.0.1:8080/-/admin/actions/runners/](http://127.0.0.1:8080/-/admin/actions/runners/)
   - Нажмите **"Создать новый раннер"**
   - Скопируйте новый токен

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

5. **Запустите ранер с принудительным пересозданием:**
   ```bash
   docker-compose up -d --force-recreate
   ```

---