Files
homelab-infra/ansible/roles/agent_vault_service/tasks/main.yml
T
karpenok e6e3cb162a
ansible-core-net / deploy (push) Successful in 25s
feat(agent-vault): регистрировать сервисы продуктов в Access Bundle из роли
Общая роль 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 там ещё нет.
2026-11-13 20:57:02 +07:00

247 lines
9.4 KiB
YAML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
# Идемпотентная регистрация сервиса в 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 'создан') }}.