7.0 KiB
Инструкция по развертыванию инфраструктуры (Bootstrap Guide)
Документ описывает контур, который поднимает этот репозиторий, порядок холодного старта и секреты в Infisical. Gitea в автоматизацию не входит: без неё не запустить пайплайны.
1. Топология инфраструктуры
1.1. Физические узлы и гипервизоры (Proxmox VE)
| Узел | IP | Роль | SSH / Доступ |
|---|---|---|---|
| netcore | 192.168.1.100:8006 |
PVE Cluster Node / Core CTs | root@192.168.1.100 (LAN only) |
| pve | 192.168.1.2:8006 |
PVE Main Node / Services | root@192.168.1.2 (LAN only) |
| opnsense | 192.168.1.1 |
Маршрутизатор / Шлюз | Шлюз по умолчанию |
1.2. Базовые управляющие контейнеры (LXC / Debian 13)
| 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) |
| CT 902 | netcore |
192.168.1.104 |
core-net |
Traefik (:80, :443), Authentik (127.0.0.1:9000) |
1.3. Внешние узлы
| Имя | IP | Роль | Стек |
|---|---|---|---|
| rus-central | 45.154.185.208 |
Внешний шлюз NetBird | Docker Compose: NetBird Management, Signal, Dashboard, Coturn |
2. Структура секретов в Infisical
Проект: infra (Slug: infra-xxx, Environment: prod)
API Endpoint (внутренний LAN): http://192.168.1.102:8080/api
Внешний URL: https://infisical.gunihome.ru
Пути секретов:
/ci-cd:RUNNER_SSH_KEY: приватный SSH-ключ раннера (ed25519) для деплоя на хосты.TF_STATE_TOKEN: токен доступа к HTTP State Backend Gitea.
/services/infisical:POSTGRES_PASSWORD: пароль БД Infisical.ENCRYPTION_KEY: 32-байтный hex-ключ шифрования хранилища.AUTH_SECRET: base64 секрет сессий/JWT Infisical.
/services/authentik: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_AUTH_SECRET: секрет auth.NETBIRD_DATASTORE_KEY: 32-байтный ключ SQLite/datastore.NETBIRD_SESSION_KEY: 32-байтный ключ веб-сессий.
/proxmox/netcore:PROXMOX_ENDPOINT:https://192.168.1.100:8006/api2/jsonPROXMOX_API_TOKEN: токенroot@pam!terraform=UUID
/proxmox/pve:PROXMOX_ENDPOINT:https://192.168.1.2:8006/api2/jsonPROXMOX_API_TOKEN: токенroot@pam!terraform=UUID
3. Последовательность холодного старта (Cold Bootstrap)
При полном отказе всех систем порядок восстановления следующий:
Шаг 1. Гипервизоры и сеть
- Поднять OPNsense (
192.168.1.1). - Запустить Proxmox VE на
netcore(192.168.1.100) иpve(192.168.1.2). - Убедиться в доступности SSH по ключам
root_home.
Шаг 2. Gitea & Gitea Actions (CT 109)
- Запустить CT 109 на
pve. - Запустить стек Gitea:
docker compose up -dв каталоге Gitea. - Проверить доступность UI по адресу
http://192.168.1.217:3000. - Убедиться, что раннер
gitea-runnerподключен и имеет статусidle.
Шаг 3. Хранилище секретов Infisical (CT 901)
Important
Мастер-ключи начальной загрузки Infisical (
ENCRYPTION_KEY,AUTH_SECRET,POSTGRES_PASSWORD) являются первоисточником шифрования и физически не могут храниться внутри самого Infisical. Они должны быть надежно сохранены в личном оффлайн-менеджере паролей администратора (KeePassXC / Bitwarden / 1Password).
- Создать/запустить CT 901 (
core-secrets, IP192.168.1.102). - Развернуть
/opt/secrets/compose.yaml, подставив мастер-ключи из оффлайн-хранилища. - Запустить контейнеры:
docker compose -f /opt/secrets/compose.yaml up -d. - Проверить API:
curl http://192.168.1.102:8080/api/status. - В Gitea Settings → Secrets добавить репозиторные секреты:
INFISICAL_CLIENT_ID(Machine Identity:ci-cd-runner)INFISICAL_CLIENT_SECRET
Дальнейшие изменения этого стека накатывает пайплайн ansible-core-secrets. Первым запуском он не заменяет ручной старт: мастер-ключи ещё неоткуда прочитать.
Шаг 4. Traefik и Authentik (CT 902)
- Запустить пайплайн
ansible-core-netв Gitea Actions. - Раннер подключается напрямую к
http://192.168.1.102:8080/api, забирает SSH-ключ раннера и секреты Authentik из/services/authentik. Если секретов Authentik ещё нет, раннер генерирует их и сохраняет в Infisical. - Плейбук поднимает на CT 902 Traefik и Authentik. Authentik слушает только
127.0.0.1:9000; снаружи его публикует Traefik какhttps://auth.gunihome.ru. Blueprint создаёт группыadminsиfamily, пользователейkarpenokиksyniaи закрывает панель Traefik группойadmins. Пароли blueprint не задаёт. - Проверить
https://auth.gunihome.ru,https://proxy.gunihome.ru,gitea.gunihome.ruиinfisical.gunihome.ru. Панель открывается учёткой из группыadmins. Первый запуск Authentik создаётakadmin; одноразовый пароль пишется в лог контейнераauthentik-server.akadminв группуadminsне входит.
Шаг 5. Внешние сервисы (NetBird на VPS)
- Запустить пайплайн
netbird-installв Gitea Actions. - Раннер считывает боевые ключи из
/services/netbirdи деплоит стек NetBird на45.154.185.208.