New in version 2.0.
The below requirements are needed on the host that executes this module.
Parameter | Choices/Defaults | Comments |
---|---|---|
attach_options | Default: empty string | Extra options to the zoneadm attach command. For example, this can be used to specify whether a minimum or full update of packages is required and if any packages need to be deleted. For valid values, see zoneadm(1M) |
config | Default: empty string | The zonecfg configuration commands for this zone. See zonecfg(1M) for the valid options and syntax. Typically this is a list of options separated by semi-colons or new lines, e.g. "set auto-boot=true;add net;set physical=bge0;set address=10.1.1.1;end" |
create_options | Default: empty string | Extra options to the zonecfg(1M) create command. |
install_options | Default: empty string | Extra options to the zoneadm(1M) install command. To automate Solaris 11 zone creation, use this to specify the profile XML file, e.g. install_options="-c sc_profile.xml" |
name required | Zone name. | |
path | The path where the zone will be created. This is required when the zone is created, but not used otherwise. | |
root_password | The password hash for the root account. If not specified, the zone's root account will not have a password. | |
sparse bool |
| Whether to create a sparse ( true ) or whole root (false ) zone. |
state required |
| present , configure and install the zone.installed , synonym for present .running , if the zone already exists, boot it, otherwise, configure and install the zone first, then boot it.started , synonym for running .stopped , shutdown a zone.absent , destroy the zone.configured , configure the ready so that it's to be attached.attached , attach a zone, but do not boot it.detached , shutdown and detach a zone |
timeout | Default: 600 | Timeout, in seconds, for zone to boot. |
- name: Create and install a zone, but don't boot it 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 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 solaris_zone: name: zone1 state: running - name: Stop a zone solaris_zone: name: zone1 state: stopped - name: Destroy a zone solaris_zone: name: zone1 state: absent - name: Detach a zone solaris_zone: name: zone1 state: detached - name: Configure a zone, ready to be attached 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 solaris_zone: name: zone1 state: attached attach_options: -u
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.
For a list of other modules that are also maintained by the Ansible Community, see here.
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/solaris_zone_module.html