community.general.solaris_zone 模块 – 管理 Solaris 区域

注意

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

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

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

要在 playbook 中使用它，请指定：community.general.solaris_zone。

概要 

创建、启动、停止和删除 Solaris 区域。
此模块目前不允许更改已创建区域的选项。

要求 

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

Solaris 10 或 11

参数 

参数	注释
attach_options 字符串	zoneadm attach 命令的额外选项。例如，这可以用来指定是否需要最小或完整的包更新以及是否需要删除任何包。有关有效值，请参见 zoneadm(1M) 默认值： `""`
config 字符串	此区域的 zonecfg 配置命令。有关有效选项和语法，请参见 zonecfg(1M)。通常，这是一个由分号或换行符分隔的选项列表，例如：“set auto-boot=true;add net;set physical=bge0;set address=10.1.1.1;end” 默认值： `""`
create_options 字符串	zonecfg(1M) create 命令的额外选项。默认值： `""`
install_options 字符串	zoneadm(1M) install 命令的额外选项。要自动化 Solaris 11 区域创建，请使用此选项指定配置文件 XML 文件，例如 install_options=”-c sc_profile.xml” 默认值： `""`
name 字符串 / 必需	区域名称。区域名称必须是唯一的。区域名称必须以字母数字字符开头。名称可以包含字母数字字符、下划线 `_`、连字符 `-` 和句点 `.`。名称长度不能超过 64 个字符。
path 字符串	将创建区域的路径。创建区域时需要此参数，否则不使用。
root_password 字符串	root 帐户的密码哈希。如果未指定，则区域的 root 帐户将没有密码。
sparse 布尔值	是否创建稀疏 (`true`) 或完整根 (`false`) 区域。选项 `false` ← (默认) `true`
state 字符串	`present`，配置和安装区域。 `installed`，`present` 的同义词。 `running`，如果区域已存在，则启动它；否则，先配置和安装区域，然后启动它。 `started`，`running` 的同义词。 `stopped`，关闭区域。 `absent`，销毁区域。 `configured`，配置就绪状态以便附加。 `attached`，附加区域，但不启动它。 `detached`，关闭并分离区域选项 `"absent"` `"attached"` `"configured"` `"detached"` `"installed"` `"present"` ← (默认) `"running"` `"started"` `"stopped"`
timeout 整数	区域启动的超时时间（秒）。默认值： `600`

属性 

属性	支持	描述
check_mode	支持：完全支持	可以在 `check_mode` 下运行，并在不修改目标的情况下返回更改状态预测。
diff_mode	支持：无	在差异模式下，将返回关于已更改内容（或可能需要在`check_mode`中更改的内容）的详细信息。

示例 

- name: Create and install a zone, but don't boot it
  community.general.solaris_zone:
    name: zone1
    state: present
    path: /zones/zone1
    sparse: true
    root_password: Be9oX7OSwWoU.
    config: 'set autoboot=true; add net; set physical=bge0; set address=10.1.1.1; end'

- name: Create and install a zone and boot it
  community.general.solaris_zone:
    name: zone1
    state: running
    path: /zones/zone1
    root_password: Be9oX7OSwWoU.
    config: 'set autoboot=true; add net; set physical=bge0; set address=10.1.1.1; end'

- name: Boot an already installed zone
  community.general.solaris_zone:
    name: zone1
    state: running

- name: Stop a zone
  community.general.solaris_zone:
    name: zone1
    state: stopped

- name: Destroy a zone
  community.general.solaris_zone:
    name: zone1
    state: absent

- name: Detach a zone
  community.general.solaris_zone:
    name: zone1
    state: detached

- name: Configure a zone, ready to be attached
  community.general.solaris_zone:
    name: zone1
    state: configured
    path: /zones/zone1
    root_password: Be9oX7OSwWoU.
    config: 'set autoboot=true; add net; set physical=bge0; set address=10.1.1.1; end'

- name: Attach zone1
  community.general.solaris_zone:
    name: zone1
    state: attached
    attach_options: -u

作者

Paul Markham (@pmarkham)