vault backup: 2025-08-04 14:26:29

Мой сервер/Git Service/Администрирование.md

@@ -0,0 +1,60 @@
+# Git Service - Администрирование
+
+## Ежедневное администрирование
+
+Этот документ содержит информацию по управлению и обслуживанию Git Service.
+
+## Управление пользователями
+
+### Создание пользователей
+*Процедуры добавления новых пользователей*
+
+### Управление правами доступа
+*Настройка прав и ролей*
+
+### Сброс паролей
+*Процедуры восстановления доступа*
+
+## Управление репозиториями
+
+### Создание репозиториев
+*Настройка новых репозиториев*
+
+### Backup репозиториев
+*Процедуры резервного копирования*
+
+### Миграция репозиториев
+*Перенос репозиториев*
+
+## Мониторинг
+
+### Проверка состояния сервиса
+*Health checks и мониторинг*
+
+### Анализ логов
+*Работа с логами Gitea и PostgreSQL*
+
+### Метрики производительности
+*Мониторинг ресурсов*
+
+## Обслуживание
+
+### Обновления
+*Процедуры обновления Gitea*
+
+### Backup и восстановление
+*Полное резервное копирование*
+
+### Troubleshooting
+*Решение типовых проблем*
+
+## Интеграции
+
+### Настройка Webhooks
+*Конфигурация уведомлений*
+
+### Интеграция с CI/CD
+*Подключение систем автоматизации*
+
+---
+*Эта страница находится в разработке*

Мой сервер/Git Service/Конфигурации.md

@@ -0,0 +1,37 @@
+# Git Service - Конфигурации
+
+## Обзор конфигураций
+
+Этот документ содержит детальную информацию о настройках всех компонентов Git Service.
+
+## Docker Compose конфигурация
+
+### Основной файл: `/DOCKER/git/docker-compose.yml`
+
+*Документация будет дополнена с деталями конфигурации*
+
+## Gitea конфигурация
+
+### Переменные окружения
+*Настройки Gitea через environment variables*
+
+### Базовые настройки
+*Конфигурация через app.ini*
+
+## PostgreSQL конфигурация
+
+### Настройки базы данных
+*Параметры PostgreSQL для Gitea*
+
+## Networking
+
+### Сетевые настройки
+*Конфигурация сетей Docker*
+
+## Volumes и Storage
+
+### Хранение данных
+*Настройки volumes для персистентности данных*
+
+---
+*Эта страница находится в разработке*

Мой сервер/Git Service/Обзор системы.md

@@ -0,0 +1,204 @@
+## Описание
+
+Git Service - отдельный сервис на базе Gitea, обеспечивающий централизованное хранение кода и заметок. Работает независимо от других сервисов и предоставляет Git-интерфейс для всех проектов в экосистеме aepif.ru.
+
+## Архитектура системы
+
+```mermaid
+graph TB
+    A[Users] --> B[Traefik Proxy]
+    B --> C[Gitea Web Interface]
+    C --> D[Git Repositories]
+    C --> E[PostgreSQL Database]
+    F[SSH Clients] --> G[Gitea SSH:2222]
+    G --> D
+    
+    subgraph "Git Service Container"
+        C
+        D
+    end
+    
+    subgraph "Database Container"
+        E
+    end
+    
+    H[Webhook Consumers] --> C
+    C --> I[Webhook Notifications]
+```
+
+## Основные компоненты
+
+### Gitea Server
+- **Назначение**: Web-интерфейс для управления Git-репозиториями
+- **Домен**: `git.aepif.ru`
+- **Технология**: Gitea (Go-based Git service)
+- **Особенности**:
+  - Web-интерфейс для просмотра кода
+  - Issue tracking
+  - Pull/Merge requests
+  - Webhook notifications
+  - User management
+
+### PostgreSQL Database
+- **Назначение**: Хранение метаданных Gitea
+- **Технология**: PostgreSQL 14
+- **Данные**:
+  - Информация о пользователях
+  - Метаданные репозиториев
+  - Issues и комментарии
+  - Настройки системы
+
+### SSH Access
+- **Порт**: 2222 (внешний доступ)
+- **Назначение**: Git operations через SSH
+- **Особенности**: Отдельный порт для избежания конфликтов
+
+## Конфигурация
+
+### Docker Compose
+```yaml
+services:
+  gitea:
+    image: gitea/gitea:latest
+    environment:
+      - GITEA__database__DB_TYPE=postgres
+      - GITEA__database__HOST=db:5432
+      - GITEA__server__SSH_DOMAIN=git.aepif.ru
+      - GITEA__server__SSH_PORT=2222
+    networks:
+      - proxy  # Подключение к Traefik
+      - default
+```
+
+### Traefik Labels
+- **HTTP routing**: `git.aepif.ru` → port 3000
+- **TCP routing**: SSH на порту 2222
+- **SSL**: Автоматические сертификаты
+
+## Репозитории
+
+### Активные репозитории
+- **second-mind-aep**: Заметки для Second Mind
+- **configs**: Конфигурационные файлы сервера
+- **scripts**: Вспомогательные скрипты
+
+### Структура URL
+- **HTTP Clone**: `https://git.aepif.ru/username/repo.git`
+- **SSH Clone**: `git@git.aepif.ru:username/repo.git`
+- **Internal URL**: `http://gitea:3000/username/repo.git`
+
+## Интеграции
+
+### Webhook Integration
+- **Second Mind**: автоматическая пересборка при push
+- **CI/CD**: потенциальная интеграция с системами автоматизации
+- **Notifications**: уведомления в внешние системы
+
+### Authentication
+- **Bypass Authelia**: Собственная система аутентификации Gitea
+- **Local Users**: Управление пользователями внутри Gitea
+- **SSH Keys**: Управление SSH ключами для каждого пользователя
+
+## Домены и доступ
+
+| Протокол | Endpoint | Описание | Порт |
+|----------|----------|----------|------|
+| HTTPS | `git.aepif.ru` | Web-интерфейс Gitea | 443 |
+| SSH | `git.aepif.ru:2222` | Git SSH operations | 2222 |
+| HTTP | `gitea:3000` | Internal container access | 3000 |
+
+## Workflow использования
+
+### Веб-интерфейс
+1. **Доступ** через `git.aepif.ru`
+2. **Аутентификация** с помощью логина/пароля Gitea
+3. **Управление** репозиториями через Web UI
+4. **Настройка** webhooks для автоматизации
+
+### Git Operations
+```bash
+# SSH клонирование
+git clone git@git.aepif.ru:2222/username/repo.git
+
+# HTTPS клонирование  
+git clone https://git.aepif.ru/username/repo.git
+
+# Push изменений
+git push origin main
+```
+
+## Структура файлов
+
+```
+/DOCKER/git/
+├── docker-compose.yml    # Конфигурация Gitea + PostgreSQL
+└── volumes/
+    ├── gitea_data/      # Данные Gitea (repos, config)
+    └── postgres_data/   # База данных PostgreSQL
+```
+
+## Безопасность
+
+### Уровни защиты
+- **SSL/TLS**: Все HTTPS соединения зашифрованы
+- **SSH Keys**: Аутентификация по ключам для Git operations
+- **User Management**: Контроль доступа на уровне пользователей
+- **Repository Permissions**: Детальные права доступа к репозиториям
+
+### Backup Strategy
+- **Database**: Регулярные дампы PostgreSQL
+- **Repositories**: Backup директории `gitea_data`
+- **External Mirrors**: Синхронизация с внешними Git-сервисами
+
+## Мониторинг
+
+### Доступные метрики
+- **Repository Usage**: Размер и активность репозиториев
+- **User Activity**: Статистика commits, pushes, pulls
+- **System Health**: Состояние базы данных и сервиса
+
+### Health Checks
+```bash
+# Проверка веб-интерфейса
+curl -I https://git.aepif.ru
+
+# Проверка SSH доступа
+ssh -T git@git.aepif.ru -p 2222
+
+# Проверка контейнеров
+docker ps | grep gitea
+```
+
+## Администрирование
+
+### Создание пользователей
+1. Доступ к админ-панели Gitea
+2. User Management → Create User
+3. Настройка прав доступа
+
+### Настройка репозиториев
+1. Создание репозитория через Web UI
+2. Настройка webhooks для интеграций
+3. Управление коллаборацией
+
+### Обновления
+```bash
+# Обновление образа
+docker-compose pull
+docker-compose up -d
+
+# Проверка версии
+docker exec gitea gitea --version
+```
+
+## Связанные сервисы
+
+- **[[Мой сервер/Second Mind Setup/Обзор системы|Second Mind]]** - использует Git Service для хранения заметок
+- **[[Мой сервер/Инфраструктура/Обзор системы|Traefik]]** - обеспечивает маршрутизацию и SSL
+- **Potential CI/CD** - будущие интеграции с системами автоматизации
+
+## Связанные документы
+
+- **[[Git Service - Конфигурации]]** - детальные настройки
+- **[[Git Service - Развертывание]]** - пошаговая установка  
+- **[[Git Service - Администрирование]]** - управление и обслуживание

Мой сервер/Git Service/Развертывание.md

@@ -0,0 +1,46 @@
+# Git Service - Развертывание
+
+## Пошаговая установка
+
+Этот документ содержит инструкции по развертыванию Git Service с нуля.
+
+## Предварительные требования
+
+### Системные требования
+*Минимальные требования к серверу*
+
+### Зависимости
+*Необходимое ПО и сервисы*
+
+## Установка
+
+### Шаг 1: Подготовка среды
+*Подготовка окружения для развертывания*
+
+### Шаг 2: Конфигурация
+*Настройка файлов конфигурации*
+
+### Шаг 3: Развертывание контейнеров
+*Запуск Docker Compose*
+
+### Шаг 4: Первоначальная настройка
+*Настройка Gitea через веб-интерфейс*
+
+## Интеграция с инфраструктурой
+
+### Подключение к Traefik
+*Настройка reverse proxy*
+
+### Настройка SSL
+*Конфигурация сертификатов*
+
+## Тестирование
+
+### Проверка доступности
+*Тесты работоспособности сервиса*
+
+### Создание тестового репозитория
+*Валидация функциональности*
+
+---
+*Эта страница находится в разработке*