infoblox.nios_modules.nios_restartservices 模块 – 重启网格服务。

注意

此模块是 infoblox.nios_modules 集合(版本 1.7.1)的一部分。

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

要安装它,请使用:ansible-galaxy collection install infoblox.nios_modules。您需要进一步的要求才能使用此模块,请参阅 要求 了解详细信息。

要在 playbook 中使用它,请指定:infoblox.nios_modules.nios_restartservices

infoblox.nios_modules 1.1.0 中的新增功能

概要

  • 重启网格服务。

  • 在不使用任何选项的情况下调用时,如果需要,将重启默认重启组上的所有服务。

要求

以下要求需要在执行此模块的主机上满足。

  • infoblox-client

参数

参数

注释

groups

列表 / 元素=字符串

要重启的服务重启组的列表。

members

列表 / 元素=字符串

要重启的网格成员的列表。

mode

字符串

网格重启情况下的重启方法。

选项

  • "GROUPED"

  • "SEQUENTIAL"

  • "SIMULTANEOUS"

provider

字典

包含连接详细信息的字典对象。

cert

字符串

指定客户端证书文件,其中包含 x509 配置的摘要,以便为 NIOS 远程实例提供额外的安全连接层。

也可以使用 INFOBLOX_CERT 环境变量指定值。

host

字符串

指定 DNS 主机名或地址,以便通过 REST 连接到 NIOS WAPI 的远程实例

也可以使用 INFOBLOX_HOST 环境变量指定值。

http_pool_connections

整数

在此处插入描述

默认值: 10

http_pool_maxsize

整数

在此处插入描述

默认值: 10

http_request_timeout

整数

在收到响应之前等待的时间量

也可以使用 INFOBLOX_HTTP_REQUEST_TIMEOUT 环境变量指定值。

默认值: 10

key

字符串

指定私钥文件,用于使用证书进行加密,以便与 NIOS 远程实例连接。

也可以使用 INFOBLOX_KEY 环境变量指定值。

max_results

整数

指定要返回的最大对象数,如果设置为负数,当返回的对象数超过设置时,设备将返回错误。

也可以使用 INFOBLOX_MAX_RESULTS 环境变量指定值。

默认值: 1000

max_retries

整数

配置在声明连接可用之前尝试的重试次数

也可以使用 INFOBLOX_MAX_RETRIES 环境变量指定值。

默认值: 3

password

字符串

指定用于对与 NIOS 远程实例的连接进行身份验证的密码。

也可以使用 INFOBLOX_PASSWORD 环境变量指定值。

silent_ssl_warnings

布尔值

在此处插入描述

选项

  • false

  • true ←(默认)

username

字符串

配置用于对与 NIOS 远程实例的连接进行身份验证的用户名。

也可以使用 INFOBLOX_USERNAME 环境变量指定值。

validate_certs

别名:ssl_verify

布尔值

用于启用或禁用验证 SSL 证书的布尔值

也可以使用 INFOBLOX_SSL_VERIFY 环境变量指定值。

选项

  • false ←(默认)

  • true

wapi_version

字符串

指定要使用的 WAPI 版本

也可以使用 INFOBLOX_WAPI_VERSION 环境变量指定值。

直到 ansible 2.8,默认 WAPI 为 1.4

默认值: "2.12.3"

restart_option

字符串

控制服务是无条件重启还是在需要时重启

选项

  • "RESTART_IF_NEEDED" ←(默认)

  • "FORCE_RESTART"

services

列表 / 元素=字符串

重启适用的服务列表。

选项

  • "ALL" ←(默认)

  • "DNS"

  • "DHCP"

  • "DHCPV4"

  • "DHCPV6"

默认值: ["ALL"]

备注

注意

  • 此模块支持 check_mode

  • 此模块必须在本地运行,可以通过指定 connection: local 来实现。

  • 请阅读 :ref:`nios_guide`,了解有关如何将 Infoblox 与 Ansible 一起使用的更多详细信息。

示例

- name: Restart all grid services if needed.
  infoblox.nios_modules.nios_restartservices:
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Restart DNS service if needed.
  infoblox.nios_modules.nios_restartservices:
    services:
      - DNS
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

作者

  • Mauricio Teixeira (@badnetmask)