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
@@ -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 'создан') }}.
|
||||
Reference in new issue
Block a user