55 Commits

Author SHA1 Message Date
vbevdev 3ed4611e9e Merge branch 'main' into experiment/runner 2026-07-04 19:19:56 +03:00
vbevdev d7e91190cb deleted unused telegram message action 2026-07-04 19:11:53 +03:00
vbevdev 953d677f16 demo workflow deleted 2026-07-04 19:10:51 +03:00
vbevdev ee413eda26 .env.example
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 7s
2026-07-04 19:10:25 +03:00
vbevdev 1aa8bae409 ideas moved to repo wiki 2026-07-04 19:10:12 +03:00
vbevdev 158277f0ff deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 7s
2026-07-04 18:26:24 +03:00
vbevdev 730077376a deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-07-04 17:52:50 +03:00
vbevdev da67941519 deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-07-04 17:51:09 +03:00
vbevdev 264225bb8b deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 5s
2026-07-04 17:37:03 +03:00
vbevdev cebc67e9a4 deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 7s
2026-07-04 17:36:00 +03:00
vbevdev 6bb16b3b1f deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-07-04 17:29:48 +03:00
vbevdev 327f4368c6 deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-07-04 17:28:51 +03:00
vbevdev b5ebd32a0d deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 5s
2026-07-04 17:25:02 +03:00
vbevdev b840b6bbbc deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-07-04 17:21:07 +03:00
vbevdev 9c0cff6a1b deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-07-04 17:20:07 +03:00
vbevdev 7088ab43ad deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-07-04 17:18:58 +03:00
vbevdev c8fc8776fd deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-07-04 17:14:40 +03:00
vbevdev feaf427969 deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 7s
2026-07-04 17:08:41 +03:00
vbevdev 8700d316fa deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 7s
2026-07-04 03:14:25 +03:00
vbevdev fdcd3eac2e deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-07-04 03:12:01 +03:00
vbevdev df4d6e064e deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-07-04 03:10:41 +03:00
vbevdev 557194a01f deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 7s
2026-07-04 03:06:17 +03:00
vbevdev 8b7568c61b deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-07-04 03:04:48 +03:00
vbevdev 18687a2f01 deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-07-04 02:59:01 +03:00
vbevdev 7115cd5d36 deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-07-04 02:46:21 +03:00
vbevdev 52cd7840ef deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-07-04 02:43:27 +03:00
vbevdev 6db07787fa deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 7s
2026-07-04 02:39:03 +03:00
vbevdev 23846918e6 deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-07-04 02:16:55 +03:00
vbevdev af20fc9662 deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 7s
2026-07-04 02:13:34 +03:00
vbevdev 8f48806208 deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 7s
2026-07-04 02:08:19 +03:00
vbevdev 15cafea367 deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-07-04 01:56:26 +03:00
vbevdev 0dd86c53dd deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-07-04 01:44:33 +03:00
vbevdev 457bf8e586 deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-07-04 01:41:14 +03:00
vbevdev 890136634a deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 8s
2026-07-04 01:31:31 +03:00
vbevdev c159c0177f deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 7s
2026-07-04 01:27:59 +03:00
vbevdev d0a4990780 deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-07-04 01:22:01 +03:00
vbevdev 98efc877af deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 7s
2026-07-04 01:20:06 +03:00
vbevdev 95ac23906d deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 7s
2026-07-04 01:07:01 +03:00
vbevdev 29d66974cb deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-07-04 01:01:53 +03:00
vbevdev 10d7773a13 deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 28s
2026-07-04 00:13:40 +03:00
vbevdev 3f9db6cdc1 deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-06-25 02:06:14 +03:00
vbevdev ca2df02029 deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 7s
2026-06-25 02:00:08 +03:00
vbevdev 6d859cf79e deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 7s
2026-06-25 01:08:53 +03:00
vbevdev fbae09ebe1 deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-06-25 00:47:15 +03:00
vbevdev f331f754e1 deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 8s
2026-06-25 00:23:14 +03:00
vbevdev b9a1d5bf7d deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-06-23 01:01:19 +03:00
vbevdev 03e987e73f deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 7s
2026-06-23 01:00:27 +03:00
vbevdev 2a47f28465 deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-06-23 00:57:28 +03:00
vbevdev 6f55ebb99c deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 7s
2026-06-23 00:54:51 +03:00
vbevdev 2bdfa27624 deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-06-23 00:49:27 +03:00
vbevdev ccdac3847f deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 8s
2026-06-23 00:47:49 +03:00
vbevdev 0b1260614e deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 7s
2026-06-23 00:30:32 +03:00
vbevdev 40b621448c deploy-workflow: create docker compose file
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 7s
2026-06-23 00:27:05 +03:00
vbevdev 9572e20a2c deploy workflow: create secrets
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 8s
2026-06-23 00:14:19 +03:00
vbevdev 74b8769195 fix deploy workflow
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 6s
2026-06-16 05:48:14 +03:00
9 changed files with 43 additions and 490 deletions
-1
View File
@@ -1,4 +1,3 @@
BESZEL_HUB_URL=http://mon.localhost BESZEL_HUB_URL=http://mon.localhost
NEXTCLOUD_DOMAIN=cld.localhost NEXTCLOUD_DOMAIN=cld.localhost
GITEA_URL=http://git:3000 GITEA_URL=http://git:3000
RUSTDESK_DOMAIN=sup.local
@@ -0,0 +1,26 @@
name: '🧼 Telegram message escape'
description: 'Automatically escapes dots, dashes, and exclamation marks for Telegram MarkdownV2'
inputs:
message:
description: 'The raw text string to escape'
required: true
outputs:
escaped_message:
description: 'The safely escaped string ready for Telegram'
value: ${{ steps.escape.outputs.result }}
runs:
using: 'composite'
steps:
- id: escape
shell: bash
run: |
RAW_MESSAGE="${{ inputs.message }}"
ESCAPED_MESSAGE=$(echo "$RAW_MESSAGE" | sed "s/-/\\\\-/g" | sed "s/\./\\\\./g" | sed "s/!/\\\\!/g")
echo "result<<EOF" >> $GITHUB_OUTPUT
echo "$ESCAPED_MESSAGE" >> $GITHUB_OUTPUT
echo "EOF" >> $GITHUB_OUTPUT
+9 -20
View File
@@ -23,12 +23,11 @@ jobs:
ssh_host: ${{ secrets.SSH_HOST }} ssh_host: ${{ secrets.SSH_HOST }}
- name: 📦 Create backup of data/ folder - name: 📦 Create backup of data/ folder
if: ${{ vars.DEPLOY_BACKUP_ENABLED == 'true' }}
env: env:
SSHPASS: ${{ secrets.SSH_PASSWORD }} SSHPASS: ${{ secrets.SSH_PASSWORD }}
SSH_USERNAME: ${{ secrets.SSH_USERNAME }} SSH_USERNAME: ${{ secrets.SSH_USERNAME }}
SSH_HOST: ${{ secrets.SSH_HOST }} SSH_HOST: ${{ secrets.SSH_HOST }}
DEPLOY_DIRECTORY: ${{ vars.DEPLOY_DIRECTORY }} DEPLOY_DIRECTORY: ${{ secrets.DEPLOY_DIRECTORY }}
REF_NAME: ${{ env.CLEAN_REF_NAME }} REF_NAME: ${{ env.CLEAN_REF_NAME }}
run: | run: |
sshpass -e ssh -p 22 "$SSH_USERNAME@$SSH_HOST" bash -s << EOT sshpass -e ssh -p 22 "$SSH_USERNAME@$SSH_HOST" bash -s << EOT
@@ -43,13 +42,13 @@ jobs:
echo "Creating backup of data/ into \${BACKUP_FILE}..." echo "Creating backup of data/ into \${BACKUP_FILE}..."
if [ -d "data" ]; then if [ -d "data" ]; then
echo "$SSHPASS" | sudo -S tar -czf "\${BACKUP_FILE}" data tar -czf "\${BACKUP_FILE}" data
echo "✅ Backup created successfully!" echo "✅ Backup created successfully!"
else else
echo "⚡️ No data/ folder, backup creation skipped." echo "⚡️ No data/ folder, backup creation skipped."
fi fi
echo "$SSHPASS" | sudo -S find backups/ -type f -name "backup-*.tar.gz" -mtime +7 -delete find backups/ -type f -name "backup-*.tar.gz" -mtime +7 -delete
EOT EOT
- name: 🏗️ Create docker-compose file - name: 🏗️ Create docker-compose file
@@ -57,7 +56,7 @@ jobs:
SSHPASS: ${{ secrets.SSH_PASSWORD }} SSHPASS: ${{ secrets.SSH_PASSWORD }}
SSH_USERNAME: ${{ secrets.SSH_USERNAME }} SSH_USERNAME: ${{ secrets.SSH_USERNAME }}
SSH_HOST: ${{ secrets.SSH_HOST }} SSH_HOST: ${{ secrets.SSH_HOST }}
DEPLOY_DIRECTORY: ${{ vars.DEPLOY_DIRECTORY }} DEPLOY_DIRECTORY: ${{ secrets.DEPLOY_DIRECTORY }}
REF_NAME: ${{ env.CLEAN_REF_NAME }} REF_NAME: ${{ env.CLEAN_REF_NAME }}
run: | run: |
sshpass -e ssh -p 22 "$SSH_USERNAME@$SSH_HOST" \ sshpass -e ssh -p 22 "$SSH_USERNAME@$SSH_HOST" \
@@ -72,7 +71,7 @@ jobs:
SSHPASS: ${{ secrets.SSH_PASSWORD }} SSHPASS: ${{ secrets.SSH_PASSWORD }}
SSH_USERNAME: ${{ secrets.SSH_USERNAME }} SSH_USERNAME: ${{ secrets.SSH_USERNAME }}
SSH_HOST: ${{ secrets.SSH_HOST }} SSH_HOST: ${{ secrets.SSH_HOST }}
DEPLOY_DIRECTORY: ${{ vars.DEPLOY_DIRECTORY }} DEPLOY_DIRECTORY: ${{ secrets.DEPLOY_DIRECTORY }}
BESZEL_AGENT_KEY: ${{ secrets.BESZEL_AGENT_KEY }} BESZEL_AGENT_KEY: ${{ secrets.BESZEL_AGENT_KEY }}
BESZEL_AGENT_TOKEN: ${{ secrets.BESZEL_AGENT_TOKEN }} BESZEL_AGENT_TOKEN: ${{ secrets.BESZEL_AGENT_TOKEN }}
BESZEL_HUB_URL: ${{ vars.BESZEL_HUB_URL }} BESZEL_HUB_URL: ${{ vars.BESZEL_HUB_URL }}
@@ -80,7 +79,6 @@ jobs:
GITEA_URL: ${{ vars.GIT_URL }} GITEA_URL: ${{ vars.GIT_URL }}
VAULTWARDEN_ADMIN_TOKEN: ${{ secrets.VAULTWARDEN_ADMIN_TOKEN }} VAULTWARDEN_ADMIN_TOKEN: ${{ secrets.VAULTWARDEN_ADMIN_TOKEN }}
NEXTCLOUD_DOMAIN: ${{ vars.NEXTCLOUD_DOMAIN }} NEXTCLOUD_DOMAIN: ${{ vars.NEXTCLOUD_DOMAIN }}
RUSTDESK_DOMAIN: ${{ vars.RUSTDESK_DOMAIN }}
run: | run: |
sshpass -e ssh -p 22 "$SSH_USERNAME@$SSH_HOST" bash -s << EOT sshpass -e ssh -p 22 "$SSH_USERNAME@$SSH_HOST" bash -s << EOT
set -e set -e
@@ -90,7 +88,6 @@ jobs:
BESZEL_HUB_URL=$BESZEL_HUB_URL BESZEL_HUB_URL=$BESZEL_HUB_URL
NEXTCLOUD_DOMAIN=$NEXTCLOUD_DOMAIN NEXTCLOUD_DOMAIN=$NEXTCLOUD_DOMAIN
GITEA_URL=$GITEA_URL GITEA_URL=$GITEA_URL
RUSTDESK_DOMAIN=$RUSTDESK_DOMAIN
EOF_ENV EOF_ENV
mkdir -p secrets mkdir -p secrets
@@ -120,9 +117,7 @@ jobs:
SSHPASS: ${{ secrets.SSH_PASSWORD }} SSHPASS: ${{ secrets.SSH_PASSWORD }}
SSH_USERNAME: ${{ secrets.SSH_USERNAME }} SSH_USERNAME: ${{ secrets.SSH_USERNAME }}
SSH_HOST: ${{ secrets.SSH_HOST }} SSH_HOST: ${{ secrets.SSH_HOST }}
DEPLOY_DIRECTORY: ${{ vars.DEPLOY_DIRECTORY }} DEPLOY_DIRECTORY: ${{ secrets.DEPLOY_DIRECTORY }}
DEPLOY_LOG_FILE: /tmp/deploy-${{ env.CLEAN_REF_NAME }}.log
DRY_RUN_ENABLED: ${{ vars.DEPLOY_DRY_RUN_ENABLED }}
REF_NAME: ${{ env.CLEAN_REF_NAME }} REF_NAME: ${{ env.CLEAN_REF_NAME }}
TELEGRAM_TOKEN: ${{ secrets.TELEGRAM_DEPLOY_BOT_TOKEN }} TELEGRAM_TOKEN: ${{ secrets.TELEGRAM_DEPLOY_BOT_TOKEN }}
TELEGRAM_CHAT: ${{ secrets.TELEGRAM_DEPLOY_CHAT_ID }} TELEGRAM_CHAT: ${{ secrets.TELEGRAM_DEPLOY_CHAT_ID }}
@@ -133,6 +128,7 @@ jobs:
FAILURE_MESSAGE: |- FAILURE_MESSAGE: |-
❌ <b>Ошибка деплоя!</b> ❌ <b>Ошибка деплоя!</b>
Релиз: <code>${{ gitea.ref_name }}</code> Релиз: <code>${{ gitea.ref_name }}</code>
DEPLOY_LOG_FILE: /tmp/deploy-${{ env.CLEAN_REF_NAME }}.log
run: | run: |
sshpass -e ssh -p 22 "$SSH_USERNAME@$SSH_HOST" bash -s << EOT sshpass -e ssh -p 22 "$SSH_USERNAME@$SSH_HOST" bash -s << EOT
set -e set -e
@@ -140,15 +136,8 @@ jobs:
nohup bash -c ' nohup bash -c '
sleep 5 sleep 5
if [ "${DRY_RUN_ENABLED}" = "true" ]; then
DRY_RUN_FLAG="--dry-run"
else
DRY_RUN_FLAG=""
fi
if docker compose \${DRY_RUN_FLAG} -f "docker-compose-${REF_NAME}.yml" pull > ${DEPLOY_LOG_FILE} 2>&1 && \ if docker compose --dry-run -f "docker-compose-${REF_NAME}.yml" up -d --remove-orphans > ${DEPLOY_LOG_FILE} 2>&1; then
docker compose \${DRY_RUN_FLAG} -f "docker-compose-${REF_NAME}.yml" up -d --remove-orphans >> ${DEPLOY_LOG_FILE} 2>&1; then
curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_TOKEN}/sendMessage" \ curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_TOKEN}/sendMessage" \
--proxy "${PROXY_URL}" \ --proxy "${PROXY_URL}" \
-d "chat_id=${TELEGRAM_CHAT}" \ -d "chat_id=${TELEGRAM_CHAT}" \
@@ -169,4 +158,4 @@ jobs:
' > /dev/null 2>&1 & ' > /dev/null 2>&1 &
EOT EOT
echo "New containers will be started after 5 seconds" echo "New containers will be started after 5 seconds"
-83
View File
@@ -1,83 +0,0 @@
# AGENTS.md
Инструкции для AI-агентов и автоматизации, работающих с этим репозиторием.
## Форма проекта
Это Docker Compose инфраструктурный репозиторий. Основные source-файлы:
- `docker-compose.yml`
- `.env.example`
- `.gitignore`
- `.gitea/workflows/*.yaml`
- `.gitea/actions/*`
- `README.md`
- `AGENTS.md`
Текущие service aliases в Compose:
```text
prx
pwd
mon
mon-agent
cld
git
git-runner
sup-hbbs
sup-hbbr
```
Сохраняйте эти короткие aliases, если пользователь явно не попросил переименовать сервисы и не подтвердил учет deploy-impact.
## Секреты и runtime-данные
Не читайте, не выводите, не пересказывайте, не копируйте и не коммитьте реальные секреты или runtime-данные.
Считайте эти пути sensitive или local-only:
- `.env`
- `secrets/`
- `data/`
- database-файлы вроде `*.sqlite3`, `*.sqlite3-shm`, `*.sqlite3-wal`
- private keys и сгенерированные service credentials
- certificates и letsencrypt data
Используйте `.env.example`, `docker-compose.yml` и workflow-файлы как source of truth для имен переменных и секретов. Если задача требует просмотра реальных secret values или runtime-данных, остановитесь и запросите явное разрешение пользователя.
## Правила изменений
- Держите изменения узко привязанными к запрошенному infrastructure-поведению.
- Не выполняйте destructive-операции против `data/`, `secrets/`, Docker volumes или корня проекта без явного разрешения пользователя.
- Не запускайте `docker compose down -v`, volume pruning, recursive deletion, database migrations или service resets, если пользователь не запросил именно это.
- При добавлении или изменении Compose-переменной обновляйте `.env.example`, `README.md` и Gitea deploy workflow, если значение нужно при деплое.
- При добавлении или изменении Compose-секрета обновляйте блок `secrets:`, создание секретов в deploy workflow, `README.md` и соответствующий service environment.
- Сохраняйте стиль YAML: короткие service aliases, single quotes там, где они уже используются, и существующую indentation-схему.
- Избегайте unrelated formatting churn в workflow и Compose-файлах.
## Валидация
Для Compose-изменений запускайте:
```sh
docker compose config
```
Для изменений deploy workflow проверяйте затронутые `.gitea/workflows/*.yaml` и подтверждайте, что нужные variables/secrets описаны в `README.md`.
Для documentation-only изменений проверьте, что:
- service names совпадают с `docker-compose.yml`;
- environment variables совпадают с `.env.example`;
- secret filenames совпадают с Compose-блоком `secrets:`;
- реальные secret values и runtime-данные не попали в документацию.
## Операционный контекст
Деплой запускается вручную через Gitea Actions. Deploy workflow подключается к серверу по SSH, записывает `.env` и `secrets/*.txt`, опционально делает backup удаленного `data/` и стартует контейнеры командой:
```sh
docker compose -f docker-compose-<ref>.yml up -d --remove-orphans
```
Workflow может отправлять Telegram-уведомления и прикладывать deploy logs. Изменения deploy-поведения должны учитывать и remote shell commands, и documented Gitea variables/secrets.
-98
View File
@@ -1,98 +0,0 @@
# Changelog
Все заметные изменения в инфраструктурном репозитории описываются в этом файле.
Формат ведется вручную на русском языке. В changelog попадают изменения, которые влияют на состав сервисов, версии Docker images, деплой, backup/restore, переменные окружения, секреты и эксплуатационные правила.
## Будущие изменения
Пока нет.
## 2026-08-23
### Документация
- Добавлен `CHANGELOG.md` с историей заметных изменений по git history с начала репозитория.
## 2026-08-22
### Изменено
- Зафиксирована версия Vaultwarden: `vaultwarden/server:1.37.1` вместо `vaultwarden/server:latest`.
- Deploy workflow теперь выполняет `docker compose pull` перед `docker compose up -d --remove-orphans`.
- В `README.md` добавлено правило фиксировать версии stateful-сервисов и обновлять их отдельным изменением после просмотра release notes и backup.
### Исправлено
- Восстановлена совместимость Vaultwarden с актуальным расширением Bitwarden для браузера. Старый backend `1.36.0` не загружал хранилище в новом расширении.
### Документация
- Добавлен `README.md` с описанием сервисов, переменных, секретов, локальных операций, данных, деплоя и правил сопровождения.
- Добавлен `AGENTS.md` с инструкциями для AI-агентов и автоматизации в этом репозитории.
## 2026-07-26
### Добавлено
- Добавлены сервисы RustDesk:
- `sup-hbbs` для ID/rendezvous server;
- `sup-hbbr` для relay server.
- Для Nginx Proxy Manager открыты порты RustDesk: `21116/tcp`, `21116/udp`, `21117/tcp`.
- Добавлена переменная `RUSTDESK_DOMAIN` в `.env.example` и deploy workflow.
## 2026-07-06
### Добавлено
- Добавлен healthcheck для `git-runner` через endpoint `http://127.0.0.1:9101/healthz`.
## 2026-07-05
### Изменено
- Backup-шаг deploy workflow стал опциональным через Gitea variable `DEPLOY_BACKUP_ENABLED`.
- Режим dry-run для деплоя вынесен в Gitea variable `DEPLOY_DRY_RUN_ENABLED`.
## 2026-07-04
### Добавлено
- Deploy workflow переведен на полноценный Gitea Actions процесс:
- checkout репозитория;
- нормализация имени ref/branch;
- настройка SSH-клиента;
- создание удаленного `docker-compose-<ref>.yml`;
- создание `.env` и файлов в `secrets/`;
- запуск Compose на сервере;
- Telegram-уведомления и отправка deploy log.
- Добавлен workflow для проверки Telegram deploy bot.
- Добавлен `.env.example` с базовыми переменными окружения.
- Добавлен backup `data/` перед деплоем с хранением архивов в `backups/`.
### Изменено
- `DEPLOY_DIRECTORY` перенесен из secrets в Gitea variables.
- Backup выполняется через `sudo`, чтобы избежать ошибок прав доступа к runtime-данным.
- Исправлена передача пароля в `sudo` при backup.
- Удален временный demo workflow и неиспользуемый action для экранирования Telegram-сообщений.
- Идеи по развитию вынесены из репозитория в wiki.
## 2026-06-16
### Добавлено
- Создан начальный Docker Compose стек:
- `prx` на `jc21/nginx-proxy-manager:2.15.1`;
- `pwd` на `vaultwarden/server:latest`;
- `mon` на `henrygd/beszel`;
- `mon-agent` на `henrygd/beszel-agent`;
- `cld` на `nextcloud:30.0.6`;
- `git` на `docker.gitea.com/gitea:1.26.2`.
- Добавлены bind mounts в `data/` для persistent-данных сервисов.
- Добавлены Docker secrets для Vaultwarden и Beszel.
- Добавлена сеть Compose `vbevdev`.
- Добавлен `.gitignore` для локальных данных, секретов, `.env`, `.vscode` и `.DS_Store`.
- Добавлен сервис `git-runner` на `gitea/act_runner:latest`.
- Добавлен healthcheck для `git` и зависимость `git-runner` от здорового `git`.
- Добавлен черновой deploy workflow для Gitea Actions.
+6
View File
@@ -0,0 +1,6 @@
1. Backup data/ before rerun containers
2. Auto run on new realese
3. Разделение докер сетей
4. Notifications
5. Bot for server operations
6. multi device copy-paste
-159
View File
@@ -1,159 +0,0 @@
# vbevdev
Self-hosted инфраструктурный стек, управляемый через Docker Compose.
Репозиторий содержит Compose-описание сервисов, workflow для деплоя и пример переменных окружения. Runtime-данные и секреты намеренно не хранятся в Git.
## Сервисы
| Сервис | Image | Назначение |
| --- | --- | --- |
| `prx` | `jc21/nginx-proxy-manager:2.15.1` | Nginx Proxy Manager для reverse proxy, HTTP/HTTPS и сертификатов. |
| `pwd` | `vaultwarden/server:1.37.1` | Vaultwarden, менеджер паролей. |
| `mon` | `henrygd/beszel` | Beszel monitoring hub. |
| `mon-agent` | `henrygd/beszel-agent` | Beszel monitoring agent с доступом к Docker socket. |
| `cld` | `nextcloud:30.0.6` | Nextcloud. |
| `git` | `docker.gitea.com/gitea:1.26.2` | Gitea server. |
| `git-runner` | `gitea/act_runner:latest` | Gitea Actions runner. |
| `sup-hbbs` | `rustdesk/rustdesk-server:latest` | RustDesk ID/rendezvous server. |
| `sup-hbbr` | `rustdesk/rustdesk-server:latest` | RustDesk relay server. |
Docker network по умолчанию называется `vbevdev`.
## Конфигурация
Создайте локальный `.env` из `.env.example` и задайте значения для своей среды:
```sh
cp .env.example .env
```
Обязательные переменные:
```sh
BESZEL_HUB_URL=http://mon.localhost
NEXTCLOUD_DOMAIN=cld.localhost
GITEA_URL=http://git:3000
RUSTDESK_DOMAIN=sup.local
```
Перед запуском сервисов, которым нужны секреты, создайте файлы:
```text
secrets/vaultwarden_admin_token.txt
secrets/beszel_agent_key.txt
secrets/beszel_agent_token.txt
secrets/gitea_runner_registration_token.txt
```
Рекомендуемые права:
```sh
chmod 700 secrets
chmod 600 secrets/*.txt
```
Не коммитьте `.env`, `secrets/` и `data/`. В них находятся локальная конфигурация, credentials, базы данных, пользовательские файлы, сгенерированные ключи, сертификаты и другое runtime-состояние.
## Локальные операции
Проверить Compose-файл:
```sh
docker compose config
```
Запустить или обновить стек:
```sh
docker compose up -d
```
Посмотреть состояние и логи:
```sh
docker compose ps
docker compose logs -f <service>
```
Скачать новые images и пересоздать контейнеры:
```sh
docker compose pull
docker compose up -d
```
Для stateful-сервисов с данными в `data/` фиксируйте конкретные версии images вместо `latest`. Обновление версии делайте отдельным изменением после просмотра release notes и backup соответствующей директории в `data/`.
Остановить стек без удаления runtime-данных:
```sh
docker compose down
```
## Данные
Persistent-данные контейнеров монтируются в `./data`:
```text
data/nginx-proxy-manager/
data/vaultwarden/
data/beszel/
data/nextcloud/
data/gitea/
data/rustdesk/
```
Эта директория является runtime-состоянием, а не исходным кодом. Делайте backup перед destructive Docker-командами, изменением volume, миграциями и обновлениями stateful-сервисов.
## Деплой
Деплой описан в `.gitea/workflows/deploy.yaml` и запускается вручную через `workflow_dispatch`.
Workflow деплоя:
1. Забирает репозиторий.
2. Нормализует имя ref/branch для имени удаленного Compose-файла.
3. Настраивает SSH через `.gitea/actions/configure-ssh-client`.
4. Опционально создает архив `data/`, если `DEPLOY_BACKUP_ENABLED` равен `true`.
5. Копирует `docker-compose.yml` на сервер как `docker-compose-<ref>.yml`.
6. Создает на сервере `.env` и `secrets/*.txt` из Gitea variables и secrets.
7. Скачивает images и запускает `docker compose -f docker-compose-<ref>.yml up -d --remove-orphans`.
8. Отправляет Telegram-уведомление об успехе или ошибке и прикладывает deploy log.
Используемые Gitea variables:
```text
DEPLOY_DIRECTORY
DEPLOY_BACKUP_ENABLED
DEPLOY_DRY_RUN_ENABLED
BESZEL_HUB_URL
GIT_URL
NEXTCLOUD_DOMAIN
RUSTDESK_DOMAIN
```
Используемые Gitea secrets:
```text
SSH_HOST
SSH_USERNAME
SSH_PASSWORD
BESZEL_AGENT_KEY
BESZEL_AGENT_TOKEN
RUNNER_REGISTRATION_TOKEN
VAULTWARDEN_ADMIN_TOKEN
TELEGRAM_DEPLOY_BOT_TOKEN
TELEGRAM_DEPLOY_CHAT_ID
PROXY_URL
```
Workflow `.gitea/workflows/test_telegram_deploy_bot.yaml` можно запускать вручную для проверки Telegram-уведомлений через настроенный proxy.
## Сопровождение
- Запускайте `docker compose config` после изменений в `docker-compose.yml`.
- Держите `.env.example` синхронизированным с переменными, которые использует Compose.
- Держите Gitea variables/secrets синхронизированными с `.gitea/workflows/deploy.yaml`.
- Делайте backup `data/` перед обновлениями, сменой images, изменением volumes и миграциями.
- Перед изменением pinned image versions проверяйте release notes stateful-сервисов.
-102
View File
@@ -1,102 +0,0 @@
# Roadmap
Планируемые улучшения инфраструктурного репозитория. Файл фиксирует будущие работы, эксплуатационные риски и технический долг.
`CHANGELOG.md` описывает уже сделанные изменения, а этот файл хранит то, что еще нужно спланировать или выполнить.
## Высокий приоритет
### Обновить Nextcloud с EOL-версии
- Текущая версия: `nextcloud:30.0.6`.
- Риск: ветка Nextcloud 30 достигла EOL и не получает исправления безопасности.
- Что сделать:
- изучить upgrade path и release notes Nextcloud;
- сделать backup `data/nextcloud/`;
- проверить совместимость используемых apps;
- обновляться по поддерживаемому пути между major versions;
- после обновления проверить web UI, `occ status`, фоновые задачи и healthcheck.
### Обновить Gitea из-за security advisory
- Текущая версия: `docker.gitea.com/gitea:1.26.2`.
- Риск: для Gitea `<= 1.26.4` опубликован SSRF advisory, patched version указана как `1.27.0`.
- Что сделать:
- изучить release notes Gitea `1.27.0+`;
- сделать backup `data/gitea/`;
- обновить image version в `docker-compose.yml`;
- проверить web UI, git clone/push, Actions и healthcheck.
### Переделать backup перед деплоем
- Текущее поведение: workflow архивирует весь `data/` в `backups/` на том же диске.
- Риск: backup может падать из-за нехватки места до начала деплоя.
- Что сделать:
- добавить preflight-проверку свободного места;
- чистить старые backups до создания нового архива;
- рассмотреть backup только затронутого service data вместо всего `data/`;
- рассмотреть off-host backup или streaming backup на другую машину;
- документировать ручной backup/restore для отдельных сервисов.
## Средний приоритет
### Закрепить оставшиеся Docker image versions
- Сейчас floating images остаются у:
- `henrygd/beszel`;
- `henrygd/beszel-agent`;
- `gitea/act_runner:latest`;
- `rustdesk/rustdesk-server:latest`.
- Риск: деплой может неожиданно подтянуть несовместимую версию или, наоборот, не обновиться предсказуемо.
- Что сделать:
- подобрать актуальные стабильные версии;
- закрепить tags в `docker-compose.yml`;
- обновить `README.md` и `CHANGELOG.md`;
- для stateful-сервисов делать отдельные коммиты и backup перед деплоем.
### Пересмотреть безопасность Gitea Actions runner
- Текущее поведение: `git-runner` имеет доступ к `/var/run/docker.sock`.
- Риск: доступ к Docker socket фактически дает workflow root-equivalent доступ к хосту.
- Что сделать:
- явно определить trust boundary для Actions;
- ограничить запуск workflow только доверенными репозиториями/пользователями;
- рассмотреть отдельный runner host или VM;
- рассмотреть rootless/isolated runner setup, если это совместимо с нужными jobs.
### Уйти от password-based SSH deploy
- Текущее поведение: workflow использует `sshpass` и `sudo -S`.
- Риск: парольный deploy хуже аудируется и более хрупкий, чем key-based доступ с ограниченными правами.
- Что сделать:
- завести отдельного deploy user;
- перейти на SSH key;
- ограничить sudoers только нужными командами;
- убрать передачу sudo password из workflow.
## Низкий приоритет
### Добавить healthcheck для сервисов без проверки готовности
- Кандидаты:
- `pwd`;
- `sup-hbbs`;
- `sup-hbbr`.
- Цель: после деплоя видеть, что сервис не просто запущен, а реально отвечает.
### Почистить test Telegram workflow
- В `test_telegram_deploy_bot.yaml` есть неиспользуемая переменная `MESSAGE`, которая ссылается на несуществующий `steps.prepare_message`.
- Риск низкий: workflow сейчас не использует эту переменную, но она путает чтение и сопровождение.
### Разобраться с использованием диска
- После неудачной попытки backup занятое место на диске выросло.
- Первичные наблюдения:
- `backups/` не содержит крупного архива;
- `lsof +L1` не показал большого удаленного файла;
- Docker images занимают заметный объем, но не должны были измениться, если workflow упал до Docker-шагов.
- Что сделать:
- найти крупные каталоги через `du -xhd 1`;
- проверить `/var`, `/tmp`, Docker storage и filesystem reserve;
- только после диагностики решать, что можно чистить.
+2 -27
View File
@@ -7,9 +7,6 @@ services:
ports: ports:
- '80:80' - '80:80'
- '443:443' - '443:443'
- '21116:21116/tcp'
- '21116:21116/udp'
- '21117:21117/tcp'
volumes: volumes:
- ./data/nginx-proxy-manager/data:/data - ./data/nginx-proxy-manager/data:/data
- ./data/nginx-proxy-manager/letsencrypt:/etc/letsencrypt - ./data/nginx-proxy-manager/letsencrypt:/etc/letsencrypt
@@ -19,7 +16,7 @@ services:
timeout: 3s timeout: 3s
pwd: pwd:
image: 'vaultwarden/server:1.37.1' image: 'vaultwarden/server:latest'
restart: unless-stopped restart: unless-stopped
volumes: volumes:
- ./data/vaultwarden:/data - ./data/vaultwarden:/data
@@ -102,28 +99,6 @@ services:
- /var/run/docker.sock:/var/run/docker.sock - /var/run/docker.sock:/var/run/docker.sock
secrets: secrets:
- gitea_runner_registration_token - gitea_runner_registration_token
healthcheck:
test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://127.0.0.1:9101/healthz"]
interval: 30s
timeout: 5s
retries: 3
start_period: 10s
sup-hbbs:
image: rustdesk/rustdesk-server:latest
command: hbbs -r ${RUSTDESK_DOMAIN}:21117 -k _
restart: unless-stopped
volumes:
- ./data/rustdesk:/root
depends_on:
- sup-hbbr
sup-hbbr:
image: rustdesk/rustdesk-server:latest
command: hbbr
restart: unless-stopped
volumes:
- ./data/rustdesk:/root
networks: networks:
default: default:
@@ -138,4 +113,4 @@ secrets:
file: secrets/beszel_agent_token.txt file: secrets/beszel_agent_token.txt
gitea_runner_registration_token: gitea_runner_registration_token:
file: secrets/gitea_runner_registration_token.txt file: secrets/gitea_runner_registration_token.txt