NOTE:

This repository is no longer updated - the work has moved to the Ansible collection ➡️ https://github.com/stackhpc/ansible-collection-openstack

OpenStack Host Aggregates

This role is used to register host aggregates in Nova using the os_nova_host_aggregate module.

Requirements

You need to have access to the OpenStack Nova API from the target host.

Role Variables

• os_host_aggregates_venv: Path to the directory where a virtual environment will be created.

• os_host_aggregates_auth_type: The type of authentication that matches the auth_type parameter of the os_* Ansible modules.

• os_host_aggregates_auth: A dictionary that includes authentication details compatible with the auth parameter of the os_* Ansible modules.

• os_host_aggregates_cacert: An optional path to a CA certificate bundle.

• os_host_aggregates_interface: The type of endpoint URL for fetching from the service catalog. It can be public, admin, or internal.

• os_host_aggregates: A list of Nova host aggregates to register. Each item should be a dictionary containing the 'name', and optionally:

  • 'availability_zone' (the name of the availability zone for the aggregate)
  • 'hosts' (a list of hostnames to include in the aggregate)
  • 'metadata' (a dictionary of key/value pairs for the aggregate)

Dependencies

This role relies on the stackhpc.os_openstacksdk role.

Example Playbook

Here's an example playbook that registers a Nova host aggregate:

---
- name: Ensure Nova host aggregates are registered
  hosts: nova-api
  roles:
    - role: stackhpc.os_host_aggregates
      os_host_aggregates_venv: "~/os-host-aggregates-venv"
      os_host_aggregates_auth_type: "password"
      os_host_aggregates_auth:
        project_name: <keystone project>
        username: <keystone user>
        password: <keystone password>
        auth_url: <keystone auth URL>
      os_host_aggregates:
        - name: db_aggregate
          availability_zone: az1
          hosts:
            - host1
            - host2
          metadata:
            type: dbcluster

Author Information

• Pierre Riteau (pierre@stackhpc.com)