From f76cad9c735cb4c5d40f567dc322565342da14d0 Mon Sep 17 00:00:00 2001 From: karpenok Date: Tue, 10 Nov 2026 17:54:39 +0700 Subject: [PATCH] fix(ci): decouple runner from traefik via direct infisical lan endpoint and pin traefik version --- .gitea/workflows/ansible-core-net.yml | 11 +-- .gitea/workflows/ansible-core-secrets.yml | 11 +-- .gitea/workflows/netbird-install.yml | 11 +-- .gitea/workflows/terraform.yml | 16 ++-- BOOTSTRAP.md | 93 +++++++++++++++++++++++ ansible/roles/core_net/defaults/main.yml | 2 +- 6 files changed, 106 insertions(+), 38 deletions(-) create mode 100644 BOOTSTRAP.md diff --git a/.gitea/workflows/ansible-core-net.yml b/.gitea/workflows/ansible-core-net.yml index d752acd..719dff5 100644 --- a/.gitea/workflows/ansible-core-net.yml +++ b/.gitea/workflows/ansible-core-net.yml @@ -23,16 +23,9 @@ jobs: run: | set -eu - # Направляем домены на актуальный шлюз Traefik (core-net 192.168.1.104) - for domain in gitea.gunihome.ru infisical.gunihome.ru; do - if ! grep -q "${domain}" /etc/hosts; then - echo "192.168.1.104 ${domain}" >> /etc/hosts - fi - done - - # Авторизация в Infisical и получение токена сессии + # Прямое подключение к Infisical (CT 901) без зависимости от Traefik export INFISICAL_PROJECT_ID="806e7f09-5838-492a-946b-2d69b96876ab" - export INFISICAL_DOMAIN="https://infisical.gunihome.ru/api" + export INFISICAL_DOMAIN="http://192.168.1.102:8080/api" TOKEN=$(infisical login \ --domain="${INFISICAL_DOMAIN}" \ diff --git a/.gitea/workflows/ansible-core-secrets.yml b/.gitea/workflows/ansible-core-secrets.yml index af43839..6b6344e 100644 --- a/.gitea/workflows/ansible-core-secrets.yml +++ b/.gitea/workflows/ansible-core-secrets.yml @@ -23,16 +23,9 @@ jobs: run: | set -eu - # Направляем домены на актуальный шлюз Traefik (core-net 192.168.1.104) - for domain in gitea.gunihome.ru infisical.gunihome.ru; do - if ! grep -q "${domain}" /etc/hosts; then - echo "192.168.1.104 ${domain}" >> /etc/hosts - fi - done - - # Авторизация в Infisical и получение токена сессии + # Прямое подключение к Infisical (CT 901) без зависимости от Traefik export INFISICAL_PROJECT_ID="806e7f09-5838-492a-946b-2d69b96876ab" - export INFISICAL_DOMAIN="https://infisical.gunihome.ru/api" + export INFISICAL_DOMAIN="http://192.168.1.102:8080/api" TOKEN=$(infisical login \ --domain="${INFISICAL_DOMAIN}" \ diff --git a/.gitea/workflows/netbird-install.yml b/.gitea/workflows/netbird-install.yml index 7f34f67..5b547b4 100644 --- a/.gitea/workflows/netbird-install.yml +++ b/.gitea/workflows/netbird-install.yml @@ -24,16 +24,9 @@ jobs: run: | set -eu - # Направляем домены на актуальный шлюз Traefik (core-net 192.168.1.104) - for domain in gitea.gunihome.ru infisical.gunihome.ru; do - if ! grep -q "${domain}" /etc/hosts; then - echo "192.168.1.104 ${domain}" >> /etc/hosts - fi - done - - # Авторизация в Infisical и получение SSH-ключа + # Прямое подключение к Infisical (CT 901) без зависимости от Traefik export INFISICAL_PROJECT_ID="806e7f09-5838-492a-946b-2d69b96876ab" - export INFISICAL_DOMAIN="https://infisical.gunihome.ru/api" + export INFISICAL_DOMAIN="http://192.168.1.102:8080/api" TOKEN=$(infisical login \ --domain="${INFISICAL_DOMAIN}" \ diff --git a/.gitea/workflows/terraform.yml b/.gitea/workflows/terraform.yml index 80a40d1..695a1de 100644 --- a/.gitea/workflows/terraform.yml +++ b/.gitea/workflows/terraform.yml @@ -36,18 +36,14 @@ jobs: run: | set -eu - # Направляем домены на актуальный шлюз Traefik (core-net 192.168.1.104) - for domain in gitea.gunihome.ru infisical.gunihome.ru; do - if ! grep -q "${domain}" /etc/hosts; then - echo "192.168.1.104 ${domain}" >> /etc/hosts - else - sed -i "s/192.168.1.201/192.168.1.104/g" /etc/hosts - fi - done + # Направляем внутренние домены на шлюз Traefik (core-net 192.168.1.104) + if ! grep -q "gitea.gunihome.ru" /etc/hosts; then + echo "192.168.1.104 gitea.gunihome.ru" >> /etc/hosts + fi - # Авторизация в Infisical и экспорт секретов окружения + # Прямое подключение к Infisical (CT 901) без зависимости от Traefik export INFISICAL_PROJECT_ID="806e7f09-5838-492a-946b-2d69b96876ab" - export INFISICAL_DOMAIN="https://infisical.gunihome.ru/api" + export INFISICAL_DOMAIN="http://192.168.1.102:8080/api" TOKEN=$(infisical login \ --domain="${INFISICAL_DOMAIN}" \ diff --git a/BOOTSTRAP.md b/BOOTSTRAP.md new file mode 100644 index 0000000..f915e91 --- /dev/null +++ b/BOOTSTRAP.md @@ -0,0 +1,93 @@ +# Инструкция по развертыванию инфраструктуры (Bootstrap Guide) + +Данный документ описывает полную топологию хоумлаба, порядок холодного развертывания с нуля и структуру управления секретами через Infisical. + +--- + +## 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`, `:8080`), ACME Let's Encrypt | + +### 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/traefik`: + - `TRAEFIK_DASHBOARD_AUTH`: строка basicAuth для дашборда (`user:$2y$05$...`). +- `/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/json` + - `PROXMOX_API_TOKEN`: токен `root@pam!terraform=UUID` +- `/proxmox/pve`: + - `PROXMOX_ENDPOINT`: `https://192.168.1.2:8006/api2/json` + - `PROXMOX_API_TOKEN`: токен `root@pam!terraform=UUID` + +--- + +## 3. Последовательность холодного старта (Cold Bootstrap) + +При полном отказе всех систем порядок восстановления следующий: + +### Шаг 1. Гипервизоры и сеть +1. Поднять OPNsense (`192.168.1.1`). +2. Запустить Proxmox VE на `netcore` (`192.168.1.100`) и `pve` (`192.168.1.2`). +3. Убедиться в доступности SSH по ключам `root_home`. + +### Шаг 2. Gitea & Gitea Actions (CT 109) +1. Запустить CT 109 на `pve`. +2. Запустить стек Gitea: `docker compose up -d` в каталоге Gitea. +3. Проверить доступность UI по адресу `http://192.168.1.217:3000`. +4. Убедиться, что раннер `gitea-runner` подключен и имеет статус `idle`. + +### Шаг 3. Хранилище секретов Infisical (CT 901) +1. Создать/запустить CT 901 (`core-secrets`, IP `192.168.1.102`). +2. Развернуть `/opt/secrets/compose.yaml` с мастер-ключами Infisical. +3. Запустить контейнеры: `docker compose -f /opt/secrets/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` + +### Шаг 4. Маршрутизатор Traefik (CT 902) +1. Запустить пайплайн **`ansible-core-net`** в Gitea Actions. +2. Раннер подключается напрямую к `http://192.168.1.102:8080/api`, забирает SSH-ключ раннера и `TRAEFIK_DASHBOARD_AUTH`, после чего накатывает конфигурацию Traefik на CT 902. +3. Проверить вход на внешние домены (`gitea.gunihome.ru`, `infisical.gunihome.ru`). + +### Шаг 5. Внешние сервисы (NetBird на VPS) +1. Запустить пайплайн **`netbird-install`** в Gitea Actions. +2. Раннер считывает боевые ключи из `/services/netbird` и деплоит стек NetBird на `45.154.185.208`. diff --git a/ansible/roles/core_net/defaults/main.yml b/ansible/roles/core_net/defaults/main.yml index 4d799a1..4947095 100644 --- a/ansible/roles/core_net/defaults/main.yml +++ b/ansible/roles/core_net/defaults/main.yml @@ -1,5 +1,5 @@ --- -traefik_version: "v3.3" +traefik_version: "v3.3.7" traefik_dir: "/opt/traefik" traefik_dynamic_dir: "/opt/traefik/dynamic" traefik_log_dir: "/var/log/traefik"