vault backup: 2025-08-04 12:34:05
This commit is contained in:
Andrey Epifancev
342
Second Mind Setup/Развертывание.md
Normal file
342
Second Mind Setup/Развертывание.md
Normal file
@@ -0,0 +1,342 @@
|
||||
## Предварительные требования
|
||||
|
||||
### Системные требования
|
||||
- Ubuntu/Debian сервер с Docker и Docker Compose
|
||||
- Доступ к интернету для скачивания образов
|
||||
- Настроенный Traefik с сетью `proxy`
|
||||
- Домен с настроенными DNS записями
|
||||
|
||||
### Необходимые поддомены
|
||||
- `git.aepif.ru` → IP сервера
|
||||
- `notes.aepif.ru` → IP сервера
|
||||
- `webhook.aepif.ru` → IP сервера
|
||||
|
||||
## Пошаговая установка
|
||||
|
||||
### 1. Подготовка директорий
|
||||
|
||||
```bash
|
||||
# Создание основной директории проекта
|
||||
mkdir -p /DOCKER/second-mind
|
||||
cd /DOCKER/second-mind
|
||||
|
||||
# Создание рабочих папок
|
||||
mkdir -p webhook-server obsidian_repo quartz_build
|
||||
|
||||
# Установка прав доступа
|
||||
chmod 755 obsidian_repo quartz_build
|
||||
```
|
||||
|
||||
### 2. Настройка SSH ключей
|
||||
|
||||
```bash
|
||||
# Генерация SSH ключа для webhook сервиса
|
||||
ssh-keygen -t ed25519 -C "second-mind-webhook" -f ~/.ssh/id_ed25519
|
||||
|
||||
# Просмотр публичного ключа (для добавления в Gitea позже)
|
||||
cat ~/.ssh/id_ed25519.pub
|
||||
|
||||
# Настройка SSH конфигурации
|
||||
cat >> ~/.ssh/config << EOF
|
||||
Host git.aepif.ru
|
||||
Port 2222
|
||||
User git
|
||||
IdentityFile ~/.ssh/id_ed25519
|
||||
StrictHostKeyChecking no
|
||||
EOF
|
||||
|
||||
# Установка правильных прав
|
||||
chmod 600 ~/.ssh/id_ed25519
|
||||
chmod 644 ~/.ssh/id_ed25519.pub
|
||||
chmod 600 ~/.ssh/config
|
||||
```
|
||||
|
||||
### 3. Создание конфигурационных файлов
|
||||
|
||||
#### Создание .env файла
|
||||
|
||||
```bash
|
||||
cat > .env << 'EOF'
|
||||
DOMAIN=aepif.ru
|
||||
GITEA_ADMIN_USER=admin
|
||||
GITEA_ADMIN_PASSWORD=Creonila1
|
||||
GITEA_DB_PASSWORD=sG7hZXBQDAtRab9A
|
||||
GITEA_SECRET=okPnnPYzdKkkpO6oS8LqI5PHm7fH/OCl
|
||||
WEBHOOK_SECRET=MHtue5Zclp/dr69OFdwquGzCVHUGiEHP
|
||||
REPO_NAME=second-mind-aep
|
||||
EOF
|
||||
```
|
||||
|
||||
#### Создание Dockerfile
|
||||
|
||||
```bash
|
||||
cat > Dockerfile << 'EOF'
|
||||
FROM node:22
|
||||
WORKDIR /app
|
||||
|
||||
# Установка Git и SSH клиента
|
||||
RUN apt-get update && apt-get install -y git openssh-client && rm -rf /var/lib/apt/lists/*
|
||||
|
||||
# Создание .ssh директории и настройка SSH
|
||||
RUN mkdir -p /root/.ssh && chmod 700 /root/.ssh
|
||||
|
||||
# Настройка SSH для автоматического принятия ключей хоста
|
||||
RUN echo "Host git.aepif.ru\n\tStrictHostKeyChecking no\n\tUserKnownHostsFile=/dev/null" > /root/.ssh/config
|
||||
|
||||
# Клонирование кастомного Quartz репозитория
|
||||
RUN git clone ssh://git@git.aepif.ru:2222/aep/quartz.git /quartz
|
||||
WORKDIR /quartz
|
||||
RUN npm install
|
||||
|
||||
# Копирование и настройка webhook сервиса
|
||||
COPY webhook-server/ /webhook/
|
||||
WORKDIR /webhook
|
||||
RUN npm install
|
||||
|
||||
EXPOSE 3000
|
||||
WORKDIR /webhook
|
||||
CMD ["node", "server.js"]
|
||||
EOF
|
||||
```
|
||||
|
||||
#### Создание nginx.conf
|
||||
|
||||
```bash
|
||||
cat > nginx.conf << 'EOF'
|
||||
events {
|
||||
worker_connections 1024;
|
||||
}
|
||||
|
||||
http {
|
||||
include /etc/nginx/mime.types;
|
||||
default_type application/octet-stream;
|
||||
sendfile on;
|
||||
keepalive_timeout 65;
|
||||
gzip on;
|
||||
|
||||
server {
|
||||
listen 80;
|
||||
root /usr/share/nginx/html;
|
||||
index index.html;
|
||||
|
||||
location / {
|
||||
try_files $uri $uri/ $uri.html =404;
|
||||
}
|
||||
|
||||
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2)$ {
|
||||
expires 1y;
|
||||
add_header Cache-Control "public, immutable";
|
||||
}
|
||||
}
|
||||
}
|
||||
EOF
|
||||
```
|
||||
|
||||
#### Создание docker-compose.yml
|
||||
|
||||
```bash
|
||||
# Скопировать содержимое из документа "Second Mind - Конфигурации"
|
||||
# Файл слишком большой для вставки здесь
|
||||
```
|
||||
|
||||
### 4. Настройка webhook сервиса
|
||||
|
||||
#### Создание package.json
|
||||
|
||||
```bash
|
||||
cat > webhook-server/package.json << 'EOF'
|
||||
{
|
||||
"name": "quartz-webhook",
|
||||
"version": "1.0.0",
|
||||
"main": "server.js",
|
||||
"dependencies": {
|
||||
"express": "^4.18.0"
|
||||
}
|
||||
}
|
||||
EOF
|
||||
```
|
||||
|
||||
#### Копирование server.js
|
||||
|
||||
```bash
|
||||
# Скопировать готовый server.js в webhook-server/server.js
|
||||
# (используйте существующий файл)
|
||||
```
|
||||
|
||||
### 5. Первый запуск
|
||||
|
||||
```bash
|
||||
# Сборка и запуск всех сервисов
|
||||
docker-compose up -d
|
||||
|
||||
# Проверка статуса
|
||||
docker-compose ps
|
||||
|
||||
# Просмотр логов
|
||||
docker-compose logs -f
|
||||
```
|
||||
|
||||
### 6. Настройка Gitea
|
||||
|
||||
#### Первоначальная настройка
|
||||
|
||||
1. Открыть `https://git.aepif.ru`
|
||||
2. Пройти первоначальную настройку:
|
||||
- Database Type: PostgreSQL
|
||||
- Host: `db:5432`
|
||||
- Database Name: `gitea`
|
||||
- Username: `gitea`
|
||||
- Password: `sG7hZXBQDAtRab9A`
|
||||
- SSH Server Domain: `git.aepif.ru`
|
||||
- SSH Port: `2222`
|
||||
- HTTP Port: `3000`
|
||||
- Application URL: `https://git.aepif.ru/`
|
||||
|
||||
#### Добавление SSH ключа
|
||||
|
||||
1. Войти под админом (`admin` / `Creonila1`)
|
||||
2. Settings → SSH / GPG Keys
|
||||
3. Add Key → вставить содержимое `~/.ssh/id_ed25519.pub`
|
||||
4. Сохранить
|
||||
|
||||
#### Создание репозитория заметок
|
||||
|
||||
1. New Repository
|
||||
2. Repository Name: `second-mind-aep`
|
||||
3. Visibility: Private
|
||||
4. Initialize Repository: Yes
|
||||
5. Create Repository
|
||||
|
||||
#### Создание репозитория Quartz
|
||||
|
||||
1. New Repository
|
||||
2. Repository Name: `quartz`
|
||||
3. Visibility: Private
|
||||
4. **НЕ** инициализировать (будем форкать)
|
||||
|
||||
### 7. Форк и настройка Quartz
|
||||
|
||||
```bash
|
||||
# Клонирование оригинального Quartz
|
||||
git clone https://github.com/jackyzha0/quartz.git temp-quartz
|
||||
cd temp-quartz
|
||||
|
||||
# Изменение remote на наш Gitea
|
||||
git remote set-url origin ssh://git@git.aepif.ru:2222/aep/quartz.git
|
||||
|
||||
# Push в наш репозиторий
|
||||
git push -u origin main
|
||||
|
||||
# Удаление временной папки
|
||||
cd ..
|
||||
rm -rf temp-quartz
|
||||
```
|
||||
|
||||
### 8. Настройка webhook'а
|
||||
|
||||
1. В Gitea перейти в репозиторий `second-mind-aep`
|
||||
2. Settings → Webhooks → Add Webhook → Gitea
|
||||
3. Настройки:
|
||||
- Target URL: `https://webhook.aepif.ru/webhook`
|
||||
- HTTP Method: `POST`
|
||||
- POST Content Type: `application/json`
|
||||
- Secret: `MHtue5Zclp/dr69OFdwquGzCVHUGiEHP`
|
||||
- Trigger On: `Push events`
|
||||
- Active: ✓
|
||||
4. Add Webhook
|
||||
|
||||
### 9. Первый тест
|
||||
|
||||
#### Создание тестовой заметки
|
||||
|
||||
```bash
|
||||
# Клонирование репозитория заметок
|
||||
git clone ssh://git@git.aepif.ru:2222/admin/second-mind-aep.git test-notes
|
||||
cd test-notes
|
||||
|
||||
# Создание тестовой заметки
|
||||
cat > README.md << 'EOF'
|
||||
---
|
||||
title: "Добро пожаловать"
|
||||
---
|
||||
|
||||
# AEP Second Mind
|
||||
|
||||
Это главная страница базы знаний.
|
||||
|
||||
## Тестовая заметка
|
||||
|
||||
Проверка автоматической сборки.
|
||||
EOF
|
||||
|
||||
# Commit и push
|
||||
git add .
|
||||
git commit -m "Initial test note"
|
||||
git push origin main
|
||||
```
|
||||
|
||||
#### Проверка работы
|
||||
|
||||
1. Проверить логи webhook сервиса:
|
||||
```bash
|
||||
docker-compose logs -f quartz-webhook
|
||||
```
|
||||
|
||||
2. Проверить появление файлов:
|
||||
```bash
|
||||
ls -la quartz_build/
|
||||
```
|
||||
|
||||
3. Открыть `https://notes.aepif.ru` и проверить сайт
|
||||
|
||||
## Возможные проблемы и решения
|
||||
|
||||
### SSH ключи не работают
|
||||
|
||||
```bash
|
||||
# Проверка SSH подключения
|
||||
ssh -p 2222 git@git.aepif.ru
|
||||
|
||||
# Если не работает, пересоздать ключи
|
||||
rm ~/.ssh/id_ed25519*
|
||||
ssh-keygen -t ed25519 -C "webhook" -f ~/.ssh/id_ed25519
|
||||
# Добавить новый публичный ключ в Gitea
|
||||
```
|
||||
|
||||
### Контейнер webhook не запускается
|
||||
|
||||
```bash
|
||||
# Проверить логи сборки
|
||||
docker-compose build quartz-webhook
|
||||
|
||||
# Проверить что SSH ключи примонтированы
|
||||
docker exec -it second_mind_webhook ls -la /root/.ssh/
|
||||
```
|
||||
|
||||
### Webhook не срабатывает
|
||||
|
||||
1. Проверить URL webhook'а в настройках Gitea
|
||||
2. Проверить секретный токен
|
||||
3. Посмотреть логи delivery в Gitea: Repository → Settings → Webhooks → Recent Deliveries
|
||||
|
||||
### 404 на главной странице
|
||||
|
||||
```bash
|
||||
# Проверить наличие index.html
|
||||
docker exec -it second_mind_nginx ls -la /usr/share/nginx/html/
|
||||
|
||||
# Если нет - создать index.md в репозитории
|
||||
# или проверить работу webhook'а
|
||||
```
|
||||
|
||||
## Завершение установки
|
||||
|
||||
После успешного развертывания у вас будет:
|
||||
|
||||
- ✅ Gitea сервер на `git.aepif.ru`
|
||||
- ✅ Защищенный сайт заметок на `notes.aepif.ru`
|
||||
- ✅ Автоматическая пересборка при каждом push'е
|
||||
- ✅ Полнотекстовый поиск и граф связей
|
||||
- ✅ SSL сертификаты для всех доменов
|
||||
|
||||
Следующий документ: [[Администрирование]]
|
||||
Reference in New Issue
Block a user