ansible / ansible.builtin / v2.9.27 / module / beadm Manage ZFS boot environments on FreeBSD/Solaris/illumos systems. | "added in version" 2.3 of ansible.builtin" Authors: Adam Števko (@xen0l) preview | supported by communityansible.builtin.beadm (v2.9.27) — module
pip
Install with pip install ansible==2.9.27
Create, delete or activate ZFS boot environments.
Mount and unmount ZFS boot environments.
- name: Create ZFS boot environment beadm: name: upgrade-be state: present
- name: Create ZFS boot environment from existing inactive boot environment beadm: name: upgrade-be snapshot: be@old state: present
- name: Create ZFS boot environment with compression enabled and description "upgrade" beadm: name: upgrade-be options: "compression=on" description: upgrade state: present
- name: Delete ZFS boot environment beadm: name: old-be state: absent
- name: Mount ZFS boot environment on /tmp/be beadm: name: BE mountpoint: /tmp/be state: mounted
- name: Unmount ZFS boot environment beadm: name: BE state: unmounted
- name: Activate ZFS boot environment beadm: name: upgrade-be state: activated
name: aliases: - be description: - ZFS boot environment name. required: true type: str force: default: false description: - Specifies if the unmount should be forced. type: bool state: choices: - absent - activated - mounted - present - unmounted default: present description: - Create or delete ZFS boot environment. type: str options: description: - Create the datasets for new BE with specific ZFS properties. - Multiple options can be specified. - This option is available only on Solarish platforms. type: str snapshot: description: - If specified, the new boot environment will be cloned from the given snapshot or inactive boot environment. type: str mountpoint: description: - Path where to mount the ZFS boot environment. type: path description: description: - Associate a description with a new boot environment. This option is available only on Solarish platforms. type: str
description: description: BE description returned: always sample: Upgrade from 9.0 to 10.0 type: str force: description: If forced action is wanted returned: always sample: false type: bool mountpoint: description: BE mountpoint returned: always sample: /mnt/be type: str name: description: BE name returned: always sample: pre-upgrade type: str options: description: BE additional options returned: always sample: compression=on type: str snapshot: description: ZFS snapshot to create BE from returned: always sample: rpool/ROOT/oi-hipster@fresh type: str state: description: state of the target returned: always sample: present type: str