ansible-role-openstack-certification

An Ansible role to automate the certification process.

Pre-requisites

In order to fully understand the content of this ansible role, one needs to be familiar with the following documentation.

In the above article, the certification workflow and terminology is explained in details.

Role Variables

Variable name	Required	Default	Type	Description
openstack_certification_output_format	False	text	String	Output format for rhcert-ci print. (values: text, junit, html)
openstack_certification_results_download	False	No	Bool	Enable downloading the results file (/var/rhcert/results.xml).
openstack_certification_output_filename	False	cert.txt	String	Output filename for rhcert-ci print
openstack_certification_test_type	False	test	String	Type of suite of tests to run. (values: test, tag, program)
openstack_certification_tests	False	self_check,supportable,director	Array	List of tests to run.
openstack_certification_tags	False	[]	Array	List of tags to run.
openstack_certification_programs	False	[]	Array	List of programs to run.
openstack_certification_supported_apis_and_extensions	False	N/A	Array	List of supported APIs and extensions.
openstack_certification_enable_rhsm_repo	False	Yes	Bool	When No/False, RHSM registration will be omitted.
openstack_certification_repo_file	False	N/A	String	Path to a repo file, which will be copied to the host.
openstack_certification_uc_tempest_conf	True	N/A	String	Path to a tempest configuration file on undercloud node.
openstack_certification_overcloud_node_ip	False	""	String	IP address of a controller/compute node for director test.
openstack_certification_baremetal_driver	False	pxe_ipmitool	String	Ironic driver used for the certification.
openstack_certification_uc_instackenv	False	/home/stack/instackenv.json	String	Path to the instackenv.json file on undercloud.
openstack_certification_uc_stackrc	False	/home/stack/stackrc	String	Path to the undercloud rc file on undercloud.
openstack_certification_uc_overcloudrc	True	/home/stack/overcloudrc	String	Path to the overcloud rc file on undercloud.
openstack_certification_container_names	False	[]	Array	List of container images for trusted_container test.

Variables details

Supported Tests

Available options for openstack_certification_tests are :

self_check
supportable
director
tempest_config
sahara
cinder_consistency_groups
cinder_volumes
manila_share_extend
manila_share_managed
manila_share_shrink
manila_shares
manila_snapshot_managed
manila_snapshot_mountable
manila_snapshot_revert_to_snapshot
manila_snapshot_share_from_snapshot
manila_snapshots
neutron_address_scope
neutron_agents
neutron_attribute_extensions
neutron_availability_zones
neutron_dhcp_extra
neutron_flavor
neutron_gateway_extra
neutron_gman
neutron_ip_availability
neutron_ipv4
neutron_ipv6
neutron_l2_multi_provider
neutron_l3_extra_route
neutron_l3_flavors
neutron_l3_ha
neutron_lbaasv2
neutron_metering
neutron_mtu
neutron_qos
neutron_rbac
neutron_security_groups
neutron_service_types
neutron_subnet_allocation
neutron_subnet_default_pool
neutron_tags
neutron_trunk
baremetal
trusted_container

Supported Tags

Available options for openstack_certification_tags are :

osqa
portable
certification
realtime
manila
network
virtualization
wlan
cinder
usb
neutron
baremetal

Supported Programs

Available options for openstack_certification_programs are :

baremetal
cloud
container
hardware
openstack
software

Supported APIs and extensions:

Available options for openstack_certification_supported_apis_and_extensions are :

qos
clone
snapshots
volume_types
quota-set-extension
backups
multiple-backends
availability
image_metadata
consistencygroups
volume_transfers
extensions
volumes
user_messages
load_balancer
subnets
agent_management
qos
provider_networks
lbaas_listeners
service_type_management
lbaas_agent_scheduler
fwaas
metering
extra_dhcp_options
quotas
dhcp_agent_scheduler
port_security
trunk
lbaas_pools
load_balancers
networks
security_groups
revisions
subnetpools
flavors_extensions
l3_agent_scheduler
lbaas_members
versions
floating_ips
address_scopes
bgp
allowed_address_pair
routers
extensions
vpnaas
ports
lbaas_health_monitor
cluster-templates
jobs
job-binaries
job-binary-internals
node-group-templates
data-sources
plugins

Example

To run the role from the repository:

$ git clone https://github.com/redhat-cip/ansible-role-openstack-certification.git
$ cd ansible-role-openstack-certification
$ mkdir roles && ln -s $(pwd) roles/openstack-certification

Then set required variables in the playbook.yaml and define hosts file:

$ cat hosts
[controller]
<IP> ansible_user=<user>

[compute]
<IP> ansible_user=<user>

[undercloud]
<IP> ansible_user=<user>

And run it:

$ ansible-playbook playbook.yaml -i hosts

If you have more groups defined in your hosts file, you can limit groups which the tests are supposed to be executed on by:

$ ansible-playbook playbook.yaml -i hosts -l controller,compute

or replace all in playbook.yaml by list of the groups, for example:

hosts:
  - compute
  - controller

Usage with InfraRed

Run the following steps to execute the role by infrared:

Install infrared and add ansible-role-openstack-certification plugin by providing the url to this repo:

(infrared)$ ir plugin add https://github.com/redhat-cip/ansible-role-openstack-certification.git --src-path infrared_plugin

You can verify that the plugin is imported by:
```
(infrared)$ ir plugin list
```

From infrared directory symlink roles path:

$ ln -s $(pwd)/plugins $(pwd)/plugins/ansible-role-openstack-certification/infrared_plugin/roles

Copy group_vars to infrared workspace:

$ cp -r plugins/ansible-role-openstack-certification/group_vars/ .workspaces/active/

If you want to change the test set for a node, just modify group_vars as needed.

Run the plugin:

(infrared)$ ir ansible-role-openstack-certification

License

Apache 2.0

Author Information

Distributed-CI Team distributed-ci@redhat.com

kopecmartin / ansible-role-openstack-certification