purestorage.flasharray.purefa_network 模块 – 管理 Pure Storage FlashArray 中的网络接口

注意

此模块是 purestorage.flasharray 集合 (版本 1.32.0) 的一部分。

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

要安装它，请使用：ansible-galaxy collection install purestorage.flasharray。您需要其他要求才能使用此模块，有关详细信息，请参阅 要求。

要在 playbook 中使用它，请指定：purestorage.flasharray.purefa_network。

purestorage.flasharray 1.0.0 中的新增功能

概要

  • 此模块管理 Pure Storage FlashArray 上的物理和虚拟网络接口。

  • 要管理 VLAN 接口，请使用 *purestorage.flasharray.purefa_vlan* 模块。

  • 要管理网络子网，请使用 *purestorage.flasharray.purefa_subnet* 模块。

  • 要从非管理端口删除 IP 地址，请使用 0.0.0.0/0

要求

执行此模块的主机需要以下要求。

  • python >= 3.3

  • purestorage >= 1.19

  • py-pure-client >= 1.26.0

  • netaddr

  • requests

  • pycountry

  • urllib3

参数

参数

注释

address

字符串

接口的 IPv4 或 IPv6 地址，采用 CIDR 表示法。

要从非管理端口删除 IP 地址，请使用 0.0.0.0/0

api_token

字符串

具有管理员权限用户的 FlashArray API 令牌。

disable_warnings

布尔值

在 purestorage.flasharray 1.29.0 中添加

禁用调试日志中的不安全证书警告

选项

  • false ← (默认)

  • true

enabled

布尔值

在 purestorage.flasharray 1.22.0 中添加

网络接口的状态

选项

  • false

  • true ← (默认)

fa_url

字符串

FlashArray 管理 IPv4 地址或主机名。

gateway

字符串

接口网关的 IPv4 或 IPv6 地址。

interface

字符串

在 purestorage.flasharray 1.22.0 中添加

如果提供 subinterfaces，则要创建的接口类型

选项

  • "vif"

  • "lacp"

mtu

整数

接口的 MTU 大小。范围是 1280 到 9216。

name

字符串 / 必填

接口名称（物理或虚拟）。

servicelist

列表 / 元素=字符串

在 purestorage.flasharray 1.15.0 中添加

将指定的（逗号分隔）服务列表分配给一个或多个指定的接口。

替换之前的服务列表。

支持的服务列表取决于网络接口是以太网还是光纤通道。

请注意，*system* 仅对云块存储有效。

选项

  • "replication"

  • "management"

  • "ds"

  • "file"

  • "iscsi"

  • "scsi-fc"

  • "nvme-fc"

  • "nvme-tcp"

  • "nvme-roce"

  • "system"

state

字符串

现有接口的状态（开启/关闭）。

选项

  • "present" ← (默认)

  • "absent"

subinterfaces

列表 / 元素=字符串

在 purestorage.flasharray 1.22.0 中添加

要添加到 VIF 接口的一个或多个子设备的列表

只需要提供“eth”名称，例如“eth6”。所有控制器的此接口都将分配给该接口。

subnet

字符串

在 purestorage.flasharray 1.22.0 中添加

要附加接口的子网名称

subordinates

列表 / 元素=字符串

在 purestorage.flasharray 1.22.0 中添加

要添加到 LACP 接口的一个或多个子设备的列表

下级设备必须位于同一控制器上，因此需要提供完整的设备。

备注

注意

  • 此模块需要 purestorage 和 py-pure-client Python 库

  • 特定模块可能需要其他 Python 库。

  • 如果 *fa_url* 和 *api_token* 参数未直接传递到模块，则必须设置 PUREFA_URL 和 PUREFA_API 环境变量

示例

- name: Configure and enable network interface ct0.eth8
  purestorage.flasharray.purefa_network:
    name: ct0.eth8
    gateway: 10.21.200.1
    address: "10.21.200.18/24"
    mtu: 9000
    state: present
    fa_url: 10.10.10.2
    api_token: c6033033-fe69-2515-a9e8-966bb7fe4b40

- name: Disable physical interface ct1.eth2
  purestorage.flasharray.purefa_network:
    name: ct1.eth2
    state: absent
    fa_url: 10.10.10.2
    api_token: c6033033-fe69-2515-a9e8-966bb7fe4b40

- name: Enable virtual network interface vir0
  purestorage.flasharray.purefa_network:
    name: vir0
    state: present
    fa_url: 10.10.10.2
    api_token: c6033033-fe69-2515-a9e8-966bb7fe4b40

- name: Remove an IP address from iSCSI interface ct0.eth4
  purestorage.flasharray.purefa_network:
    name: ct0.eth4
    address: 0.0.0.0/0
    gateway: 0.0.0.0
    fa_url: 10.10.10.2
    api_token: c6033033-fe69-2515-a9e8-966bb7fe4b40

- name: Change service list for FC interface ct0.fc1
  purestorage.flasharray.purefa_network:
    name: ct0.fc1
    servicelist:
      - replication
    fa_url: 10.10.10.2
    api_token: c6033033-fe69-2515-a9e8-966bb7fe4b40

作者

  • Pure Storage Ansible 团队 (@sdodsley)