CLI Options

discover-tempest-config

usage: discover-tempest-config [-h] [--os-cloud <name>]
                               [--os-auth-type <name>]
                               [--os-auth-url OS_AUTH_URL]
                               [--os-system-scope OS_SYSTEM_SCOPE]
                               [--os-domain-id OS_DOMAIN_ID]
                               [--os-domain-name OS_DOMAIN_NAME]
                               [--os-project-id OS_PROJECT_ID]
                               [--os-project-name OS_PROJECT_NAME]
                               [--os-project-domain-id OS_PROJECT_DOMAIN_ID]
                               [--os-project-domain-name OS_PROJECT_DOMAIN_NAME]
                               [--os-trust-id OS_TRUST_ID]
                               [--os-default-domain-id OS_DEFAULT_DOMAIN_ID]
                               [--os-default-domain-name OS_DEFAULT_DOMAIN_NAME]
                               [--os-user-id OS_USER_ID]
                               [--os-username OS_USERNAME]
                               [--os-user-domain-id OS_USER_DOMAIN_ID]
                               [--os-user-domain-name OS_USER_DOMAIN_NAME]
                               [--os-password OS_PASSWORD] [--insecure]
                               [--os-cacert <ca-certificate>]
                               [--os-cert <certificate>] [--os-key <key>]
                               [--timeout <seconds>] [--collect-timing]
                               [--os-service-type <name>]
                               [--os-service-name <name>]
                               [--os-interface <name>]
                               [--os-region-name <name>]
                               [--os-endpoint-override <name>]
                               [--os-api-version <name>] [--create]
                               [--out OUT] [--deployer-input DEPLOYER_INPUT]
                               [--no-default-deployer] [--debug] [--verbose]
                               [--no-rng] [--non-admin] [--test-accounts PATH]
                               [--create-accounts-file PATH] [--profile PATH]
                               [--generate-profile PATH]
                               [--image-disk-format IMAGE_DISK_FORMAT]
                               [--image IMAGE]
                               [--flavor-min-mem FLAVOR_MIN_MEM]
                               [--flavor-min-disk FLAVOR_MIN_DISK]
                               [--convert-to-raw] [--network-id NETWORK_ID]
                               [--append SECTION.KEY=VALUE[,VALUE]]
                               [--remove SECTION.KEY=VALUE[,VALUE]]
                               [overrides [overrides ...]]

Positional Arguments

overrides
Override options

Key value pairs used to hardcode values in tempest.conf. The key is a section.key where section is a section header in the conf file. For example:

$ discover-tempest-config

identity.username myname identity.password mypass

Default: []

Named Arguments

--os-cloud

Named cloud to connect to

--os-auth-type, --os-auth-plugin

Authentication type to use

Default: “password”

--create
Create Tempest resources

Make python-tempestconf to create Tempest resources such as flavors needed for running Tempest tests.

Default: False

--out
Output file

A name of the file where the discovered Tempest configuration will be written to.

Default: “etc/tempest.conf”

--deployer-input
Path to deployer file

A file in the format of tempest.conf that will override the default values. It is usually created by an installer and contains environment specific options.

The deployer-input file is an alternative to providing key/value pairs. If there are also key/value pairs they will be applied after the deployer-input file.

If the option is not defined and –no-default-deployer is not used, python-tempestconf will try to look for the file in $HOME/tempest-deployer-input.conf location.

--no-default-deployer
Do not check for the default deployer input in

$HOME/tempest-deployer-input.conf

Default: False

--debug

Print debugging information.

Default: False

--verbose, -v

Print more information about the execution.

Default: False

--no-rng
Create new flavors and upload images without

random number generator device.

Default: False

--non-admin
Simulate non-admin credentials.

When True, the credentials are used as non-admin ones. No resources are created.

Default: False

--test-accounts
Tempest accounts.yaml file

Defines a path to a Tempest accounts.yaml file. For example:

–test-accounts $HOME/tempest/accounts.yaml

--create-accounts-file
Generate Tempest accounts file

Minimal accounts file will be created in the specified path. For example:

–create-accounts-file $HOME/accounts.yaml

--profile
python-tempestconf’s profile.yaml file

A file which contains definition of python-tempestconf’s arguments. NOTE: If this argument is used, other arguments cannot be defined!

--generate-profile
Generate a sample profile.yaml file.

A sample profile.yaml will be generated in the specified path. After that python-tempestconf ends. For example:

–generate-profile $HOME/profile.yaml

--image-disk-format
A format of an image to be uploaded to glance.

Default is ‘qcow2’

Default: “qcow2”

--image
An image name/path/url to be uploaded to

glance if it’s not already there. The name of the image is the leaf name of the path. Default is ‘https://download.cirros-cloud.net/0.4.0/cirros-0.4.0-x86_64-disk.img

Default: “https://download.cirros-cloud.net/0.4.0/cirros-0.4.0-x86_64-disk.img

--flavor-min-mem
Specify minimum memory for new

flavours, default is ‘64’.

Default: 64

--flavor-min-disk
Specify minimum disk size for new

flavours, default is ‘1’.

Default: 1

--convert-to-raw
Convert images to raw format before uploading

to glance.

Default: False

--network-id
Specify which network with external connectivity

should be used by the tests.

--append
Append values to tempest.conf

Key value pair to be appended to the configuration file. NOTE: Multiple values are supposed to be divided by a COLON only, WITHOUT spaces. For example:

$ discover-tempest-config

–append features.ext=tag[,tag-ext] –append section.ext=ext[,another-ext]

Default: []

--remove
Remove values from tempest.conf

Key value pair to be removed from the configuration file. NOTE: Multiple values are supposed to be divided by a COLON only, WITHOUT spaces. For example:

$ discover-tempest-config

–remove identity.username=myname –remove feature-enabled.api_ext=http[,https]

Default: []

Authentication Options

Options specific to the password plugin.

--os-auth-url

Authentication URL

--os-system-scope

Scope for system operations

--os-domain-id

Domain ID to scope to

--os-domain-name

Domain name to scope to

--os-project-id, --os-tenant-id

Project ID to scope to

--os-project-name, --os-tenant-name

Project name to scope to

--os-project-domain-id

Domain ID containing project

--os-project-domain-name

Domain name containing project

--os-trust-id

Trust ID

--os-default-domain-id

Optional domain ID to use with v3 and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication.

--os-default-domain-name

Optional domain name to use with v3 API and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication.

--os-user-id

User id

--os-username, --os-user-name

Username

--os-user-domain-id

User’s domain id

--os-user-domain-name

User’s domain name

--os-password

User’s password

API Connection Options

Options controlling the HTTP API Connections

--insecure

Explicitly allow client to perform “insecure” TLS (https) requests. The server’s certificate will not be verified against any certificate authorities. This option should be used with caution.

Default: False

--os-cacert

Specify a CA bundle file to use in verifying a TLS (https) server certificate. Defaults to env[OS_CACERT].

--os-cert

Defaults to env[OS_CERT].

--os-key

Defaults to env[OS_KEY].

--timeout

Set request timeout (in seconds).

Default: 600

--collect-timing

Collect per-API call timing information.

Default: False

Service Options

Options controlling the specialization of the API Connection from information found in the catalog

--os-service-type

Service type to request from the catalog

--os-service-name

Service name to request from the catalog

--os-interface

API Interface to use [public, internal, admin]

Default: “public”

--os-region-name

Region of the cloud to use

--os-endpoint-override

Endpoint to use instead of the endpoint in the catalog

--os-api-version

Which version of the service API to use