community.network.ipadm_addr 模块 – 管理 Solaris/illumos 系统接口上的 IP 地址

注意

此模块是 community.network 集合（版本 5.1.0）的一部分。

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

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

要在 playbook 中使用它，请指定：community.network.ipadm_addr。

注意

community.network 集合已被弃用，将从 Ansible 12 中移除。有关更多信息，请参阅讨论线程。

已弃用

在以下版本中移除:

版本 6.0.0

原因:

此集合及其中的所有内容都未维护并已弃用。

替代方案:

未知。

概要

  • 在 Solaris/illumos 系统上的网络接口上创建/删除静态/动态 IP 地址。

  • 在 Solaris/illumos 系统上的网络接口上启用/禁用静态/动态 IP 地址。

  • 管理 Solaris/illumos 系统上的网络接口上的 IPv6 链路本地地址。

别名：network.illumos.ipadm_addr

参数

参数

注释

address

别名：addr

字符串

指定要以 CIDR 表示法配置的 IP 地址。

addrobj

字符串 / 必需

指定系统上唯一的 IP 地址。

addrtype

字符串

指定要配置的 IP 地址类型。

选择

  • "static" ←（默认）

  • "dhcp"

  • "addrconf"

state

字符串

在网络接口上创建/删除/启用/禁用 IP 地址。

选择

  • "absent"

  • "present" ←（默认）

  • "up"

  • "down"

  • "enabled"

  • "disabled"

  • "refreshed"

temporary

布尔值

指定配置的 IP 地址是临时的。临时 IP 地址在重新启动后不会持久保留。

选择

  • false ←（默认）

  • true

wait

字符串

指定我们等待通过 DHCP 获取地址的时间（以秒为单位）。

默认值： 60

示例

- name: Configure IP address 10.0.0.1 on e1000g0
  community.network.ipadm_addr: addr=10.0.0.1/32 addrobj=e1000g0/v4 state=present

- name: Delete addrobj
  community.network.ipadm_addr: addrobj=e1000g0/v4 state=absent

- name: Configure link-local IPv6 address
  community.network.ipadm_addr: addtype=addrconf addrobj=vnic0/v6

- name: Configure address via DHCP and wait 180 seconds for address obtaining
  community.network.ipadm_addr: addrobj=vnic0/dhcp addrtype=dhcp wait=180

返回值

常见的返回值记录在这里，以下是此模块独有的字段

键

描述

address

字符串

IP 地址

返回值：仅当 addrtype 为 ‘static’ 时

示例： "1.3.3.7/32"

addrobj

字符串

地址对象名称

返回值：总是

示例： "bge0/v4"

addrtype

字符串

地址类型

返回值：总是

示例： "static"

state

字符串

目标状态

返回值：总是

示例： "present"

temporary

布尔值

指定操作是否在重新启动后保持

返回值：总是

示例： true

wait

字符串

我们等待 DHCP 的时间

返回值：仅当 addrtype 为 ‘dhcp’ 时

示例： "10"

状态

  • 此模块将在 6.0.0 版本中移除。 [已弃用]

  • 更多信息请参考 已弃用。

作者

  • Adam Števko (@xen0l)