feat(agent-vault): регистрировать сервисы продуктов в Access Bundle из роли
ansible-core-net / deploy (push) Successful in 25s
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:
1 parent
8e0c6d9024
commit
e6e3cb162a
6 files changed
+315
No files matched your search
@@ -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/**'
|
||||||
|
|||||||
@@ -16,3 +16,4 @@ vault_pass.txt
|
|||||||
*.bak
|
*.bak
|
||||||
*.tmp
|
*.tmp
|
||||||
.kimi-code/local.toml
|
.kimi-code/local.toml
|
||||||
|
.agent-vault-session
|
||||||
@@ -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
|
||||||
|
|||||||
Reference in new issue
Block a user