diff --git a/.gitea/workflows/ansible-core-net.yml b/.gitea/workflows/ansible-core-net.yml index 98f39bd..bbfe77d 100644 --- a/.gitea/workflows/ansible-core-net.yml +++ b/.gitea/workflows/ansible-core-net.yml @@ -8,6 +8,7 @@ on: - 'ansible/ansible.cfg' - 'ansible/ci/**' - 'ansible/roles/core-net/**' + - 'ansible/roles/agent_vault_service/**' - 'ansible/roles/netbird_client/**' - 'ansible/roles/vmagent/**' - 'ansible/roles/host/**' diff --git a/.gitignore b/.gitignore index 0f0bbef..4a4d13b 100644 --- a/.gitignore +++ b/.gitignore @@ -16,3 +16,4 @@ vault_pass.txt *.bak *.tmp .kimi-code/local.toml +.agent-vault-session diff --git a/BOOTSTRAP.md b/BOOTSTRAP.md index 73b4182..9e4e100 100644 --- a/BOOTSTRAP.md +++ b/BOOTSTRAP.md @@ -100,6 +100,32 @@ API Endpoint (внутренний LAN): `http://192.168.1.102:8080/api` Провайдер Proxmox сам дописывает `/api2/json`. В секрет его класть не нужно. Секреты `/proxmox/pve` этот репозиторий не читает: Terraform описывает только узел `netcore`. +### 2.1. Сервисы для агентов (Agent Vault) + +Продукт, который сам создаёт себе токен, сам же регистрирует его в Access Bundle. За это отвечает общая роль `agent_vault_service` (стоит отдельно, как `host`): она ищет сервис по имени в бандле, создаёт его при отсутствии и обновляет креденшл при наличии. Ротация токена на каждом прогоне поэтому не ломает доступ агента. + +Вызов из роли продукта — после того как секрет сохранён в Infisical: + +```yaml +- name: Зарегистрировать панель Remnawave в Agent Vault + ansible.builtin.include_role: + name: agent_vault_service + vars: + agent_vault_service_name: remnawave-panel + agent_vault_service_host: "{{ remnawave_panel_domain }}:443" # имя, доступное агенту, не 127.0.0.1 + agent_vault_service_paths: ["/api"] + agent_vault_service_methods: [GET, POST] + agent_vault_secret_path: /services/remnawave + agent_vault_secret_key: REMNAWAVE_API_TOKEN +``` + +Креденшл роль читает из Infisical сама (`infisical secrets get --plain`), поэтому токен не проходит через переменные Ansible и не может попасть в лог прогона. + +По умолчанию сервис кладётся в бандл `homelab-ops` проекта `homelab-agents`. Запись идёт только в Infisical: прокси подхватывает изменение на следующем poll (60 с), агента перезапускать не нужно. Идентичность пайплайна должна быть **Admin** в этом проекте Agent Vault — иначе регистрация вернёт 403. + +На версии Infisical v0.167.7 сервисы создаются bundle-scoped маршрутом `POST /api/v1/agent-vault/access-bundles//services`; описанного в документации `POST /api/v1/agent-vault/services` там ещё нет. + + --- ## 3. Последовательность холодного старта (Cold Bootstrap) diff --git a/ansible/roles/agent_vault_service/defaults/main.yml b/ansible/roles/agent_vault_service/defaults/main.yml new file mode 100644 index 0000000..933cf86 --- /dev/null +++ b/ansible/roles/agent_vault_service/defaults/main.yml @@ -0,0 +1,24 @@ +--- +# Регистрация сервиса продукта в Access Bundle Agent Vault. +# Роль ничего не знает о продукте: всё приходит переменными от вызывающей роли. + +agent_vault_project_name: homelab-agents +agent_vault_bundle_name: homelab-ops + +# Токен и адрес берутся из окружения пайплайна (deploy-machine.sh: INFISICAL_TOKEN). +agent_vault_domain: "{{ lookup('env', 'INFISICAL_DOMAIN') }}" +agent_vault_access_token: "{{ lookup('env', 'INFISICAL_TOKEN') }}" + +agent_vault_service_name: "" +agent_vault_service_description: "" +# Хост в виде host:port, как его видит агент через прокси (публичное имя, не 127.0.0.1). +agent_vault_service_host: "" +# Пустые списки означают «любые методы» и «любые пути». +agent_vault_service_methods: [GET] +agent_vault_service_paths: [] + +# Откуда брать креденшл: путь и ключ секрета в проекте infra. +agent_vault_secret_project_id: "{{ lookup('env', 'INFISICAL_PROJECT_ID') }}" +agent_vault_secret_env: prod +agent_vault_secret_path: "" +agent_vault_secret_key: "" diff --git a/ansible/roles/agent_vault_service/tasks/main.yml b/ansible/roles/agent_vault_service/tasks/main.yml new file mode 100644 index 0000000..4718a73 --- /dev/null +++ b/ansible/roles/agent_vault_service/tasks/main.yml @@ -0,0 +1,246 @@ +--- +# Идемпотентная регистрация сервиса в Access Bundle Agent Vault. +# Сервис ищется по имени в бандле: нет — создаётся, есть — обновляется. +# Креденшл читается из Infisical и перезаписывается при каждом прогоне, +# поэтому токен не проходит через переменные Ansible. +# +# Использование: +# - ansible.builtin.include_role: +# name: agent_vault_service +# vars: +# agent_vault_service_name: remnawave-panel +# agent_vault_service_host: "rw.gunihome.ru:443" +# agent_vault_service_paths: ["/api"] +# agent_vault_service_methods: [GET, POST] +# agent_vault_secret_path: /services/remnawave +# agent_vault_secret_key: REMNAWAVE_API_TOKEN + +- name: Проверить параметры сервиса Agent Vault + ansible.builtin.assert: + that: + - agent_vault_service_name | default('') | length > 0 + - agent_vault_service_host | default('') | length > 0 + - agent_vault_secret_path | default('') | length > 0 + - agent_vault_secret_key | default('') | length > 0 + - agent_vault_domain | default('') | length > 0 + - agent_vault_access_token | default('') | length > 0 + fail_msg: >- + agent_vault_service: нужны agent_vault_service_name, agent_vault_service_host, + agent_vault_secret_path, agent_vault_secret_key, а также INFISICAL_DOMAIN + и INFISICAL_TOKEN в окружении. + quiet: true + no_log: true + +- name: Прочитать токен сервиса из Infisical + ansible.builtin.shell: | + set -euo pipefail + infisical secrets get "${SECRET_KEY}" \ + --domain="${INFISICAL_DOMAIN}" \ + --token="${INFISICAL_TOKEN}" \ + --env="${SECRET_ENV}" \ + --projectId="${INFISICAL_PROJECT_ID}" \ + --path="${SECRET_PATH}" \ + --plain + args: + executable: /bin/bash + environment: + INFISICAL_DOMAIN: "{{ agent_vault_domain }}" + INFISICAL_TOKEN: "{{ agent_vault_access_token }}" + INFISICAL_PROJECT_ID: "{{ agent_vault_secret_project_id }}" + SECRET_KEY: "{{ agent_vault_secret_key }}" + SECRET_PATH: "{{ agent_vault_secret_path }}" + SECRET_ENV: "{{ agent_vault_secret_env }}" + register: agent_vault_secret_raw + changed_when: false + no_log: true + delegate_to: localhost + become: false + +- name: Подставить прочитанный токен + ansible.builtin.set_fact: + agent_vault_service_token: "{{ agent_vault_secret_raw.stdout | trim }}" + no_log: true + +- name: Проверить, что секрет не пустой + ansible.builtin.assert: + that: + - agent_vault_service_token | length > 0 + fail_msg: >- + В Infisical нет {{ agent_vault_secret_key }} по пути {{ agent_vault_secret_path }} + (env {{ agent_vault_secret_env }}), либо у идентичности нет прав на чтение. + quiet: true + no_log: true + +- name: Получить список проектов Infisical + ansible.builtin.uri: + url: "{{ agent_vault_domain }}/v1/projects" + headers: + Authorization: "Bearer {{ agent_vault_access_token }}" + status_code: 200 + use_proxy: false + register: agent_vault_projects + changed_when: false + delegate_to: localhost + become: false + +- name: Найти Agent Vault-проект по имени + ansible.builtin.set_fact: + agent_vault_project_id: >- + {{ agent_vault_projects.json.projects | default([]) + | selectattr('name', 'equalto', agent_vault_project_name) + | map(attribute='id') | list | first | default('', true) }} + +- name: Проверить, что проект найден + ansible.builtin.assert: + that: + - agent_vault_project_id | length > 0 + fail_msg: >- + Проект {{ agent_vault_project_name }} не найден, либо идентичность пайплайна + не добавлена в него с ролью Admin (Access Control → Machine Identities). + quiet: true + +- name: Получить Access Bundles проекта + ansible.builtin.uri: + url: "{{ agent_vault_domain }}/v1/agent-vault/access-bundles?projectId={{ agent_vault_project_id }}&limit=100" + headers: + Authorization: "Bearer {{ agent_vault_access_token }}" + status_code: 200 + use_proxy: false + register: agent_vault_bundles + changed_when: false + delegate_to: localhost + become: false + +- name: Найти Access Bundle по имени + ansible.builtin.set_fact: + agent_vault_bundle_id: >- + {{ agent_vault_bundles.json.accessBundles | default([]) + | selectattr('name', 'equalto', agent_vault_bundle_name) + | map(attribute='id') | list | first | default('', true) }} + +- name: Проверить, что бандл найден + ansible.builtin.assert: + that: + - agent_vault_bundle_id | length > 0 + fail_msg: >- + Access Bundle {{ agent_vault_bundle_name }} не найден в проекте + {{ agent_vault_project_name }}. + quiet: true + +- name: Прочитать сервисы бандла + ansible.builtin.uri: + url: "{{ agent_vault_domain }}/v1/agent-vault/access-bundles/{{ agent_vault_bundle_id }}" + headers: + Authorization: "Bearer {{ agent_vault_access_token }}" + status_code: 200 + use_proxy: false + register: agent_vault_bundle + changed_when: false + delegate_to: localhost + become: false + +- name: Найти сервис по имени в бандле + ansible.builtin.set_fact: + agent_vault_service_id: >- + {{ agent_vault_bundle.json.accessBundle.services | default([]) + | selectattr('name', 'equalto', agent_vault_service_name) + | map(attribute='id') | list | first | default('', true) }} + +- name: Собрать тело сервиса + ansible.builtin.set_fact: + agent_vault_service_body: + type: http + name: "{{ agent_vault_service_name }}" + hostPattern: "{{ agent_vault_service_host }}" + allowedMethods: "{{ agent_vault_service_methods | length | ternary(agent_vault_service_methods, none) }}" + allowedPathPrefixes: "{{ agent_vault_service_paths | length | ternary(agent_vault_service_paths, none) }}" + description: "{{ agent_vault_service_description | length | ternary(agent_vault_service_description, none) }}" + credential: + type: bearer + value: "{{ agent_vault_service_token }}" + no_log: true + +- name: Создать сервис в бандле + ansible.builtin.uri: + url: "{{ agent_vault_domain }}/v1/agent-vault/access-bundles/{{ agent_vault_bundle_id }}/services" + method: POST + body_format: json + body: "{{ agent_vault_service_body }}" + headers: + Authorization: "Bearer {{ agent_vault_access_token }}" + status_code: [200, 201] + use_proxy: false + register: agent_vault_service_created + no_log: true + changed_when: true + delegate_to: localhost + become: false + when: agent_vault_service_id | length == 0 + +- name: Обновить сервис в бандле + ansible.builtin.uri: + url: "{{ agent_vault_domain }}/v1/agent-vault/access-bundles/{{ agent_vault_bundle_id }}/services/{{ agent_vault_service_id }}" + method: PATCH + body_format: json + body: "{{ agent_vault_service_body }}" + headers: + Authorization: "Bearer {{ agent_vault_access_token }}" + status_code: [200, 201] + use_proxy: false + register: agent_vault_service_updated + no_log: true + changed_when: true + failed_when: false + delegate_to: localhost + become: false + when: agent_vault_service_id | length > 0 + +# Если PATCH не принят (например, сервис остался от прежней схемы), +# пересоздаём его: прокси применит изменение на следующем poll. +- name: Сбросить признак пересоздания + ansible.builtin.set_fact: + agent_vault_service_recreated: false + +- name: Пересоздать сервис, если PATCH отклонён + when: + - agent_vault_service_id | length > 0 + - agent_vault_service_updated.status | default(0) not in [200, 201] + block: + - name: Удалить старый сервис + ansible.builtin.uri: + url: "{{ agent_vault_domain }}/v1/agent-vault/access-bundles/{{ agent_vault_bundle_id }}/services/{{ agent_vault_service_id }}" + method: DELETE + headers: + Authorization: "Bearer {{ agent_vault_access_token }}" + status_code: [200, 204] + use_proxy: false + changed_when: true + delegate_to: localhost + become: false + + - name: Создать сервис заново + ansible.builtin.uri: + url: "{{ agent_vault_domain }}/v1/agent-vault/access-bundles/{{ agent_vault_bundle_id }}/services" + method: POST + body_format: json + body: "{{ agent_vault_service_body }}" + headers: + Authorization: "Bearer {{ agent_vault_access_token }}" + status_code: [200, 201] + use_proxy: false + no_log: true + changed_when: true + delegate_to: localhost + become: false + + - name: Отметить пересоздание + ansible.builtin.set_fact: + agent_vault_service_recreated: true + +- name: Сообщить результат + ansible.builtin.debug: + msg: >- + Agent Vault: сервис {{ agent_vault_service_name }} в бандле + {{ agent_vault_bundle_name }} + {{ 'пересоздан' if agent_vault_service_recreated | default(false) + else ('обновлён' if agent_vault_service_id | length > 0 else 'создан') }}. diff --git a/ansible/roles/core-net/remnawave/tasks/main.yml b/ansible/roles/core-net/remnawave/tasks/main.yml index fe409cd..a179d17 100644 --- a/ansible/roles/core-net/remnawave/tasks/main.yml +++ b/ansible/roles/core-net/remnawave/tasks/main.yml @@ -324,6 +324,23 @@ changed_when: true no_log: true +# Токен перевыпускается каждым прогоном, поэтому регистрация в Agent Vault +# перезаписывает креденшл тем же шагом: иначе агент останется с протухшим. +- name: Зарегистрировать панель Remnawave в Agent Vault + ansible.builtin.include_role: + name: agent_vault_service + vars: + agent_vault_service_name: remnawave-panel + agent_vault_service_description: >- + Панель Remnawave (rw.gunihome.ru): ноды, пользователи и подписки VPN. + Креденшл — сервисный API-токен панели. + agent_vault_service_host: "{{ remnawave_panel_domain }}:443" + agent_vault_service_paths: ["/api"] + agent_vault_service_methods: [GET, POST] + agent_vault_secret_path: /services/remnawave + agent_vault_secret_key: REMNAWAVE_API_TOKEN + when: remnawave_api_token | default('') | length > 0 + - name: Записать .env subscription-page ansible.builtin.template: src: subscription.env.j2