community.general.consul_agent_service 模块 – 在 Consul 集群中添加、修改和删除服务

注意

此模块是 community.general 集合 (版本 10.1.0) 的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.general。

要在剧本中使用它，请指定：community.general.consul_agent_service。

community.general 9.1.0 中的新增功能

概述 

允许通过代理在 Consul 集群中添加、修改和删除服务。
目前没有计划在一个操作中创建服务和检查。这是因为 Consul API 不为服务提供检查，并且检查本身与模块参数不匹配。因此，在此模块中只能创建一个没有检查的服务。

参数 

参数	注释
address 字符串	要通告服务将侦听的地址。此值将作为 `address` 参数传递给 Consul 的 `/v1/agent/service/register` API 方法，因此请参阅 Consul API 文档了解更多详细信息。
ca_path 字符串	用于 https 连接的 CA 包
enable_tag_override 布尔值	指定禁用此服务标签的反熵功能。如果 EnableTagOverride 设置为 true，则外部代理可以更新目录中的此服务并修改标签。选项 `false` ← (默认) `true`
host 字符串	Consul 代理的主机，默认为 `localhost`。默认值： `"localhost"`
id 字符串	为此服务指定一个唯一的 ID。每个代理必须是唯一的。如果未提供，则默认为 `name` 参数。如果 `state=absent`，则默认为提供的服务名称。
meta 字典	用于过滤的可选元数据。对于键，允许使用字符 `A-Z`、`a-z`、`0-9`、`_`、`-`。不允许使用的字符将替换为下划线。
name 字符串	节点上服务的唯一名称，每个节点必须是唯一的，如果注册服务则为必需。
port 整数	Consul 代理正在运行的端口。默认值： `8500`
scheme 字符串	Consul 代理正在运行的协议方案。默认为 `http`，对于安全连接可以设置为 `https`。默认值： `"http"`
service_port 整数	服务正在侦听的端口。可以选择提供用于注册服务，即如果设置了 `name` 或 `id`。
state 字符串	服务应该是存在还是不存在。选项 `"present"` ← (默认) `"absent"`
tags 列表 / 元素=字符串	将附加到服务注册的标签。
token 字符串	用于授权的令牌。
validate_certs 布尔值	是否验证 Consul 代理的 TLS 证书。选项 `false` `true` ← (默认)
weights 字典	指定服务的权重默认值： `{"passing": 1, "warning": 1}`
passing 整数	通过的权重。默认值： `1`
warning 整数	警告的权重。默认值： `1`

属性 

属性	支持	描述
action_group	操作组： community.general.consul	在 `module_defaults` 中使用 `group/community.general.consul` 为此模块设置默认值。
check_mode	支持：完整	可以在 `check_mode` 中运行并返回已更改的状态预测，而无需修改目标。
diff_mode	支持: 部分支持在检查模式下，diff 将会遗漏操作属性。	当处于 diff 模式时，将返回已更改的内容的详细信息（或者在 `check_mode` 中可能需要更改的内容）。

示例 

- name: Register nginx service with the local consul agent
  community.general.consul_agent_service:
    host: consul1.example.com
    token: some_management_acl
    name: nginx
    service_port: 80

- name: Register nginx with a tcp check
  community.general.consul_agent_service:
    host: consul1.example.com
    token: some_management_acl
    name: nginx
    service_port: 80

- name: Register nginx with an http check
  community.general.consul_agent_service:
    host: consul1.example.com
    token: some_management_acl
    name: nginx
    service_port: 80

- name: Register external service nginx available at 10.1.5.23
  community.general.consul_agent_service:
    host: consul1.example.com
    token: some_management_acl
    name: nginx
    service_port: 80
    address: 10.1.5.23

- name: Register nginx with some service tags
  community.general.consul_agent_service:
    host: consul1.example.com
    token: some_management_acl
    name: nginx
    service_port: 80
    tags:
      - prod
      - webservers

- name: Register nginx with some service meta
  community.general.consul_agent_service:
    host: consul1.example.com
    token: some_management_acl
    name: nginx
    service_port: 80
    meta:
      nginx_version: 1.25.3

- name: Remove nginx service
  community.general.consul_agent_service:
    host: consul1.example.com
    token: some_management_acl
    service_id: nginx
    state: absent

- name: Register celery worker service
  community.general.consul_agent_service:
    host: consul1.example.com
    token: some_management_acl
    name: celery-worker
    tags:
      - prod
      - worker

返回值 

常见的返回值记录在此处，以下是此模块特有的字段

键	描述
operation 字符串	执行的操作。返回: changed 示例: `"update"`
service 字典	Consul HTTP API 返回的服务。返回: always 示例: `{"Address": "localhost", "ContentHash": "61a245cd985261ac", "Datacenter": "dc1", "EnableTagOverride": false, "ID": "nginx", "Meta": [{"nginx_version": "1.23.3"}], "Port": 80, "Service": "nginx", "Tags": ["http"], "Weights": {"Passing": 1, "Warning": 1}}`

作者

Michael Ilg (@Ilgmi)