vault backup: 2025-08-04 16:12:28
This commit is contained in:
Andrey Epifancev
@@ -1,37 +1,409 @@
|
||||
# Git Service - Конфигурации
|
||||
|
||||
## Обзор конфигураций
|
||||
|
||||
Этот документ содержит детальную информацию о настройках всех компонентов Git Service.
|
||||
← **[[Обзор системы|← Назад к обзору]]**
|
||||
|
||||
## Docker Compose конфигурация
|
||||
|
||||
### Основной файл: `/DOCKER/git/docker-compose.yml`
|
||||
|
||||
*Документация будет дополнена с деталями конфигурации*
|
||||
```yaml
|
||||
version: '3.8'
|
||||
services:
|
||||
gitea:
|
||||
image: gitea/gitea:latest
|
||||
container_name: gitea
|
||||
environment:
|
||||
- USER_UID=1000
|
||||
- USER_GID=1000
|
||||
- GITEA__database__DB_TYPE=postgres
|
||||
- GITEA__database__HOST=db:5432
|
||||
- GITEA__database__NAME=gitea
|
||||
- GITEA__database__USER=gitea
|
||||
- GITEA__database__PASSWORD=sG7hZXBQDAtRab9A
|
||||
- GITEA__server__SSH_DOMAIN=git.aepif.ru
|
||||
- GITEA__server__SSH_PORT=2222
|
||||
volumes:
|
||||
- gitea_data:/data
|
||||
- /etc/timezone:/etc/timezone:ro
|
||||
- /etc/localtime:/etc/localtime:ro
|
||||
depends_on:
|
||||
- db
|
||||
networks:
|
||||
- default
|
||||
- proxy
|
||||
labels:
|
||||
- traefik.enable=true
|
||||
# HTTP routing
|
||||
- traefik.http.routers.gitea.rule=Host(`git.aepif.ru`)
|
||||
- traefik.http.routers.gitea.tls.certresolver=letsencrypt
|
||||
- traefik.http.services.gitea.loadbalancer.server.port=3000
|
||||
# TCP routing for SSH
|
||||
- traefik.tcp.routers.gitea-ssh.rule=HostSNI(`*`)
|
||||
- traefik.tcp.routers.gitea-ssh.entrypoints=ssh
|
||||
- traefik.tcp.services.gitea-ssh.loadbalancer.server.port=22
|
||||
restart: unless-stopped
|
||||
|
||||
db:
|
||||
image: postgres:14
|
||||
container_name: gitea_db
|
||||
environment:
|
||||
- POSTGRES_USER=gitea
|
||||
- POSTGRES_PASSWORD=sG7hZXBQDAtRab9A
|
||||
- POSTGRES_DB=gitea
|
||||
volumes:
|
||||
- postgres_data:/var/lib/postgresql/data
|
||||
networks:
|
||||
- default
|
||||
restart: unless-stopped
|
||||
|
||||
volumes:
|
||||
gitea_data:
|
||||
external: true
|
||||
name: gitea_gitea_data
|
||||
postgres_data:
|
||||
external: true
|
||||
name: gitea_postgres_data
|
||||
|
||||
networks:
|
||||
proxy:
|
||||
external: true
|
||||
default:
|
||||
driver: bridge
|
||||
```
|
||||
|
||||
## Gitea конфигурация
|
||||
|
||||
### Переменные окружения
|
||||
*Настройки Gitea через environment variables*
|
||||
### Environment Variables
|
||||
```yaml
|
||||
environment:
|
||||
# User Configuration
|
||||
- USER_UID=1000 # UID пользователя в контейнере
|
||||
- USER_GID=1000 # GID пользователя в контейнере
|
||||
|
||||
# Database Configuration
|
||||
- GITEA__database__DB_TYPE=postgres
|
||||
- GITEA__database__HOST=db:5432
|
||||
- GITEA__database__NAME=gitea
|
||||
- GITEA__database__USER=gitea
|
||||
- GITEA__database__PASSWORD=sG7hZXBQDAtRab9A
|
||||
|
||||
# Server Configuration
|
||||
- GITEA__server__SSH_DOMAIN=git.aepif.ru
|
||||
- GITEA__server__SSH_PORT=2222
|
||||
```
|
||||
|
||||
### Базовые настройки
|
||||
*Конфигурация через app.ini*
|
||||
### Расширенные настройки через переменные окружения
|
||||
```yaml
|
||||
environment:
|
||||
# Server Settings
|
||||
- GITEA__server__DOMAIN=git.aepif.ru
|
||||
- GITEA__server__ROOT_URL=https://git.aepif.ru
|
||||
- GITEA__server__DISABLE_SSH=false
|
||||
- GITEA__server__START_SSH_SERVER=true
|
||||
- GITEA__server__SSH_PORT=22 # Внутренний SSH порт
|
||||
- GITEA__server__SSH_LISTEN_PORT=22 # Порт прослушивания в контейнере
|
||||
|
||||
# Security Settings
|
||||
- GITEA__security__INSTALL_LOCK=true
|
||||
- GITEA__security__SECRET_KEY=your_secret_key_here
|
||||
|
||||
# Service Settings
|
||||
- GITEA__service__DISABLE_REGISTRATION=true
|
||||
- GITEA__service__REQUIRE_SIGNIN_VIEW=false
|
||||
- GITEA__service__ENABLE_NOTIFY_MAIL=false
|
||||
|
||||
# Repository Settings
|
||||
- GITEA__repository__DEFAULT_BRANCH=main
|
||||
- GITEA__repository__ENABLE_PUSH_CREATE_USER=true
|
||||
- GITEA__repository__ENABLE_PUSH_CREATE_ORG=false
|
||||
|
||||
# Webhook Settings
|
||||
- GITEA__webhook__ALLOWED_HOST_LIST=*
|
||||
- GITEA__webhook__SKIP_TLS_VERIFY=false
|
||||
```
|
||||
|
||||
### Структура конфигурации app.ini
|
||||
Gitea также поддерживает конфигурацию через файл `app.ini`:
|
||||
|
||||
```ini
|
||||
# /data/gitea/conf/app.ini внутри контейнера
|
||||
[database]
|
||||
DB_TYPE = postgres
|
||||
HOST = db:5432
|
||||
NAME = gitea
|
||||
USER = gitea
|
||||
PASSWD = sG7hZXBQDAtRab9A
|
||||
SSL_MODE = disable
|
||||
|
||||
[server]
|
||||
DOMAIN = git.aepif.ru
|
||||
HTTP_PORT = 3000
|
||||
ROOT_URL = https://git.aepif.ru/
|
||||
DISABLE_SSH = false
|
||||
SSH_DOMAIN = git.aepif.ru
|
||||
SSH_PORT = 2222
|
||||
START_SSH_SERVER = true
|
||||
SSH_LISTEN_PORT = 22
|
||||
|
||||
[security]
|
||||
INSTALL_LOCK = true
|
||||
SECRET_KEY = your_secret_key_here
|
||||
|
||||
[service]
|
||||
DISABLE_REGISTRATION = true
|
||||
REQUIRE_SIGNIN_VIEW = false
|
||||
ENABLE_NOTIFY_MAIL = false
|
||||
DEFAULT_KEEP_EMAIL_PRIVATE = true
|
||||
|
||||
[mailer]
|
||||
ENABLED = false
|
||||
|
||||
[repository]
|
||||
DEFAULT_BRANCH = main
|
||||
ENABLE_PUSH_CREATE_USER = true
|
||||
ENABLE_PUSH_CREATE_ORG = false
|
||||
|
||||
[webhook]
|
||||
ALLOWED_HOST_LIST = *
|
||||
SKIP_TLS_VERIFY = false
|
||||
```
|
||||
|
||||
## PostgreSQL конфигурация
|
||||
|
||||
### Настройки базы данных
|
||||
*Параметры PostgreSQL для Gitea*
|
||||
### Database Container Settings
|
||||
```yaml
|
||||
db:
|
||||
image: postgres:14
|
||||
container_name: gitea_db
|
||||
environment:
|
||||
- POSTGRES_USER=gitea # Пользователь БД
|
||||
- POSTGRES_PASSWORD=sG7hZXBQDAtRab9A # Пароль БД
|
||||
- POSTGRES_DB=gitea # Имя базы данных
|
||||
```
|
||||
|
||||
## Networking
|
||||
### Дополнительные настройки PostgreSQL
|
||||
```yaml
|
||||
environment:
|
||||
# Performance Settings
|
||||
- POSTGRES_SHARED_PRELOAD_LIBRARIES=pg_stat_statements
|
||||
- POSTGRES_MAX_CONNECTIONS=200
|
||||
- POSTGRES_SHARED_BUFFERS=256MB
|
||||
- POSTGRES_EFFECTIVE_CACHE_SIZE=1GB
|
||||
- POSTGRES_WORK_MEM=4MB
|
||||
|
||||
# Logging Settings
|
||||
- POSTGRES_LOG_STATEMENT=all
|
||||
- POSTGRES_LOG_MIN_DURATION_STATEMENT=1000
|
||||
|
||||
# Backup Settings
|
||||
- POSTGRES_WAL_LEVEL=replica
|
||||
- POSTGRES_ARCHIVE_MODE=on
|
||||
```
|
||||
|
||||
### Сетевые настройки
|
||||
*Конфигурация сетей Docker*
|
||||
### PostgreSQL Volume Configuration
|
||||
```yaml
|
||||
volumes:
|
||||
postgres_data:
|
||||
external: true
|
||||
name: gitea_postgres_data # External volume для персистентности
|
||||
```
|
||||
|
||||
## Volumes и Storage
|
||||
## Traefik Integration Labels
|
||||
|
||||
### Хранение данных
|
||||
*Настройки volumes для персистентности данных*
|
||||
### HTTP Routing
|
||||
```yaml
|
||||
labels:
|
||||
- traefik.enable=true
|
||||
- traefik.http.routers.gitea.rule=Host(`git.aepif.ru`)
|
||||
- traefik.http.routers.gitea.tls.certresolver=letsencrypt
|
||||
- traefik.http.services.gitea.loadbalancer.server.port=3000
|
||||
```
|
||||
|
||||
---
|
||||
*Эта страница находится в разработке*
|
||||
### TCP Routing для SSH
|
||||
```yaml
|
||||
labels:
|
||||
# SSH TCP routing
|
||||
- traefik.tcp.routers.gitea-ssh.rule=HostSNI(`*`)
|
||||
- traefik.tcp.routers.gitea-ssh.entrypoints=ssh
|
||||
- traefik.tcp.services.gitea-ssh.loadbalancer.server.port=22
|
||||
```
|
||||
|
||||
### Объяснение SSH routing
|
||||
- **HostSNI(`*`)**: Принимает любые TCP соединения на SSH entrypoint
|
||||
- **entrypoints=ssh**: Использует SSH entrypoint (порт 2222) в Traefik
|
||||
- **port=22**: Перенаправляет на порт 22 внутри Gitea контейнера
|
||||
|
||||
## Networking Configuration
|
||||
|
||||
### Networks
|
||||
```yaml
|
||||
networks:
|
||||
proxy:
|
||||
external: true # Подключение к Traefik
|
||||
default:
|
||||
driver: bridge # Внутренняя сеть для Gitea + PostgreSQL
|
||||
```
|
||||
|
||||
### Network Architecture
|
||||
- **proxy network**: Для HTTP/HTTPS трафика через Traefik
|
||||
- **default network**: Для внутренней связи Gitea ↔ PostgreSQL
|
||||
- **SSH traffic**: Напрямую через TCP routing Traefik
|
||||
|
||||
## Volume Configuration
|
||||
|
||||
### Gitea Data Volume
|
||||
```yaml
|
||||
gitea_data:
|
||||
external: true
|
||||
name: gitea_gitea_data
|
||||
```
|
||||
|
||||
**Содержимое Gitea volume:**
|
||||
- **repositories/**: Git репозитории
|
||||
- **conf/**: Конфигурационные файлы (app.ini)
|
||||
- **log/**: Логи Gitea
|
||||
- **data/**: Загруженные файлы, аватары
|
||||
- **ssh/**: SSH ключи сервера
|
||||
|
||||
### PostgreSQL Data Volume
|
||||
```yaml
|
||||
postgres_data:
|
||||
external: true
|
||||
name: gitea_postgres_data
|
||||
```
|
||||
|
||||
**Содержимое PostgreSQL volume:**
|
||||
- **base/**: Файлы базы данных
|
||||
- **global/**: Глобальные настройки кластера
|
||||
- **pg_wal/**: Write-Ahead Log файлы
|
||||
- **pg_tblspc/**: Tablespace ссылки
|
||||
|
||||
### Создание external volumes
|
||||
```bash
|
||||
# Создание volumes перед запуском
|
||||
docker volume create gitea_gitea_data
|
||||
docker volume create gitea_postgres_data
|
||||
|
||||
# Проверка созданных volumes
|
||||
docker volume ls | grep gitea
|
||||
```
|
||||
|
||||
## Time Synchronization
|
||||
|
||||
### Timezone Configuration
|
||||
```yaml
|
||||
volumes:
|
||||
- /etc/timezone:/etc/timezone:ro
|
||||
- /etc/localtime:/etc/localtime:ro
|
||||
```
|
||||
|
||||
Это обеспечивает синхронизацию времени контейнера с хост-системой, что важно для:
|
||||
- Корректных timestamp в Git commits
|
||||
- Правильного отображения времени в веб-интерфейсе
|
||||
- Синхронизации с логами других сервисов
|
||||
|
||||
## Security Configuration
|
||||
|
||||
### User Permissions
|
||||
```yaml
|
||||
environment:
|
||||
- USER_UID=1000
|
||||
- USER_GID=1000
|
||||
```
|
||||
|
||||
- Gitea запускается под пользователем с UID/GID 1000
|
||||
- Соответствует обычному пользователю в Linux системах
|
||||
- Обеспечивает правильные права доступа к файлам
|
||||
|
||||
### Database Security
|
||||
- **Пароль БД**: Случайно сгенерированный пароль `sG7hZXBQDAtRab9A`
|
||||
- **Изоляция сети**: PostgreSQL доступна только из внутренней сети
|
||||
- **SSL отключен**: Для внутренней связи в Docker сети
|
||||
|
||||
### SSH Security
|
||||
- **Отдельный порт**: SSH на нестандартном порту 2222
|
||||
- **TCP routing**: Прямое подключение через Traefik
|
||||
- **Key management**: SSH ключи управляются через веб-интерфейс
|
||||
|
||||
## Performance Tuning
|
||||
|
||||
### Gitea Performance Settings
|
||||
```yaml
|
||||
environment:
|
||||
# Repository settings
|
||||
- GITEA__repository__DEFAULT_REPO_UNITS=repo.code,repo.releases,repo.issues,repo.pulls,repo.wiki
|
||||
- GITEA__repository__DEFAULT_PRIVATE=private
|
||||
|
||||
# Git settings
|
||||
- GITEA__git__MAX_GIT_DIFF_LINES=10000
|
||||
- GITEA__git__MAX_GIT_DIFF_LINE_CHARACTERS=5000
|
||||
- GITEA__git__MAX_GIT_DIFF_FILES=100
|
||||
|
||||
# Session settings
|
||||
- GITEA__session__PROVIDER=memory
|
||||
- GITEA__session__PROVIDER_CONFIG=data/sessions
|
||||
```
|
||||
|
||||
### PostgreSQL Performance
|
||||
```yaml
|
||||
environment:
|
||||
# Connection settings
|
||||
- POSTGRES_MAX_CONNECTIONS=200
|
||||
- POSTGRES_SHARED_BUFFERS=256MB
|
||||
- POSTGRES_EFFECTIVE_CACHE_SIZE=1GB
|
||||
- POSTGRES_RANDOM_PAGE_COST=1.1
|
||||
- POSTGRES_WORK_MEM=4MB
|
||||
```
|
||||
|
||||
## Backup Configuration
|
||||
|
||||
### Automated Backups
|
||||
```yaml
|
||||
# Дополнительный контейнер для backup (опционально)
|
||||
backup:
|
||||
image: prodrigestivill/postgres-backup-local
|
||||
environment:
|
||||
- POSTGRES_HOST=db
|
||||
- POSTGRES_DB=gitea
|
||||
- POSTGRES_USER=gitea
|
||||
- POSTGRES_PASSWORD=sG7hZXBQDAtRab9A
|
||||
- BACKUP_KEEP_DAYS=7
|
||||
- BACKUP_KEEP_WEEKS=4
|
||||
- BACKUP_KEEP_MONTHS=6
|
||||
volumes:
|
||||
- ./backups:/backups
|
||||
depends_on:
|
||||
- db
|
||||
```
|
||||
|
||||
### Backup Strategy
|
||||
1. **Database Backup**: Автоматический dump PostgreSQL
|
||||
2. **Repository Backup**: Резервное копирование Git репозиториев
|
||||
3. **Configuration Backup**: Сохранение настроек и конфигурации
|
||||
|
||||
## Monitoring и Logging
|
||||
|
||||
### Log Configuration
|
||||
```yaml
|
||||
environment:
|
||||
- GITEA__log__MODE=file
|
||||
- GITEA__log__LEVEL=Info
|
||||
- GITEA__log__ROOT_PATH=/data/gitea/log
|
||||
```
|
||||
|
||||
### Health Checks
|
||||
```yaml
|
||||
# Дополнительные health checks
|
||||
healthcheck:
|
||||
test: ["CMD", "curl", "-f", "http://localhost:3000/api/healthz"]
|
||||
interval: 30s
|
||||
timeout: 10s
|
||||
retries: 3
|
||||
start_period: 30s
|
||||
```
|
||||
|
||||
## Связанные файлы
|
||||
|
||||
- **[[Развертывание]]** - пошаговая установка и настройка
|
||||
- **[[Администрирование]]** - управление пользователями и репозиториями
|
||||
- **[[../Traefik Reverse Proxy/Конфигурации]]** - настройки интеграции с reverse proxy
|
||||
Reference in New Issue
Block a user