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

+26
View File
@@ -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/<id>/services`; описанного в документации `POST /api/v1/agent-vault/services` там ещё нет.
---
## 3. Последовательность холодного старта (Cold Bootstrap)