156 lines
8.8 KiB
Markdown
156 lines
8.8 KiB
Markdown
# Инструкция по развертыванию и настройке 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
|
||
```
|
||
|
||
---
|