Validation Resources

The validation_resources module

class ValidationResourcesFixture(clients, keypair=False, floating_ip=False, security_group=False, security_group_rules=False, ethertype='IPv4', use_neutron=True, floating_network_id=None, floating_network_name=None)[source]

Fixture to provision and cleanup validation resources

clear_validation_resources(clients, keypair=None, floating_ip=None, security_group=None, use_neutron=True)[source]

Cleanup resources for VM ping/ssh testing

Cleanup a set of resources provisioned via create_validation_resources. In case of errors during cleanup, the exception is logged and the cleanup process is continued. The first exception that was raised is re-raised after the cleanup is complete.

Parameters
  • clients – Instance of tempest.lib.services.clients.ServiceClients or of a subclass of it. Resources are provisioned using clients from clients.

  • keypair – A dictionary with the keypair to be deleted. Defaults to None.

  • floating_ip – A dictionary with the floating_ip to be deleted. Defaults to None.

  • security_group – A dictionary with the security_group to be deleted. Defaults to None.

  • use_neutron – When True resources are provisioned via neutron, when False resources are provisioned via nova.

Examples:

from tempest.common import validation_resources as vr
from tempest.lib import auth
from tempest.lib.services import clients

creds = auth.get_credentials('http://mycloud/identity/v3',
                             username='me', project_name='me',
                             password='secret', domain_name='Default')
osclients = clients.ServiceClients(creds, 'http://mycloud/identity/v3')
# Request keypair and floating IP
resources = dict(keypair=True, security_group=False,
                 security_group_rules=False, floating_ip=True)
resources = vr.create_validation_resources(
    osclients, validation_resources=resources, use_neutron=True,
    floating_network_id='4240E68E-23DA-4C82-AC34-9FEFAA24521C')

# Now cleanup the resources
try:
    vr.clear_validation_resources(osclients, use_neutron=True,
                                  **resources)
except Exception as e:
    LOG.exception('Something went wrong during cleanup, ignoring')
create_ssh_security_group(clients, add_rule=False, ethertype='IPv4', use_neutron=True)[source]

Create a security group for ping/ssh testing

Create a security group to be attached to a VM using the nova or neutron clients. If rules are added, the group can be attached to a VM to enable connectivity validation over ICMP and further testing over SSH.

Parameters
  • clients – Instance of tempest.lib.services.clients.ServiceClients or of a subclass of it. Resources are provisioned using clients from clients.

  • add_rule – Whether security group rules are provisioned or not. Defaults to False.

  • ethertype – ‘IPv4’ or ‘IPv6’. Honoured only in case neutron is used.

  • use_neutron – When True resources are provisioned via neutron, when False resources are provisioned via nova.

Returns

A dictionary with the security group as returned by the API.

Examples:

from tempest.common import validation_resources as vr
from tempest.lib import auth
from tempest.lib.services import clients

creds = auth.get_credentials('http://mycloud/identity/v3',
                             username='me', project_name='me',
                             password='secret', domain_name='Default')
osclients = clients.ServiceClients(creds, 'http://mycloud/identity/v3')
# Security group for IPv4 tests
sg4 = vr.create_ssh_security_group(osclients, add_rule=True)
# Security group for IPv6 tests
sg6 = vr.create_ssh_security_group(osclients, ethertype='IPv6',
                                   add_rule=True)
create_validation_resources(clients, keypair=False, floating_ip=False, security_group=False, security_group_rules=False, ethertype='IPv4', use_neutron=True, floating_network_id=None, floating_network_name=None)[source]

Provision resources for VM ping/ssh testing

Create resources required to be able to ping / ssh a virtual machine: keypair, security group, security group rules and a floating IP. Which of those resources are required may depend on the cloud setup and on the specific test and it can be controlled via the corresponding arguments.

Provisioned resources are returned in a dictionary.

Parameters
  • clients – Instance of tempest.lib.services.clients.ServiceClients or of a subclass of it. Resources are provisioned using clients from clients.

  • keypair – Whether to provision a keypair. Defaults to False.

  • floating_ip – Whether to provision a floating IP. Defaults to False.

  • security_group – Whether to provision a security group. Defaults to False.

  • security_group_rules – Whether to provision security group rules. Defaults to False.

  • ethertype – ‘IPv4’ or ‘IPv6’. Honoured only in case neutron is used.

  • use_neutron – When True resources are provisioned via neutron, when False resources are provisioned via nova.

  • floating_network_id – The id of the network used to provision a floating IP. Only used if a floating IP is requested and with neutron.

  • floating_network_name – The name of the floating IP pool used to provision the floating IP. Only used if a floating IP is requested and with nova-net.

Returns

A dictionary with the resources in the format they are returned by the API. Valid keys are ‘keypair’, ‘floating_ip’ and ‘security_group’.

Examples:

from tempest.common import validation_resources as vr
from tempest.lib import auth
from tempest.lib.services import clients

creds = auth.get_credentials('http://mycloud/identity/v3',
                             username='me', project_name='me',
                             password='secret', domain_name='Default')
osclients = clients.ServiceClients(creds, 'http://mycloud/identity/v3')
# Request keypair and floating IP
resources = dict(keypair=True, security_group=False,
                 security_group_rules=False, floating_ip=True)
resources = vr.create_validation_resources(
    osclients, use_neutron=True,
    floating_network_id='4240E68E-23DA-4C82-AC34-9FEFAA24521C',
    **resources)

# The floating IP to be attached to the VM
floating_ip = resources['floating_ip']['ip']