Files
homelab-infra/ansible/roles/agent_vault_service/tasks/main.yml
T
karpenok 8061dd7604
ansible-deploy / plan (push) Successful in 1s
ansible-lint / lint (push) Successful in 3s
ansible-deploy / deploy (opnsense, ) (push) Successful in 10s
feat(agent_vault,opnsense): support basic auth and register OPNsense API
2026-11-17 15:27:02 +07:00

273 lines
11 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_service_credential_type in ['bearer', 'basic']
- >-
(agent_vault_service_credential_type == 'bearer' and agent_vault_secret_key | default('') | length > 0)
or
(agent_vault_service_credential_type == 'basic'
and agent_vault_secret_username_key | default('') | length > 0
and agent_vault_secret_password_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 для bearer или
agent_vault_secret_username_key/agent_vault_secret_password_key для basic),
а также INFISICAL_DOMAIN и INFISICAL_TOKEN в окружении.
quiet: true
no_log: true
- name: Определить список ключей секретов для чтения
ansible.builtin.set_fact:
agent_vault_secret_keys_to_read: >-
{{ [agent_vault_secret_key]
if agent_vault_service_credential_type == 'bearer'
else [agent_vault_secret_username_key, agent_vault_secret_password_key] }}
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: "{{ item }}"
SECRET_PATH: "{{ agent_vault_secret_path }}"
SECRET_ENV: "{{ agent_vault_secret_env }}"
loop: "{{ agent_vault_secret_keys_to_read }}"
register: agent_vault_secrets_raw
changed_when: false
no_log: true
delegate_to: localhost
become: false
- name: Проверить, что прочитанные секреты не пустые
ansible.builtin.assert:
that:
- >-
agent_vault_secrets_raw.results | map(attribute='stdout') | map('trim')
| select('equalto', '') | list | length == 0
fail_msg: >-
В Infisical отсутствует один из ключей ({{ agent_vault_secret_keys_to_read | join(', ') }})
по пути {{ 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_credential: >-
{{ ({'type': 'bearer', 'value': (agent_vault_secrets_raw.results[0].stdout | trim)}
| combine({'headerName': agent_vault_service_header_name}
if agent_vault_service_header_name | length > 0 else {})
| combine({'headerPrefix': agent_vault_service_header_prefix}
if agent_vault_service_header_prefix | length > 0 else {}))
if agent_vault_service_credential_type == 'bearer'
else {'type': 'basic',
'username': (agent_vault_secrets_raw.results[0].stdout | trim),
'password': (agent_vault_secrets_raw.results[1].stdout | trim)} }}
no_log: 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: "{{ agent_vault_service_credential }}"
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 'создан') }}.