From bf4144a767136b8abe5142cfb3625793f1cc7cbc Mon Sep 17 00:00:00 2001 From: karpenok Date: Wed, 11 Nov 2026 18:26:51 +0700 Subject: [PATCH] docs & refactor: sync secrets docs and clean up env var lookups --- BOOTSTRAP.md | 12 +++++++----- ansible/ci/deploy-machine.sh | 8 ++------ ansible/roles/core-mon/monitoring/defaults/main.yml | 8 ++++---- 3 files changed, 13 insertions(+), 15 deletions(-) diff --git a/BOOTSTRAP.md b/BOOTSTRAP.md index be86a6d..665ace7 100644 --- a/BOOTSTRAP.md +++ b/BOOTSTRAP.md @@ -51,6 +51,10 @@ API Endpoint (внутренний LAN): `http://192.168.1.102:8080/api` Внешний URL: `https://infisical.gunihome.ru` ### Пути секретов: +- `/USER/ADMIN`: + - `ADMIN_USER`: имя администратора хоумлаба (по умолчанию `karpenok`). + - `ADMIN_PASSWORD`: единый пароль администратора (Traefik Dashboard, Grafana, Ntfy, NetBird). + - `MAIL_ADMIN_USER`: почта администратора (для Grafana, NetBird и алертов). - `/ci-cd`: - `RUNNER_SSH_KEY`: приватный SSH-ключ раннера (ed25519) для деплоя на хосты. - `TF_STATE_TOKEN`: токен доступа к HTTP State Backend Gitea. @@ -58,19 +62,17 @@ API Endpoint (внутренний LAN): `http://192.168.1.102:8080/api` - `POSTGRES_PASSWORD`: пароль БД Infisical. - `ENCRYPTION_KEY`: 32-байтный hex-ключ шифрования хранилища. - `AUTH_SECRET`: base64 секрет сессий/JWT Infisical. -- `/services/authentik`: +- `/services/authentik` *(опционально, стек отключен)*: - `AUTHENTIK_SECRET_KEY`: случайный ключ шифрования сессий Authentik. - `AUTHENTIK_POSTGRES_PASSWORD`: пароль БД PostgreSQL Authentik. - `/services/netbird`: - - `NETBIRD_LETSENCRYPT_EMAIL`: почта для сертификата. Если секрета нет, берётся `letsencrypt_email` из `group_vars/all.yml`. + - `NETBIRD_LETSENCRYPT_EMAIL`: почта для сертификата. Если секрета нет, берётся `letsencrypt_email` из `group_vars/all.yml` или `MAIL_ADMIN_USER`. - `NETBIRD_AUTH_SECRET`: секрет auth. - `NETBIRD_DATASTORE_KEY`: 32-байтный ключ SQLite/datastore. - `NETBIRD_SESSION_KEY`: 32-байтный ключ веб-сессий. - - `NETBIRD_ADMIN_EMAIL`: почта первого суперпользователя NetBird. - - `NETBIRD_ADMIN_NAME`: имя суперпользователя NetBird. - - `NETBIRD_ADMIN_PASSWORD`: пароль суперпользователя NetBird (минимум 8 символов). - `NETBIRD_API_TOKEN`: сервисный API-токен управления (создаётся и сохраняется пайплайном автоматически). - `NETBIRD_SETUP_KEY`: многоразовый ключ регистрации узлов (создаётся и сохраняется пайплайном автоматически). + - *(Параметры `NETBIRD_ADMIN_NAME`, `NETBIRD_ADMIN_PASSWORD`, `NETBIRD_ADMIN_EMAIL` наследуются из `/USER/ADMIN`)*. - `/services/opnsense`: - `OPNSENSE_API_KEY`: API-ключ администратора OPNsense. - `OPNSENSE_API_SECRET`: API-секрет администратора OPNsense. diff --git a/ansible/ci/deploy-machine.sh b/ansible/ci/deploy-machine.sh index 885a023..769bb0a 100755 --- a/ansible/ci/deploy-machine.sh +++ b/ansible/ci/deploy-machine.sh @@ -63,12 +63,8 @@ case "$machine" in export INFISICAL_AUTH_SECRET="${AUTH_SECRET}" ;; core-mon) - export GRAFANA_ADMIN_USER="${ADMIN_USER:-karpenok}" - export GRAFANA_ADMIN_PASSWORD="${ADMIN_PASSWORD:-}" - export NTFY_ADMIN_USER="${ADMIN_USER:-karpenok}" - export NTFY_ADMIN_PASSWORD="${ADMIN_PASSWORD:-}" - extra+=(-e "grafana_admin_user=${GRAFANA_ADMIN_USER}" -e "grafana_admin_password=${GRAFANA_ADMIN_PASSWORD}") - extra+=(-e "ntfy_admin_user=${NTFY_ADMIN_USER}" -e "ntfy_admin_password=${NTFY_ADMIN_PASSWORD}") + extra+=(-e "grafana_admin_user=${ADMIN_USER:-karpenok}" -e "grafana_admin_password=${ADMIN_PASSWORD:-}") + extra+=(-e "ntfy_admin_user=${ADMIN_USER:-karpenok}" -e "ntfy_admin_password=${ADMIN_PASSWORD:-}") if [ -n "${MAIL_ADMIN_USER:-}" ]; then extra+=(-e "grafana_admin_email=${MAIL_ADMIN_USER}") fi diff --git a/ansible/roles/core-mon/monitoring/defaults/main.yml b/ansible/roles/core-mon/monitoring/defaults/main.yml index 8f381ff..73fc00d 100644 --- a/ansible/roles/core-mon/monitoring/defaults/main.yml +++ b/ansible/roles/core-mon/monitoring/defaults/main.yml @@ -2,12 +2,12 @@ monitoring_dir: /opt/monitoring prometheus_retention: "30d" -grafana_admin_user: "{{ lookup('ansible.builtin.env', 'GRAFANA_ADMIN_USER', default='karpenok') }}" -grafana_admin_password: "{{ lookup('ansible.builtin.env', 'GRAFANA_ADMIN_PASSWORD', default='') }}" +grafana_admin_user: "{{ lookup('ansible.builtin.env', 'ADMIN_USER', default='karpenok') }}" +grafana_admin_password: "{{ lookup('ansible.builtin.env', 'ADMIN_PASSWORD', default='') }}" grafana_admin_email: "{{ lookup('ansible.builtin.env', 'MAIL_ADMIN_USER', default=grafana_admin_user ~ '@gunihome.ru') }}" grafana_root_url: "https://graf.gunihome.ru" ntfy_base_url: "https://ntfy.gunihome.ru" ntfy_default_topic: "homelab-alerts" -ntfy_admin_user: "{{ lookup('ansible.builtin.env', 'NTFY_ADMIN_USER', default=grafana_admin_user) }}" -ntfy_admin_password: "{{ lookup('ansible.builtin.env', 'NTFY_ADMIN_PASSWORD', default=grafana_admin_password) }}" +ntfy_admin_user: "{{ grafana_admin_user }}" +ntfy_admin_password: "{{ grafana_admin_password }}"