Chapter 82. tripleo This chapter describes the commands under the tripleo command. 82.1. tripleo config generate ansible Generate the default ansible.cfg for deployments. Usage: Table 82.1. Command arguments Value Summary --deployment-user DEPLOYMENT_USER User who executes the tripleo config generate command. Defaults to stack. --output-dir OUTPUT_DIR Directory to output ansible.cfg and ansible.log files. 82.2. tripleo container image build Build tripleo container images with tripleo-ansible. Usage: Table 82.2. Command arguments Value Summary -h, --help Show this help message and exit --authfile <authfile> Path of the authentication file. use REGISTRY_AUTH_FILE environment variable to override. (default: /root/containers/auth.json) --base <base-image> Base image name, with optional version. can be centos:8 , base name image will be centos but centos:8 will be pulled to build the base image. (default: ubi8) --config-file <config-file> Yaml config file specifying the images to build. (default: tripleo_containers.yaml) --config-path <config-path> Base configuration path. this is the base path for all container-image files. The defined containers must reside within a tcib folder that is in this path. If this option is set, the default path for <config-file> will be modified. (default: /usr/share/tripleo- common/container-images) --distro <distro> Distro name, if undefined the system will build using the host distro. (default: centos) --tcib-extras <key=val> Tcib extra variables you want to pass. they can be later used within TCIB files as conditonals. Can be passed multiple times(default: None) --exclude <container-name> Name of one container to match against the list of containers to be built to skip. Should be specified multiple times when skipping multiple containers. (default: []) --extra-config <extra-config> Apply additional options from a given configuration YAML file. This will apply to all containers built. (default: None) --namespace <registry-namespace> Container registry namespace (default: tripleomaster) --registry <registry-url> Container registry url (default: localhost) --skip-build Skip or not the build of the images (default: false) --tag <image-tag> Image tag (default: latest) --prefix <image-prefix> Image prefix. (default: openstack) --push Enable image push to a given registry. (default: False) --label <label-data> Add labels to the containers. this option can be specified multiple times. Each label is a key=value pair. --volume <volume-path> Container bind mount used when building the image. Should be specified multiple times if multiple volumes.(default: [ /etc/pki/rpm-gpg:/etc/pki/rpm- gpg:z ]) --repo-dir <repo-dir> Define a custom directory containing the repo files. This is useful when building containers from a different OS release. --work-dir <work-directory> Tripleo container builds directory, storing configs and logs for each image and its dependencies. (default: /tmp/container-builds) --rhel-modules <rhel-modules> A comma separated list of rhel modules to enable with their version. Example: mariadb:10.3,virt:8.3 . --build-timeout <build timeout in seconds> Build timeout in seconds. 82.3. tripleo container image delete Delete specified image from registry. Usage: Table 82.3. Positional arguments Value Summary <image to delete> Full url of image to be deleted in the form <fqdn>:<port>/path/to/image Table 82.4. Command arguments Value Summary -h, --help Show this help message and exit --registry-url <registry url> Url of registry images are to be listed from in the form <fqdn>:<port>. --username <username> Username for image registry. --password <password> Password for image registry. -y, --yes Skip yes/no prompt (assume yes). 82.4. tripleo container image hotfix Hotfix tripleo container images with tripleo-ansible. Usage: Table 82.5. Command arguments Value Summary -h, --help Show this help message and exit --image <images> Fully qualified reference to the source image to be modified. Can be specified multiple times (one per image) (default: []). --rpms-path <rpms-path> Path containing rpms to install (default: none). --tag <image-tag> Image hotfix tag (default: latest) 82.5. tripleo container image list List images discovered in registry. Usage: Table 82.6. Command arguments Value Summary -h, --help Show this help message and exit --registry-url <registry url> Url of registry images are to be listed from in the form <fqdn>:<port>. --username <username> Username for image registry. --password <password> Password for image registry. Table 82.7. Output formatter options Value Summary -f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} The output format, defaults to table -c COLUMN, --column COLUMN Specify the column(s) to include, can be repeated to show multiple columns --sort-column SORT_COLUMN Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated --sort-ascending Sort the column(s) in ascending order --sort-descending Sort the column(s) in descending order Table 82.8. CSV formatter options Value Summary --quote {all,minimal,none,nonnumeric} When to include quotes, defaults to nonnumeric Table 82.9. JSON formatter options Value Summary --noindent Whether to disable indenting the json Table 82.10. Table formatter options Value Summary --max-width <integer> Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --fit-width Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable --print-empty Print empty table if there is no data to show. 82.6. tripleo container image prepare default Generate a default ContainerImagePrepare parameter. Usage: Table 82.11. Command arguments Value Summary -h, --help Show this help message and exit --output-env-file <file path> File to write environment file containing default ContainerImagePrepare value. --local-push-destination Include a push_destination to trigger upload to a local registry. --enable-registry-login Use this flag to enable the flag to have systems attempt to login to a remote registry prior to pulling their containers. This flag should be used when --local-push-destination is NOT used and the target systems will have network connectivity to the remote registries. Do not use this for an overcloud that may not have network connectivity to a remote registry. 82.7. tripleo container image prepare Prepare and upload containers from a single command. Usage: Table 82.12. Command arguments Value Summary -h, --help Show this help message and exit --environment-file <file path>, -e <file path> Environment file containing the containerimageprepare parameter which specifies all prepare actions. Also, environment files specifying which services are containerized. Entries will be filtered to only contain images used by containerized services. (Can be specified more than once.) --environment-directory <HEAT ENVIRONMENT DIRECTORY> Environment file directories that are automatically added to the environment. Can be specified more than once. Files in directories are loaded in ascending sort order. --roles-file ROLES_FILE, -r ROLES_FILE Roles file, overrides the default roles_data.yaml in the t-h-t templates directory used for deployment. May be an absolute path or the path relative to the templates dir. --output-env-file <file path> File to write heat environment file which specifies all image parameters. Any existing file will be overwritten. --dry-run Do not perform any pull, modify, or push operations. The environment file will still be populated as if these operations were performed. --cleanup <full, partial, none> Cleanup behavior for local images left after upload. The default full will attempt to delete all local images. partial will leave images required for deployment on this host. none will do no cleanup. --log-file LOG_FILE Log file to be used for python logging. by default it would be logged to USDHOME/container_image_prepare.log. 82.8. tripleo container image push Push specified image to registry. Usage: Table 82.13. Positional arguments Value Summary <image to push> Container image to upload. should be in the form of <registry>/<namespace>/<name>:<tag>. If tag is not provided, then latest will be used. Table 82.14. Command arguments Value Summary -h, --help Show this help message and exit --local Use this flag if the container image is already on the current system and does not need to be pulled from a remote registry. --registry-url <registry url> Url of the destination registry in the form <fqdn>:<port>. --append-tag APPEND_TAG Tag to append to the existing tag when pushing the container. --username <username> Username for the destination image registry. --password <password> Password for the destination image registry. --source-username <source_username> Username for the source image registry. --source-password <source_password> Password for the source image registry. --dry-run Perform a dry run upload. the upload action is not performed, but the authentication process is attempted. --multi-arch Enable multi arch support for the upload. --cleanup Remove local copy of the image after uploading 82.9. tripleo container image show Show image selected from the registry. Usage: Table 82.15. Positional arguments Value Summary <image to inspect> Image to be inspected, for example: docker.io/library/centos:7 or docker://docker.io/library/centos:7 Table 82.16. Command arguments Value Summary -h, --help Show this help message and exit --username <username> Username for image registry. --password <password> Password for image registry. Table 82.17. Output formatter options Value Summary -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} The output format, defaults to json -c COLUMN, --column COLUMN Specify the column(s) to include, can be repeated to show multiple columns Table 82.18. JSON formatter options Value Summary --noindent Whether to disable indenting the json Table 82.19. Shell formatter options Value Summary --prefix PREFIX Add a prefix to all variable names Table 82.20. Table formatter options Value Summary --max-width <integer> Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --fit-width Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable --print-empty Print empty table if there is no data to show. 82.10. tripleo deploy Deploy containerized Undercloud Usage: Table 82.21. Command arguments Value Summary --templates [TEMPLATES] The directory containing the heat templates to deploy --standalone Deprecated. the --standalone argument is now deprecated. Standalone deployments can now be run without passing --standalone. --upgrade Upgrade an existing deployment. --system-upgrade System-upgrade an existing deployment. -y, --yes Skip yes/no prompt (assume yes). --stack STACK Name for the ephemeral (one-time create and forget) heat stack. --output-dir OUTPUT_DIR Directory to output state, processed heat templates, ansible deployment files. Defaults to ~/tripleo- deploy/<stack> --output-only Do not execute the ansible playbooks. by default the playbooks are saved to the output-dir and then executed. --standalone-role STANDALONE_ROLE The role to use for standalone configuration when populating the deployment actions. -t <TIMEOUT>, --timeout <TIMEOUT> Deployment timeout in minutes. -e <HEAT ENVIRONMENT FILE>, --environment-file <HEAT ENVIRONMENT FILE> Environment files to be passed to the heat stack- create or heat stack-update command. (Can be specified more than once.) --roles-file ROLES_FILE, -r ROLES_FILE Roles file, overrides the default roles_data_undercloud.yaml in the t-h-t templates directory used for deployment. May be an absolute path or the path relative to the templates dir. --networks-file NETWORKS_FILE, -n NETWORKS_FILE Roles file, overrides the default /dev/null in the t-h-t templates directory used for deployment. May be an absolute path or the path relative to the templates dir. --plan-environment-file PLAN_ENVIRONMENT_FILE, -p PLAN_ENVIRONMENT_FILE Deprecated: plan environment file, not supported --heat-api-port <HEAT_API_PORT> Heat api port to use for the installers private heat API instance. Optional. Default: 8006.) --heat-user <HEAT_USER> User to execute the non-privileged heat-all process. Defaults to the value of --deployment-user. --deployment-user DEPLOYMENT_USER User who executes the tripleo deploy command. defaults to USDSUDO_USER. If USDSUDO_USER is unset it defaults to stack. --deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER The path to python interpreter to use for the deployment actions. If not specified the python version of the openstackclient will be used. This may need to be used if deploying on a python2 host from a python3 system or vice versa. --heat-container-image <HEAT_CONTAINER_IMAGE> The container image to use when launching the heat-all process. Defaults to: registry.redhat.io/rhosp- rhel9/openstack-heat-all:17.1 --heat-native [HEAT_NATIVE] Execute the heat-all process natively on this host. This option requires that the heat-all binaries be installed locally on this machine. This option is enabled by default which means heat-all is executed on the host OS directly. --local-ip <LOCAL_IP> Local ip/cidr for undercloud traffic. required. --control-virtual-ip <CONTROL_VIRTUAL_IP> Control plane vip. this allows the undercloud installer to configure a custom VIP on the control plane. --public-virtual-ip <PUBLIC_VIRTUAL_IP> Public nw vip. this allows the undercloud installer to configure a custom VIP on the public (external) NW. --local-domain <LOCAL_DOMAIN> Local domain for standalone cloud and its api endpoints --cleanup Cleanup temporary files. using this flag will remove the temporary files used during deployment in after the command is run. --hieradata-override [HIERADATA_OVERRIDE] Path to hieradata override file. when it points to a heat env file, it is passed in t-h-t via --environment-file. When the file contains legacy instack data, it is wrapped with <role>ExtraConfig and also passed in for t-h-t as a temp file created in --output-dir. Note, instack hiera data may be not t-h-t compatible and will highly likely require a manual revision. --keep-running Keep the ephemeral heat running after the stack operation is complete. This is for debugging purposes only. The ephemeral Heat can be used by openstackclient with: OS_AUTH_TYPE=none OS_ENDPOINT=http://127.0.0.1:8006/v1/admin openstack stack list where 8006 is the port specified by --heat- api-port. --inflight-validations Activate in-flight validations during the deploy. in- flight validations provide a robust way to ensure deployed services are running right after their activation. Defaults to False. --transport TRANSPORT Transport mechanism to use for ansible.use "ssh" for multinode deployments. Use "local" for standalone deployments. Defaults to "local". --ansible-forks ANSIBLE_FORKS The number of ansible forks to use for the config- download ansible-playbook command. --disable-container-prepare Disable the container preparation actions to prevent container tags from being updated and new containers from being fetched. If you skip this but do not have the container parameters configured, the deployment action may fail. --reproduce-command Create a reproducer command with ansible commandline and all environments variables. --force-stack-update Do a virtual update of the ephemeral heat stack (it cannot take real updates). New or failed deployments always have the stack_action=CREATE. This option enforces stack_action=UPDATE. --force-stack-create Do a virtual create of the ephemeral heat stack. new or failed deployments always have the stack_action=CREATE. This option enforces stack_action=CREATE. 82.11. tripleo launch heat Launch ephemeral Heat process. Usage: Table 82.22. Command arguments Value Summary --heat-api-port <HEAT_API_PORT> Heat api port to use for the installers private heat API instance. Optional. (default: 8006) --heat-user <HEAT_USER> User to execute the non-privileged heat-all process. Defaults to current user. If the configuration files /etc/heat/heat.conf or /usr/share/heat/heat-dist.conf exist, the user must have read access to those files. This option is ignored when using --heat- type=container or --heat-type=pod (default: root) --heat-container-image <HEAT_CONTAINER_IMAGE> The container image to use when launching the heat-all process. Defaults to: localhost/tripleo/openstack- heat-all:ephemeral (default: localhost/tripleo/openstack-heat-all:ephemeral) --heat-container-api-image <HEAT_CONTAINER_API_IMAGE> The container image to use when launching the heat-api process. Only used when --heat-type=pod. Defaults to: localhost/tripleo/openstack-heat-api:ephemeral (default: localhost/tripleo/openstack-heat- api:ephemeral) --heat-container-engine-image <HEAT_CONTAINER_ENGINE_IMAGE> The container image to use when launching the heat- engine process. Only used when --heat-type=pod. Defaults to: localhost/tripleo/openstack-heat- engine:ephemeral (default: localhost/tripleo/openstack-heat-engine:ephemeral) --kill, -k Kill the running heat process (if found). (default: False) --heat-dir HEAT_DIR Directory to use for file storage and logs of the running heat process. in the current directory. Can be set to an already existing directory to reuse the environment from a previos Heat process. (default: /root/overcloud-deploy/overcloud/heat-launcher) --rm-heat If specified and --heat-type is container or pod any existing container or pod of a ephemeral Heat process will be deleted first. Ignored if --heat-type is native or --kill. (default: False) --skip-heat-pull When --heat-type is pod or container, assume the container image has already been pulled (default: False) --restore-db Restore a database dump if it exists within the directory specified by --heat-dir (default: False) --heat-native (deprecated): execute the heat-all process natively on this host. This option requires that the heat-all binaries be installed locally on this machine. This option is enabled by default which means heat-all is executed on the host OS directly. Conflicts with --heat-type, which deprecates --heat-native. (default: False) --heat-type {native,container,pod} Type of ephemeral heat process to launch. one of: native: Execute heat-all directly on the host. container: Execute heat-all in a container. pod: Execute separate heat api and engine processes in a podman pod. (default: pod) 82.12. tripleo upgrade Upgrade TripleO Usage: Table 82.23. Command arguments Value Summary --templates [TEMPLATES] The directory containing the heat templates to deploy --standalone Deprecated. the --standalone argument is now deprecated. Standalone deployments can now be run without passing --standalone. --upgrade Upgrade an existing deployment. --system-upgrade System-upgrade an existing deployment. -y, --yes Skip yes/no prompt (assume yes). --stack STACK Name for the ephemeral (one-time create and forget) heat stack. --output-dir OUTPUT_DIR Directory to output state, processed heat templates, ansible deployment files. Defaults to ~/tripleo- deploy/<stack> --output-only Do not execute the ansible playbooks. by default the playbooks are saved to the output-dir and then executed. --standalone-role STANDALONE_ROLE The role to use for standalone configuration when populating the deployment actions. -t <TIMEOUT>, --timeout <TIMEOUT> Deployment timeout in minutes. -e <HEAT ENVIRONMENT FILE>, --environment-file <HEAT ENVIRONMENT FILE> Environment files to be passed to the heat stack- create or heat stack-update command. (Can be specified more than once.) --roles-file ROLES_FILE, -r ROLES_FILE Roles file, overrides the default roles_data_undercloud.yaml in the t-h-t templates directory used for deployment. May be an absolute path or the path relative to the templates dir. --networks-file NETWORKS_FILE, -n NETWORKS_FILE Roles file, overrides the default /dev/null in the t-h-t templates directory used for deployment. May be an absolute path or the path relative to the templates dir. --plan-environment-file PLAN_ENVIRONMENT_FILE, -p PLAN_ENVIRONMENT_FILE Deprecated: plan environment file, not supported --heat-api-port <HEAT_API_PORT> Heat api port to use for the installers private heat API instance. Optional. Default: 8006.) --heat-user <HEAT_USER> User to execute the non-privileged heat-all process. Defaults to the value of --deployment-user. --deployment-user DEPLOYMENT_USER User who executes the tripleo deploy command. defaults to USDSUDO_USER. If USDSUDO_USER is unset it defaults to stack. --deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER The path to python interpreter to use for the deployment actions. If not specified the python version of the openstackclient will be used. This may need to be used if deploying on a python2 host from a python3 system or vice versa. --heat-container-image <HEAT_CONTAINER_IMAGE> The container image to use when launching the heat-all process. Defaults to: registry.redhat.io/rhosp- rhel9/openstack-heat-all:17.1 --heat-native [HEAT_NATIVE] Execute the heat-all process natively on this host. This option requires that the heat-all binaries be installed locally on this machine. This option is enabled by default which means heat-all is executed on the host OS directly. --local-ip <LOCAL_IP> Local ip/cidr for undercloud traffic. required. --control-virtual-ip <CONTROL_VIRTUAL_IP> Control plane vip. this allows the undercloud installer to configure a custom VIP on the control plane. --public-virtual-ip <PUBLIC_VIRTUAL_IP> Public nw vip. this allows the undercloud installer to configure a custom VIP on the public (external) NW. --local-domain <LOCAL_DOMAIN> Local domain for standalone cloud and its api endpoints --cleanup Cleanup temporary files. using this flag will remove the temporary files used during deployment in after the command is run. --hieradata-override [HIERADATA_OVERRIDE] Path to hieradata override file. when it points to a heat env file, it is passed in t-h-t via --environment-file. When the file contains legacy instack data, it is wrapped with <role>ExtraConfig and also passed in for t-h-t as a temp file created in --output-dir. Note, instack hiera data may be not t-h-t compatible and will highly likely require a manual revision. --keep-running Keep the ephemeral heat running after the stack operation is complete. This is for debugging purposes only. The ephemeral Heat can be used by openstackclient with: OS_AUTH_TYPE=none OS_ENDPOINT=http://127.0.0.1:8006/v1/admin openstack stack list where 8006 is the port specified by --heat- api-port. --inflight-validations Activate in-flight validations during the deploy. in- flight validations provide a robust way to ensure deployed services are running right after their activation. Defaults to False. --transport TRANSPORT Transport mechanism to use for ansible.use "ssh" for multinode deployments. Use "local" for standalone deployments. Defaults to "local". --ansible-forks ANSIBLE_FORKS The number of ansible forks to use for the config- download ansible-playbook command. --disable-container-prepare Disable the container preparation actions to prevent container tags from being updated and new containers from being fetched. If you skip this but do not have the container parameters configured, the deployment action may fail. --reproduce-command Create a reproducer command with ansible commandline and all environments variables. --force-stack-update Do a virtual update of the ephemeral heat stack (it cannot take real updates). New or failed deployments always have the stack_action=CREATE. This option enforces stack_action=UPDATE. --force-stack-create Do a virtual create of the ephemeral heat stack. new or failed deployments always have the stack_action=CREATE. This option enforces stack_action=CREATE. 82.13. tripleo validator group info [DEPRECATED]: Display detailed information about a Group. Please use "validation show group --help" instead. Usage: Table 82.24. Command arguments Value Summary -h, --help Show this help message and exit -f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} The output format, defaults to table (default: table) -c COLUMN, --column COLUMN Specify the column(s) to include, can be repeated to show multiple columns --quote {all,minimal,none,nonnumeric} When to include quotes, defaults to nonnumeric (default: nonnumeric) --noindent Whether to disable indenting the json --max-width <integer> Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --fit-width Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable --print-empty Print empty table if there is no data to show. --sort-column SORT_COLUMN Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated --sort-ascending Sort the column(s) in ascending order --sort-descending Sort the column(s) in descending order --config CONFIG Config file path for validation framework. (default: /etc/validation.cfg) --validation-dir VALIDATION_DIR Path where validation playbooks are located. (default: /usr/share/ansible/validation-playbooks) 82.14. tripleo validator init Create the paths and infrastructure to create a community validation Usage: Table 82.25. Positional arguments Value Summary <validation_name> The name of the community validation: Validation name is limited to contain only lowercase alphanumeric characters, plus _ or - and starts with an alpha character. Ex: my-val, my_val2. This will generate an Ansible role and a playbook in /root/community-validations. Note that the structure of this directory will be created at the first use. Table 82.26. Command arguments Value Summary -h, --help Show this help message and exit --config CONFIG Config file path for validation framework. (default: /etc/validation.cfg) --validation-dir VALIDATION_DIR Path where the validation playbooks is located. (default: /usr/share/ansible/validation-playbooks) --ansible-base-dir ANSIBLE_BASE_DIR Path where the ansible roles, library and plugins are located. (default: /usr/share/ansible) 82.15. tripleo validator list [DEPRECATED]: List the available validations. Please use "validation list --help" instead. Usage: Table 82.27. Command arguments Value Summary -h, --help Show this help message and exit -f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} The output format, defaults to table (default: table) -c COLUMN, --column COLUMN Specify the column(s) to include, can be repeated to show multiple columns --quote {all,minimal,none,nonnumeric} When to include quotes, defaults to nonnumeric (default: nonnumeric) --noindent Whether to disable indenting the json --max-width <integer> Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --fit-width Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable --print-empty Print empty table if there is no data to show. --sort-column SORT_COLUMN Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated --sort-ascending Sort the column(s) in ascending order --sort-descending Sort the column(s) in descending order --config CONFIG Config file path for validation framework. (default: /etc/validation.cfg) --group <group_id>[,<group_id>,... ], -g <group_id>[,<group_id>,... ] List specific group of validations, if more than one group is required separate the group names with commas. --category <category_id>[,<category_id>,... ] List specific category of validations, if more than one category is required separate the category names with commas. --product <product_id>[,<product_id>,... ] List specific product of validations, if more than one product is required separate the product names with commas. --validation-dir VALIDATION_DIR Path where validation playbooks are located. (default: /usr/share/ansible/validation-playbooks) 82.16. tripleo validator run [DEPRECATED]: Run the available validations. Please use "validation run --help" instead. Usage: Table 82.28. Command arguments Value Summary -h, --help Show this help message and exit --config CONFIG Config file path for validation framework. (default: /etc/validation.cfg) --limit <host1>[,<host2>,<host3>,... ] A string that identifies a single node or comma- separated list of nodes to be validated in this run invocation. --ssh-user SSH_USER Ssh user name for the ansible ssh connection. (default: root) --validation-dir VALIDATION_DIR Path where validation playbooks are located. (default: /usr/share/ansible/validation-playbooks) --ansible-base-dir ANSIBLE_BASE_DIR Path where the ansible roles, library and plugins are located. (default: /usr/share/ansible) --validation-log-dir VALIDATION_LOG_DIR Path where the log files and artifacts are located. (default: /var/log/validations) --inventory INVENTORY, -i INVENTORY Path of the ansible inventory. (default: localhost) --output-log OUTPUT_LOG Path where the run result will be stored. --junitxml JUNITXML Path where the run result in junitxml format will be stored. --python-interpreter --python-interpreter <PYTHON_INTERPRETER_PATH> Python interpreter for ansible execution. (default: /usr/bin/python3) --extra-env-vars key1=<val1> [--extra-env-vars key2=<val2>] Add extra environment variables you may need to provide to your Ansible execution as KEY=VALUE pairs. Note that if you pass the same KEY multiple times, the last given VALUE for that same KEY will override the other(s). --skiplist SKIP_LIST Path where the skip list is stored. an example of the skiplist format could be found at the root of the validations-libs repository. --extra-vars key1=<val1> [--extra-vars key2=<val2>] Add ansible extra variables to the validation(s) execution as KEY=VALUE pair(s). Note that if you pass the same KEY multiple times, the last given VALUE for that same KEY will override the other(s). --extra-vars-file /tmp/my_vars_file.[json|yaml] Absolute or relative path to a json/yaml file containing extra variable(s) to pass to one or multiple validation(s) execution. --validation <validation_id>[,<validation_id>,... ] Run specific validations, if more than one validation is required separate the names with commas. --group <group_id>[,<group_id>,... ], -g <group_id>[,<group_id>,... ] Run specific validations by group, if more than one group is required separate the group names with commas. --category <category_id>[,<category_id>,... ] Run specific validations by category, if more than one category is required separate the category names with commas. --product <product_id>[,<product_id>,... ] Run specific validations by product, if more than one product is required separate the product names with commas. 82.17. tripleo validator show history [DEPRECATED]: Display Validations execution history. Please use "validation history list --help" instead. Usage: Table 82.29. Command arguments Value Summary -h, --help Show this help message and exit -f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} The output format, defaults to table (default: table) -c COLUMN, --column COLUMN Specify the column(s) to include, can be repeated to show multiple columns --quote {all,minimal,none,nonnumeric} When to include quotes, defaults to nonnumeric (default: nonnumeric) --noindent Whether to disable indenting the json --max-width <integer> Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --fit-width Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable --print-empty Print empty table if there is no data to show. --sort-column SORT_COLUMN Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated --sort-ascending Sort the column(s) in ascending order --sort-descending Sort the column(s) in descending order --config CONFIG Config file path for validation framework. (default: /etc/validation.cfg) --validation <validation_id> Display execution history for a validation --limit HISTORY_LIMIT Display <n> most recent runs of the selected <validation>. <n> must be > 0 The default display limit is set to 15. --validation-log-dir VALIDATION_LOG_DIR Path where the log files and artifacts are located. (default: /var/log/validations) 82.18. tripleo validator show parameter [DEPRECATED]: Display Validations Parameters. Please use "validation show parameter --help" instead. Usage: Table 82.30. Command arguments Value Summary -h, --help Show this help message and exit --config CONFIG Config file path for validation framework. --validation-dir VALIDATION_DIR Path where validation playbooks are located. --validation <validation_id>[,<validation_id>,... ] List specific validations, if more than one validation is required separate the names with commas. --group <group_id>[,<group_id>,... ], -g <group_id>[,<group_id>,... ] List specific group of validations, if more than one group is required separate the group names with commas. --category <category_id>[,<category_id>,... ] List specific category of validations, if more than one category is required separate the category names with commas. --product <product_id>[,<product_id>,... ] List specific product of validations, if more than one product is required separate the product names with commas. --download DOWNLOAD Create a json or a yaml file containing all the variables available for the validations: /tmp/myvars --format-output <format_output> Print representation of the validation. the choices of the output format is json,yaml. Table 82.31. Output formatter options Value Summary -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} The output format, defaults to table -c COLUMN, --column COLUMN Specify the column(s) to include, can be repeated to show multiple columns Table 82.32. JSON formatter options Value Summary --noindent Whether to disable indenting the json Table 82.33. Shell formatter options Value Summary --prefix PREFIX Add a prefix to all variable names Table 82.34. Table formatter options Value Summary --max-width <integer> Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --fit-width Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable --print-empty Print empty table if there is no data to show. 82.19. tripleo validator show run [DEPRECATED]: Display details about a Validation execution. Please use "validation history get --help" instead. Usage: Table 82.35. Positional arguments Value Summary <uuid> Validation uuid run Table 82.36. Command arguments Value Summary -h, --help Show this help message and exit --config CONFIG Config file path for validation framework. (default: /etc/validation.cfg) --full Show full details of the validation run --validation-log-dir VALIDATION_LOG_DIR Path where the log files and artifacts are located. (default: /var/log/validations) 82.20. tripleo validator show [DEPRECATED]: Display detailed information about a Validation. Please use "validation show --help" instead. Usage: Table 82.37. Positional arguments Value Summary <validation> Show a specific validation. Table 82.38. Command arguments Value Summary -h, --help Show this help message and exit --config CONFIG Config file path for validation framework. --validation-dir VALIDATION_DIR Path where validation playbooks are located. Table 82.39. Output formatter options Value Summary -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} The output format, defaults to table -c COLUMN, --column COLUMN Specify the column(s) to include, can be repeated to show multiple columns Table 82.40. JSON formatter options Value Summary --noindent Whether to disable indenting the json Table 82.41. Shell formatter options Value Summary --prefix PREFIX Add a prefix to all variable names Table 82.42. Table formatter options Value Summary --max-width <integer> Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --fit-width Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable --print-empty Print empty table if there is no data to show.

Commands:
openstack tripleo config generate ansible [--deployment-user DEPLOYMENT_USER] [--output-dir OUTPUT_DIR]
openstack tripleo container image build [-h] [--authfile <authfile>] [--base <base-image>] [--config-file <config-file>] [--config-path <config-path>] [--distro <distro>] [--tcib-extras <key=val>] [--exclude <container-name>] [--extra-config <extra-config>] [--namespace <registry-namespace>] [--registry <registry-url>] [--skip-build] [--tag <image-tag>] [--prefix <image-prefix>] [--push] [--label <label-data>] [--volume <volume-path>] [--repo-dir <repo-dir>] [--work-dir <work-directory>] [--rhel-modules <rhel-modules>] [--build-timeout <build timeout in seconds>]
openstack tripleo container image delete [-h] [--registry-url <registry url>] [--username <username>] [--password <password>] [-y] <image to delete>
openstack tripleo container image hotfix [-h] --image <images> --rpms-path <rpms-path> [--tag <image-tag>]
openstack tripleo container image list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN] [--quote {all,minimal,none,nonnumeric}] [--noindent] [--max-width <integer>] [--fit-width] [--print-empty] [--sort-column SORT_COLUMN] [--sort-ascending | --sort-descending] [--registry-url <registry url>] [--username <username>] [--password <password>]
openstack tripleo container image prepare default [-h] [--output-env-file <file path>] [--local-push-destination] [--enable-registry-login]
openstack tripleo container image prepare [-h] [--environment-file <file path>] [--environment-directory <HEAT ENVIRONMENT DIRECTORY>] [--roles-file ROLES_FILE] [--output-env-file <file path>] [--dry-run] [--cleanup <full, partial, none>] [--log-file LOG_FILE]
openstack tripleo container image push [-h] [--local] [--registry-url <registry url>] [--append-tag APPEND_TAG] [--username <username>] [--password <password>] [--source-username <source_username>] [--source-password <source_password>] [--dry-run] [--multi-arch] [--cleanup] <image to push>
openstack tripleo container image show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--username <username>] [--password <password>] <image to inspect>
openstack tripleo deploy [--templates [TEMPLATES]] [--standalone] [--upgrade] [--system-upgrade] [-y] [--stack STACK] [--output-dir OUTPUT_DIR] [--output-only] [--standalone-role STANDALONE_ROLE] [-t <TIMEOUT>] [-e <HEAT ENVIRONMENT FILE>] [--roles-file ROLES_FILE] [--networks-file NETWORKS_FILE] [--plan-environment-file PLAN_ENVIRONMENT_FILE] [--heat-api-port <HEAT_API_PORT>] [--heat-user <HEAT_USER>] [--deployment-user DEPLOYMENT_USER] [--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER] [--heat-container-image <HEAT_CONTAINER_IMAGE>] [--heat-native [HEAT_NATIVE]] [--local-ip <LOCAL_IP>] [--control-virtual-ip <CONTROL_VIRTUAL_IP>] [--public-virtual-ip <PUBLIC_VIRTUAL_IP>] [--local-domain <LOCAL_DOMAIN>] [--cleanup] [--hieradata-override [HIERADATA_OVERRIDE]] [--keep-running] [--inflight-validations] [--transport TRANSPORT] [--ansible-forks ANSIBLE_FORKS] [--disable-container-prepare] [--reproduce-command] [--force-stack-update | --force-stack-create]
openstack tripleo launch heat [--heat-api-port <HEAT_API_PORT>] [--heat-user <HEAT_USER>] [--heat-container-image <HEAT_CONTAINER_IMAGE>] [--heat-container-api-image <HEAT_CONTAINER_API_IMAGE>] [--heat-container-engine-image <HEAT_CONTAINER_ENGINE_IMAGE>] [--kill] [--heat-dir HEAT_DIR] [--rm-heat] [--skip-heat-pull] [--restore-db] [--heat-native | --heat-type {native,container,pod}]
openstack tripleo upgrade [--templates [TEMPLATES]] [--standalone] [--upgrade] [--system-upgrade] [-y] [--stack STACK] [--output-dir OUTPUT_DIR] [--output-only] [--standalone-role STANDALONE_ROLE] [-t <TIMEOUT>] [-e <HEAT ENVIRONMENT FILE>] [--roles-file ROLES_FILE] [--networks-file NETWORKS_FILE] [--plan-environment-file PLAN_ENVIRONMENT_FILE] [--heat-api-port <HEAT_API_PORT>] [--heat-user <HEAT_USER>] [--deployment-user DEPLOYMENT_USER] [--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER] [--heat-container-image <HEAT_CONTAINER_IMAGE>] [--heat-native [HEAT_NATIVE]] [--local-ip <LOCAL_IP>] [--control-virtual-ip <CONTROL_VIRTUAL_IP>] [--public-virtual-ip <PUBLIC_VIRTUAL_IP>] [--local-domain <LOCAL_DOMAIN>] [--cleanup] [--hieradata-override [HIERADATA_OVERRIDE]] [--keep-running] [--inflight-validations] [--transport TRANSPORT] [--ansible-forks ANSIBLE_FORKS] [--disable-container-prepare] [--reproduce-command] [--force-stack-update | --force-stack-create]
openstack tripleo validator group info [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN] [--quote {all,minimal,none,nonnumeric}] [--noindent] [--max-width <integer>] [--fit-width] [--print-empty] [--sort-column SORT_COLUMN] [--sort-ascending] [--sort-descending] [--config CONFIG] [--validation-dir VALIDATION_DIR]
openstack tripleo validator init [-h] [--config CONFIG] [--validation-dir VALIDATION_DIR] [--ansible-base-dir ANSIBLE_BASE_DIR] <validation_name>
openstack tripleo validator list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN] [--quote {all,minimal,none,nonnumeric}] [--noindent] [--max-width <integer>] [--fit-width] [--print-empty] [--sort-column SORT_COLUMN] [--sort-ascending] [--sort-descending] [--config CONFIG] [--group <group_id>[,<group_id>,...]] [--category <category_id>[,<category_id>,...]] [--product <product_id>[,<product_id>,...]] [--validation-dir VALIDATION_DIR]
openstack tripleo validator run [-h] [--config CONFIG] [--limit <host1>[,<host2>,<host3>,...]] [--ssh-user SSH_USER] [--validation-dir VALIDATION_DIR] [--ansible-base-dir ANSIBLE_BASE_DIR] [--validation-log-dir VALIDATION_LOG_DIR] [--inventory INVENTORY] [--output-log OUTPUT_LOG] [--junitxml JUNITXML] [--python-interpreter --python-interpreter <PYTHON_INTERPRETER_PATH>] [--extra-env-vars key1=<val1> [--extra-env-vars key2=<val2>]] [--skiplist SKIP_LIST] [--extra-vars key1=<val1> [--extra-vars key2=<val2>] | --extra-vars-file /tmp/my_vars_file.[json|yaml]] (--validation <validation_id>[,<validation_id>,...] | --group <group_id>[,<group_id>,...] | --category <category_id>[,<category_id>,...] | --product <product_id>[,<product_id>,...])
openstack tripleo validator show history [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN] [--quote {all,minimal,none,nonnumeric}] [--noindent] [--max-width <integer>] [--fit-width] [--print-empty] [--sort-column SORT_COLUMN] [--sort-ascending] [--sort-descending] [--config CONFIG] [--validation <validation_id>] [--limit HISTORY_LIMIT] [--validation-log-dir VALIDATION_LOG_DIR]
openstack tripleo validator show parameter [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--config CONFIG] [--validation-dir VALIDATION_DIR] [--validation <validation_id>[,<validation_id>,...] | --group <group_id>[,<group_id>,...] | --category <category_id>[,<category_id>,...] | --product <product_id>[,<product_id>,...]] [--download DOWNLOAD] [--format-output <format_output>]
openstack tripleo validator show run [-h] [--config CONFIG] [--full] [--validation-log-dir VALIDATION_LOG_DIR] <uuid>
openstack tripleo validator show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--config CONFIG] [--validation-dir VALIDATION_DIR] <validation>