CLI Options

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 ‘http://download.cirros-cloud.net/0.3.5/cirros-0.3.5-x86_64-disk.img

Default: “http://download.cirros-cloud.net/0.3.5/cirros-0.3.5-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

Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.