openstack.cloud.host_aggregate – Manage OpenStack host aggregates
This plugin is part of the openstack.cloud collection (version 1.5.3).
You might already have this collection installed if you are using the
It is not included in
To check whether it is installed, run
ansible-galaxy collection list.
To install it, use:
ansible-galaxy collection install openstack.cloud.
To use it in a playbook, specify:
Create, update, or delete OpenStack host aggregates. If a aggregate with the supplied name already exists, it will be updated with the new name, new availability zone, new metadata and new list of hosts.
The below requirements are needed on the host that executes this module.
openstacksdk >= 0.12.0
python >= 3.6
The standard OpenStack environment variables, such as
OS_USERNAMEmay be used instead of providing explicit values.
Auth information is driven by openstacksdk, which means that values can come from a yaml config file in /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml or ~/.config/openstack/clouds.yaml, then from standard environment variables, then finally by explicit parameters in plays. More information can be found at https://docs.openstack.org/openstacksdk/
# Create a host aggregate - openstack.cloud.host_aggregate: cloud: mycloud state: present name: db_aggregate hosts: - host1 - host2 metadata: type: dbcluster # Add an additional host to the aggregate - openstack.cloud.host_aggregate: cloud: mycloud state: present name: db_aggregate hosts: - host3 purge_hosts: false metadata: type: dbcluster # Delete an aggregate - openstack.cloud.host_aggregate: cloud: mycloud state: absent name: db_aggregate