community.general.solaris_zone module – Manage Solaris zones
Note
This module is part of the community.general collection (version 8.6.4).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install community.general
.
You need further requirements to be able to use this module,
see Requirements for details.
To use it in a playbook, specify: community.general.solaris_zone
.
Synopsis
Create, start, stop and delete Solaris zones.
This module does not currently allow changing of options for a zone that is already been created.
Aliases: system.solaris_zone
Requirements
The below requirements are needed on the host that executes this module.
Solaris 10 or 11
Parameters
Parameter |
Comments |
---|---|
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) Default: |
|
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” Default: |
|
Extra options to the zonecfg(1M) create command. Default: |
|
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” Default: |
|
Zone name. A zone name must be unique name. A zone name must begin with an alphanumeric character. The name can contain alphanumeric characters, underscores The name cannot be longer than 64 characters. |
|
The path where the zone will be created. This is required when the zone is created, but not used otherwise. |
|
The password hash for the root account. If not specified, the zone’s root account will not have a password. |
|
Whether to create a sparse ( Choices:
|
|
Choices:
|
|
Timeout, in seconds, for zone to boot. Default: |
Attributes
Attribute |
Support |
Description |
---|---|---|
Support: full |
Can run in |
|
Support: none |
Will return details on what has changed (or possibly needs changing in |
Examples
- 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