refactor: split machine deploys from one-time secrets migration
Roles stay under the machine that runs them, CI applies only a known product, and the /opt/secrets move is a one-shot playbook instead of part of every core-secrets run. Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
1 parent
341538fba9
commit
9c692522fb
85 files changed
+537
-492
No files matched your search
+29
-17
@@ -1,6 +1,16 @@
|
||||
# Инструкция по развертыванию инфраструктуры (Bootstrap Guide)
|
||||
|
||||
Документ описывает контур, который поднимает этот репозиторий, порядок холодного старта и секреты в Infisical. Gitea в автоматизацию не входит: без неё не запустить пайплайны.
|
||||
Плейбук называется машиной. В `roles/<машина>/` лежат продукты этой машины: один каталог, один Compose, один путь `/opt/<продукт>`. База и кэш остаются внутри Compose этого продукта. Роль `host` стоит отдельно: она готовит любую машину и ни одному продукту не принадлежит.
|
||||
|
||||
Пайплайн подключается к машине, а применяет только роли, чьи файлы изменились (`--tags`). Роль `host` ставит пакеты, Docker и SSH. Она выполняется вместе со всеми продуктами машины, когда меняются плейбук, инвентарь или сама роль `host`, и при ручном запуске.
|
||||
|
||||
| Машина | Плейбук | Роли | Каталоги |
|
||||
|---|---|---|---|
|
||||
| `core-net` | `playbooks/core-net.yml` | `roles/core-net/traefik`, `roles/core-net/authentik` | `/opt/traefik`, `/opt/authentik` |
|
||||
| `core-secrets` | `playbooks/core-secrets.yml` | `roles/core-secrets/infisical`, `roles/core-secrets/vaultwarden` | `/opt/infisical`, `/opt/vaultwarden` |
|
||||
| `rus-central` | `playbooks/rus-central.yml` | `roles/rus-central/netbird` | `/opt/netbird` |
|
||||
|
||||
Полная сверка одной машины: `ansible-playbook playbooks/site.yml --limit <машина>`. Gitea в автоматизацию не входит: без неё не запустить пайплайны.
|
||||
|
||||
---
|
||||
|
||||
@@ -13,8 +23,10 @@
|
||||
| **pve** | `192.168.1.2:8006` | PVE Main Node / Services | `root@192.168.1.2` (LAN only) |
|
||||
| **opnsense** | `192.168.1.1` | Маршрутизатор / Шлюз | Шлюз по умолчанию |
|
||||
|
||||
Terraform в этом репозитории описывает только узел `netcore`. Узел `pve` и CT 109 поднимаются отдельно.
|
||||
|
||||
### 1.2. Базовые управляющие контейнеры (LXC / Debian 13)
|
||||
| CT ID | Хост PVE | IP | Имя хоста | Сервисы |
|
||||
| CT ID | Хост PVE | IP | Имя хоста | Продукты |
|
||||
|---|---|---|---|---|
|
||||
| **CT 109** | `pve` | `192.168.1.217` | `gitea` | Gitea (`:3000`), Postgres (`:5432`), Gitea Actions Runner (`dind`) |
|
||||
| **CT 901** | `netcore` | `192.168.1.102` | `core-secrets` | Infisical (`:8080`), Postgres, Redis, Vaultwarden (`:8000`) |
|
||||
@@ -23,7 +35,9 @@
|
||||
### 1.3. Внешние узлы
|
||||
| Имя | IP | Роль | Стек |
|
||||
|---|---|---|---|
|
||||
| **rus-central** | `45.154.185.208` | Внешний шлюз NetBird | Docker Compose: NetBird Management, Signal, Dashboard, Coturn |
|
||||
| **rus-central** | `45.154.185.208` | Внешний шлюз NetBird | `/opt/netbird`: NetBird и его собственный Traefik |
|
||||
|
||||
Домен панели NetBird задаётся в `ansible/inventories/prod/host_vars/rus-central.yml`.
|
||||
|
||||
---
|
||||
|
||||
@@ -45,19 +59,16 @@ API Endpoint (внутренний LAN): `http://192.168.1.102:8080/api`
|
||||
- `AUTHENTIK_SECRET_KEY`: случайный ключ шифрования сессий Authentik.
|
||||
- `AUTHENTIK_POSTGRES_PASSWORD`: пароль БД PostgreSQL Authentik.
|
||||
- `/services/netbird`:
|
||||
- `COMPOSE_PROJECT_NAME`: имя docker compose проекта (`netbird`).
|
||||
- `NETBIRD_DOMAIN`: домен панели NetBird.
|
||||
- `NETBIRD_LETSENCRYPT_EMAIL`: email для SSL-сертификатов.
|
||||
- `NETBIRD_LETSENCRYPT_EMAIL`: почта для сертификата. Если секрета нет, берётся `letsencrypt_email` из `group_vars/all.yml`.
|
||||
- `NETBIRD_AUTH_SECRET`: секрет auth.
|
||||
- `NETBIRD_DATASTORE_KEY`: 32-байтный ключ SQLite/datastore.
|
||||
- `NETBIRD_SESSION_KEY`: 32-байтный ключ веб-сессий.
|
||||
- `/proxmox/netcore`:
|
||||
- `PROXMOX_ENDPOINT`: `https://192.168.1.100:8006/api2/json`
|
||||
- `PROXMOX_API_TOKEN`: токен `root@pam!terraform=UUID`
|
||||
- `/proxmox/pve`:
|
||||
- `PROXMOX_ENDPOINT`: `https://192.168.1.2:8006/api2/json`
|
||||
- `PROXMOX_ENDPOINT`: `https://192.168.1.100:8006/`
|
||||
- `PROXMOX_API_TOKEN`: токен `root@pam!terraform=UUID`
|
||||
|
||||
Провайдер Proxmox сам дописывает `/api2/json`. В секрет его класть не нужно. Секреты `/proxmox/pve` этот репозиторий не читает: Terraform описывает только узел `netcore`.
|
||||
|
||||
---
|
||||
|
||||
## 3. Последовательность холодного старта (Cold Bootstrap)
|
||||
@@ -80,22 +91,23 @@ API Endpoint (внутренний LAN): `http://192.168.1.102:8080/api`
|
||||
> Мастер-ключи начальной загрузки Infisical (`ENCRYPTION_KEY`, `AUTH_SECRET`, `POSTGRES_PASSWORD`) являются первоисточником шифрования и физически не могут храниться внутри самого Infisical. Они должны быть надежно сохранены в личном оффлайн-менеджере паролей администратора (KeePassXC / Bitwarden / 1Password).
|
||||
|
||||
1. Создать/запустить CT 901 (`core-secrets`, IP `192.168.1.102`).
|
||||
2. Развернуть `/opt/secrets/compose.yaml`, подставив мастер-ключи из оффлайн-хранилища.
|
||||
3. Запустить контейнеры: `docker compose -f /opt/secrets/compose.yaml up -d`.
|
||||
2. Для первого старта вручную положить Compose Infisical в `/opt/infisical/compose.yaml` и подставить мастер-ключи из оффлайн-хранилища. Пайплайну эти ключи пока неоткуда прочитать.
|
||||
3. Запустить контейнеры: `docker compose -f /opt/infisical/compose.yaml up -d`.
|
||||
4. Проверить API: `curl http://192.168.1.102:8080/api/status`.
|
||||
5. В Gitea Settings → Secrets добавить репозиторные секреты:
|
||||
- `INFISICAL_CLIENT_ID` (Machine Identity: `ci-cd-runner`)
|
||||
- `INFISICAL_CLIENT_SECRET`
|
||||
|
||||
Дальнейшие изменения этого стека накатывает пайплайн **`ansible-core-secrets`**. Первым запуском он не заменяет ручной старт: мастер-ключи ещё неоткуда прочитать.
|
||||
Дальше стек ведёт пайплайн **`ansible-core-secrets`**: Infisical в `/opt/infisical`, Vaultwarden в `/opt/vaultwarden`. Пока в репозитории есть `playbooks/migrate-core-secrets.yml`, пайплайн один раз переносит данные из `/opt/secrets` и останавливает старый Compose. Тома при этом не удаляются. После успешного переноса этот плейбук из репозитория убирается.
|
||||
|
||||
### Шаг 4. Traefik и Authentik (CT 902)
|
||||
1. Запустить пайплайн **`ansible-core-net`** в Gitea Actions.
|
||||
1. Запустить пайплайн **`ansible-core-net`** в Gitea Actions. Первый прогон на новом CT должен быть полным: ручной запуск выполняет `site.yml --limit core-net` и ставит Docker ролью `host`.
|
||||
2. Раннер подключается напрямую к `http://192.168.1.102:8080/api`, забирает SSH-ключ раннера и секреты Authentik из `/services/authentik`. Если секретов Authentik ещё нет, раннер генерирует их и сохраняет в Infisical.
|
||||
3. Плейбук поднимает на CT 902 Traefik и Authentik. Authentik слушает только `127.0.0.1:9000`; снаружи его публикует Traefik как `https://auth.gunihome.ru`. Blueprint создаёт группы `admins` и `family`, пользователей `karpenok` и `ksynia` и закрывает панель Traefik группой `admins`. Пароли blueprint не задаёт.
|
||||
4. Проверить `https://auth.gunihome.ru`, `https://proxy.gunihome.ru`, `gitea.gunihome.ru` и `infisical.gunihome.ru`. Панель открывается учёткой из группы `admins`. Первый запуск Authentik создаёт `akadmin`; одноразовый пароль пишется в лог контейнера `authentik-server`. `akadmin` в группу `admins` не входит.
|
||||
|
||||
### Шаг 5. Внешние сервисы (NetBird на VPS)
|
||||
1. Запустить пайплайн **`netbird-install`** в Gitea Actions.
|
||||
2. Раннер считывает боевые ключи из `/services/netbird` и деплоит стек NetBird на `45.154.185.208`.
|
||||
Правка только роли `traefik` или только роли `authentik` ставит эту роль, без повторной подготовки машины.
|
||||
|
||||
### Шаг 5. NetBird (rus-central)
|
||||
1. Запустить пайплайн **`ansible-rus-central`** в Gitea Actions. Ручной запуск сверяет машину целиком. Push в `roles/rus-central/netbird` ставит только NetBird.
|
||||
2. Раннер считывает ключи из `/services/netbird` и деплоит стек в `/opt/netbird` на `45.154.185.208`. Домен берётся из `host_vars/rus-central.yml`.
|
||||
Reference in new issue
Block a user