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] [--retry-image]
                               [--flavor-min-mem FLAVOR_MIN_MEM]
                               [--flavor-min-disk FLAVOR_MIN_DISK]
                               [--convert-to-raw] [--network-id NETWORK_ID]
                               [--network NETWORK]
                               [--append SECTION.KEY=VALUE[,VALUE]]
                               [--remove SECTION.KEY=VALUE[,VALUE]]
                               [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.6.2/cirros-0.6.2-x86_64-disk.img’

Default: 'https://download.cirros-cloud.net/0.6.2/cirros-0.6.2-x86_64-disk.img'

--retry-image

Allow tempestconf to retry download an image,: in case of failure, from these urls: ‘[’https://download.cirros-cloud.net/0.6.2/cirros-0.6.2-x86_64-disk.img’, ‘http://images.rdoproject.org/cirros/cirros-0.6.2-x86_64-disk.img’]’

Default: False

--flavor-min-mem

Specify minimum memory for new: flavours, default is ‘128’.

Default: 128

--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.

--network

Specify which network (id/name) 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: ID of the trust to use as a trustee use
--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

The location for the keystore (PEM formatted) containing the public key of this client. Defaults to env[OS_CERT].

--os-key

The location for the keystore (PEM formatted) containing the private key of this client. 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

CLI Options

CLI Options¶

discover-tempest-config¶

Positional Arguments¶

Named Arguments¶

Authentication Options¶

API Connection Options¶

Service Options¶

python-tempestconf 3.5.1.dev3

Page Contents