feat(agent-vault): регистрировать сервисы продуктов в Access Bundle из роли
ansible-core-net / deploy (push) Successful in 25s

Общая роль agent_vault_service ищет сервис по имени в бандле, создаёт при
отсутствии и обновляет креденшл при наличии, поэтому ротация токена на
каждом прогоне не ломает доступ агента.

Креденшл читается из Infisical через infisical secrets get --plain и не
проходит через переменные Ansible. Если API не принял PATCH, сервис
пересоздаётся.

Remnawave регистрирует панель после сохранения API-токена в
/services/remnawave: хост rw.gunihome.ru:443, путь /api, GET и POST.

На версии v0.167.7 сервисы создаются bundle-scoped маршрутом
POST /api/v1/agent-vault/access-bundles/<id>/services: описанного в
документации POST /api/v1/agent-vault/services там ещё нет.
This commit is contained in:
karpenok committed 2026-11-13 20:57:02 +07:00
1 parent 8e0c6d9024
commit e6e3cb162a
6 files changed
+315

No files matched your search

+1
View File
@@ -8,6 +8,7 @@ on:
- 'ansible/ansible.cfg' - 'ansible/ansible.cfg'
- 'ansible/ci/**' - 'ansible/ci/**'
- 'ansible/roles/core-net/**' - 'ansible/roles/core-net/**'
- 'ansible/roles/agent_vault_service/**'
- 'ansible/roles/netbird_client/**' - 'ansible/roles/netbird_client/**'
- 'ansible/roles/vmagent/**' - 'ansible/roles/vmagent/**'
- 'ansible/roles/host/**' - 'ansible/roles/host/**'
+1
View File
@@ -16,3 +16,4 @@ vault_pass.txt
*.bak *.bak
*.tmp *.tmp
.kimi-code/local.toml .kimi-code/local.toml
.agent-vault-session
+26
View File
@@ -100,6 +100,32 @@ API Endpoint (внутренний LAN): `http://192.168.1.102:8080/api`
Провайдер Proxmox сам дописывает `/api2/json`. В секрет его класть не нужно. Секреты `/proxmox/pve` этот репозиторий не читает: Terraform описывает только узел `netcore`. Провайдер 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/<id>/services`; описанного в документации `POST /api/v1/agent-vault/services` там ещё нет.
--- ---
## 3. Последовательность холодного старта (Cold Bootstrap) ## 3. Последовательность холодного старта (Cold Bootstrap)
@@ -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: ""
@@ -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 'создан') }}.
@@ -324,6 +324,23 @@
changed_when: true changed_when: true
no_log: 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 - name: Записать .env subscription-page
ansible.builtin.template: ansible.builtin.template:
src: subscription.env.j2 src: subscription.env.j2