community.general.one_host 模块 – 管理 OpenNebula 主机

注意

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

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

要安装它，请使用： ansible-galaxy collection install community.general。您需要其他要求才能使用此模块，请参阅要求以了解详细信息。

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

概要 

管理 OpenNebula 主机

要求 

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

pyone

参数 

参数	注释
api_password 别名：api_token 字符串	用于 XMLRPC 身份验证的密码或令牌。如果未指定，则使用 `ONE_PASSWORD` 环境变量的值（如果有）。
api_url 别名：api_endpoint 字符串	XMLRPC 服务器的 ENDPOINT URL。如果未指定，则使用 `ONE_URL` 环境变量的值（如果有）。
api_username 字符串	用于 XMLRPC 身份验证的用户名。如果未指定，则使用 `ONE_USERNAME` 环境变量的值（如果有）。
cluster_id 整数	集群 ID。默认值： `0`
cluster_name 字符串	按名称指定的集群。
im_mad_name 字符串	信息管理器的名称，这些值取自 oned.conf，标签名称为 IM_MAD (name) 默认值： `"kvm"`
labels 列表 / 元素=字符串	此主机的标签。
name 字符串 / 必需	要管理的计算机的主机名。
state 字符串	将主机置于所需生命周期状态。如果 `absent`，则主机将从集群中删除。如果 `present`，则主机将在集群中创建（包括 `enabled`、`disabled` 和 `offline` 状态）。如果 `enabled`，则主机完全可操作。 `disabled`，例如执行维护操作。 `offline`，主机完全脱机。选择 `"absent"` `"present"` ← (默认) `"enabled"` `"disabled"` `"offline"`
template 别名：attributes 字典	要合并到主机模板中的模板或属性更改。
validate_certs 布尔值	是否验证 TLS/SSL 证书。如果使用 `PYTHONHTTPSVERIFY` 环境变量，则忽略此参数。选择 `false` `true` ← (默认)
vmm_mad_name 字符串	虚拟机管理器 MAD 名称，此值取自 oned.conf 中标签为 VM_MAD (name) 的配置。默认值： `"kvm"`
wait_timeout 整数	等待达到期望状态的超时时间，以秒为单位。默认值： `300`

属性 

属性	支持	描述
check_mode	支持：无	可以在 `check_mode` 中运行，并返回更改状态预测，而不会修改目标。
diff_mode	支持：无	当处于 diff 模式时，将返回已更改的内容的详细信息（或可能需要在 `check_mode` 中更改的内容）。

示例 

- name: Create a new host in OpenNebula
  community.general.one_host:
    name: host1
    cluster_id: 1
    api_url: http://127.0.0.1:2633/RPC2

- name: Create a host and adjust its template
  community.general.one_host:
    name: host2
    cluster_name: default
    template:
        LABELS:
            - gold
            - ssd
        RESERVED_CPU: -100

作者

Rafael del Valle (@rvalle)