ngine_io.cloudstack.cs_vpn_gateway 模块 – 管理基于 Apache CloudStack 云的站点到站点 VPN 网关。

注意

此模块是 ngine_io.cloudstack 集合 (版本 2.5.0) 的一部分。

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

要安装它,请使用: ansible-galaxy collection install ngine_io.cloudstack。您需要其他要求才能使用此模块,请参阅 要求 获取详细信息。

要在 playbook 中使用它,请指定: ngine_io.cloudstack.cs_vpn_gateway

ngine_io.cloudstack 0.1.0 中的新增功能

概要

  • 创建和删除站点到站点 VPN 网关。

要求

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

  • python >= 2.6

  • cs >= 0.9.0

参数

参数

注释

account

字符串

VPN 网关相关的账户。

api_http_method

字符串

用于查询 API 端点的 HTTP 方法。

如果未给出,则考虑 CLOUDSTACK_METHOD 环境变量。

选项

  • "get" ← (默认)

  • "post"

api_key

字符串 / 必需

CloudStack API 的 API 密钥。

如果未给出,则考虑 CLOUDSTACK_KEY 环境变量。

api_secret

字符串 / 必需

CloudStack API 的密钥。

如果未设置,则考虑 CLOUDSTACK_SECRET 环境变量。

api_timeout

整数

HTTP 超时时间(秒)。

如果未给出,则考虑 CLOUDSTACK_TIMEOUT 环境变量。

默认值: 10

api_url

字符串 / 必需

CloudStack API 的 URL,例如 https://cloud.example.com/client/api

如果未给出,则考虑 CLOUDSTACK_ENDPOINT 环境变量。

api_verify_ssl_cert

字符串

验证 CA 授权证书文件。

如果未给出,则考虑 CLOUDSTACK_VERIFY 环境变量。

domain

字符串

VPN 网关相关的域。

poll_async

布尔值

轮询异步作业,直到作业完成。

选项

  • false

  • true ← (默认)

project

字符串

VPN 网关相关的项目的名称。

state

字符串

VPN 网关的状态。

选项

  • "present" ← (默认)

  • "absent"

validate_certs

布尔值

ngine_io.cloudstack 2.4.0 中新增

如果 false,则不会验证 SSL 证书。

如果未给出,则考虑 CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY 环境变量。

这仅应在使用自签名证书的个人控制站点上使用。

选项

  • false

  • true ← (默认)

vpc

字符串 / 必需

VPC 的名称。

zone

字符串 / 必需

VPC 相关的区域的名称。

备注

注意

  • 有关 cloudstack 模块的详细指南,请参见 CloudStack 云指南

  • 此模块支持检查模式。

示例

- name: Ensure a vpn gateway is present
  ngine_io.cloudstack.cs_vpn_gateway:
    vpc: my VPC
    zone: zone01

- name: Ensure a vpn gateway is absent
  ngine_io.cloudstack.cs_vpn_gateway:
    vpc: my VPC
    zone: zone01
    state: absent

返回值

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

描述

account

字符串

VPN 站点到站点网关相关的账户。

返回值: 成功

示例: "example account"

domain

字符串

VPN 站点到站点网关相关的域。

返回值: 成功

示例: "example domain"

id

字符串

VPN 站点到站点网关的 UUID。

返回值: 成功

示例: "04589590-ac63-4ffc-93f5-b698b8ac38b6"

project

字符串

VPN 站点到站点网关相关的项目的名称。

返回值: 成功

示例: "Production"

public_ip

字符串

VPN 站点到站点网关的 IP 地址。

返回值: 成功

示例: "10.100.212.10"

vpc

字符串

VPC 的名称。

返回值: 成功

示例: "My VPC"

作者

  • René Moser (@resmo)