ansible.builtin.solaris_zone (v2.5.6) — module

Install Ansible via pip

Install with pip install ansible==2.5.6

Description

Create, start, stop and delete Solaris zones. This module doesn't currently allow changing of options for a zone that's already been created.

Requirements

• Solaris 10 or 11

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- 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'

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- 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'

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

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

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Stop a zone
  solaris_zone:
    name: zone1
    state: stopped

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Destroy a zone
  solaris_zone:
    name: zone1
    state: absent

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Detach a zone
  solaris_zone:
    name: zone1
    state: detached

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- 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'

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Attach zone1
  solaris_zone:
    name: zone1
    state: attached
    attach_options: -u

Inputs

    
name:
    description:
    - Zone name.
    required: true

path:
    description:
    - The path where the zone will be created. This is required when the zone is created,
      but not used otherwise.

state:
    choices:
    - absent
    - attached
    - configured
    - detached
    - installed
    - present
    - running
    - started
    - stopped
    default: present
    description:
    - C(present), configure and install the zone.
    - C(installed), synonym for C(present).
    - C(running), if the zone already exists, boot it, otherwise, configure and install
      the zone first, then boot it.
    - C(started), synonym for C(running).
    - C(stopped), shutdown a zone.
    - C(absent), destroy the zone.
    - C(configured), configure the ready so that it's to be attached.
    - C(attached), attach a zone, but do not boot it.
    - C(detached), shutdown and detach a zone
    required: true

config:
    default: empty string
    description:
    - 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"

sparse:
    default: 'no'
    description:
    - Whether to create a sparse (C(true)) or whole root (C(false)) zone.
    type: bool

timeout:
    default: 600
    description:
    - Timeout, in seconds, for zone to boot.

root_password:
    description:
    - The password hash for the root account. If not specified, the zone's root account
      will not have a password.

attach_options:
    default: empty string
    description:
    - 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)

create_options:
    default: empty string
    description:
    - Extra options to the zonecfg(1M) create command.

install_options:
    default: empty string
    description:
    - 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"