f3585df8be
Adds tripleo_overcloud_update_prepare role Change-Id: I5e0c9df530e2b9ac1e0d35a7bb74e01db2120839
98 lines
7.4 KiB
Markdown
98 lines
7.4 KiB
Markdown
tripleo_overcloud_update_prepare
|
|
================================
|
|
|
|
A role to execute an overcloud update prepare.
|
|
|
|
Requirements
|
|
------------
|
|
|
|
None.
|
|
|
|
Role Variables
|
|
--------------
|
|
|
|
* `tripleo_overcloud_update_prepare_answers_file`: (String) File path to a deployment answers file.
|
|
* `tripleo_overcloud_update_prepare_baremetal_update_preparement`: (String) File path to a baremetal deployment configuration.
|
|
* `tripleo_overcloud_update_prepare_config_download`: (Boolean) Flag to add --config-download option. This is the default as of Rocky and enabling this should have no effect. Default: false
|
|
* `tripleo_overcloud_update_prepare_config_download_timeout`: (Integer) Timeout in minutes for the config-download steps.
|
|
* `tripleo_overcloud_update_prepare_debug`: (Boolean) Flag to print out the command that is run. Default: false
|
|
* `tripleo_overcloud_update_prepare_update_prepareed_server`: (Boolean) Flag to use pre-provisioned nodes. Default: false
|
|
* `tripleo_overcloud_update_prepare_update_preparement_python_interpreter`: (String) Path to a python interpreter for the deployment actions.
|
|
* `tripleo_overcloud_update_prepare_disable_password_generation`: (Boolean) Flag to disable password generation. Default: false
|
|
* `tripleo_overcloud_update_prepare_disable_validations`: (Boolean) Flag to disable validations. Default: false
|
|
* `tripleo_overcloud_update_prepare_dry_run`: (Boolean) Flag to enabel dry run. Default: false
|
|
* `tripleo_overcloud_update_prepare_environment_dirs`: (List) A list of directory paths containing environment files for the deployment. Should not be used with environment files.
|
|
* `tripleo_overcloud_update_prepare_environment_files`: (List) A list of environment file paths for the deployment. Should not be used with environment dirs.
|
|
* `tripleo_overcloud_update_prepare_force_postconfig`: (Boolean) Force the overclodu post-deployment configuration. Default: false
|
|
* `tripleo_overcloud_update_prepare_home_dir`: (String) Home directory to where the command is run from. Default: "{{ ansible_env.HOME }}"
|
|
* `tripleo_overcloud_update_prepare_inflight_validations`: (Boolean) Flag to enable inflight validations. Default: false
|
|
* `tripleo_overcloud_update_prepare_libvirt_type`: (String) Libvirt domain time. Setting `NovaComputeLibvirtType` in an environment file is prefered over this option.
|
|
* `tripleo_overcloud_update_prepare_log`: (String) Path to a log file for the command output. Default: "{{ tripleo_overcloud_update_prepare_home_dir }}/overcloud_update_prepare.log"
|
|
* `tripleo_overcloud_update_prepare_log_combine`: (Boolean) Flag to enable captching stderr with stdout. Default: true
|
|
* `tripleo_overcloud_update_prepare_log_output`: (Boolean) Flag to enable logging to a file. Since the output of this command can be large, it is not recommended to disable this. Default: true
|
|
* `tripleo_overcloud_update_prepare_networks_file`: (String) File path to a networks file for the deployment.
|
|
* `tripleo_overcloud_update_prepare_no_cleanup`: (Boolean) String to enable no cleanup. Default: false
|
|
* `tripleo_overcloud_update_prepare_no_config_download`: (Boolean) String to disable the config download software configuration. Default: false
|
|
* `tripleo_overcloud_update_prepare_no_proxy`: (String) String containing a comma seperated list of hosts to skip proxing when http_proxy and https_proxy are used.
|
|
* `tripleo_overcloud_update_prepare_ntp_server`: (String) String containing a comma seperated list of ntp servers. Setting `NtpServer` in an environment file is prefered over this option.
|
|
* `tripleo_overcloud_update_prepare_os_cloud`: (String) (String) OS_CLOUD value to use when running the command. If `tripleo_os_cloud` is defined, it will be the default. Otherwise the default is ''. This variable takes precedence over `tripleo_overcloud_update_prepare_rc_file`.
|
|
* `tripleo_overcloud_update_prepare_output_dir`: (String) Path to a directory to output for the configuration download output.
|
|
* `tripleo_overcloud_update_prepare_overcloud_ssh_enable_timeout`: (Integer) Timeout for the ssh enable process to finish.
|
|
* `tripleo_overcloud_update_prepare_overcloud_ssh_key`: (String) Path to an ssh key file to use to access the overcloud nodes.
|
|
* `tripleo_overcloud_update_prepare_overcloud_ssh_network`: (String) Network name to use for the ssh access to the overcloud nodes.
|
|
* `tripleo_overcloud_update_prepare_overcloud_ssh_port_timeout`: (Integer) Timeout to wait for the ssh port to become active.
|
|
* `tripleo_overcloud_update_prepare_overcloud_ssh_user`: (String) User for ssh access to the overcloud nodes.
|
|
* `tripleo_overcloud_update_prepare_override_ansible_cfg`: (String) File path to an ansible.cfg containing override values.
|
|
* `tripleo_overcloud_update_prepare_plan_environment_file`: (String) File path to a plan environment file.
|
|
* `tripleo_overcloud_update_prepare_poll`: (Integer) Number of seconds to wait between each checks to see if the deployment command has completed. Default: 10
|
|
* `tripleo_overcloud_update_prepare_rc_file`: (String) (String) Path to the credential file to use. If `tripleo_rc_file` is defined, it will be the default. Default: "{{ ansible_env.HOME }}/stackrc"
|
|
* `tripleo_overcloud_update_prepare_roles_file`: (String) File path to a deployment roles file.
|
|
* `tripleo_overcloud_update_prepare_run_validations`: (Boolean) Flag to enable running validations. Default: false
|
|
* `tripleo_overcloud_update_prepare_skip_update_prepare_identifier`: (Boolean) Flag to enable skip deploy identifier. Default: false
|
|
* `tripleo_overcloud_update_prepare_skip_postconfig`: (Boolean) Flag to enable skip postconfig. Default: false
|
|
* `tripleo_overcloud_update_prepare_stack`: (String) Name of the stack to deploy. Default: overcloud
|
|
* `tripleo_overcloud_update_prepare_templates`: (String) Path to a directory containing the tripleo-heat-templates for the deployment. Default: /usr/share/openstack-tripleo-heat-templates/
|
|
* `tripleo_overcloud_update_prepare_timeout`: (Integer) Number in seconds to wait for the ansible execution of the deployment command to finish. This should be larger than the `tripleo_overcloud_update_prepare_timeout_arg` value. Default: 5700
|
|
* `tripleo_overcloud_update_prepare_timeout_arg`: (Integer) Number in minutes for the deployment to run. Default: 90
|
|
* `tripleo_overcloud_update_prepare_update_plan_only`: (Boolean) Flag to enable only updating the plan. Default: false
|
|
* `tripleo_overcloud_update_prepare_validation_errors_nonfatal`: (Boolean) Flag to make validation errors not fatal. Default: false
|
|
* `tripleo_overcloud_update_prepare_validation_warnings_fatal`: (Boolean) Flag to make validation warnings fatal. Default: false
|
|
|
|
NOTE: Please note that this command should be run against the undercloud so the
|
|
OS_CLOUD or rc file variables should be set to use the 'undercloud' when
|
|
calling this role. If you are not defining `tripleo_os_cloud` or `tripleo_rc_file`,
|
|
stackrc will be used by default.
|
|
|
|
Output Variables
|
|
----------------
|
|
|
|
* `tripleo_overcloud_update_prepare_output`: (String) The command standard output.
|
|
* `tripleo_overcloud_update_prepare_result`: Ansible shell execution results
|
|
|
|
Dependencies
|
|
------------
|
|
|
|
None.
|
|
|
|
Example Playbook
|
|
----------------
|
|
|
|
Example overcloud update prepare execution playbook
|
|
|
|
```yaml
|
|
- hosts: undercloud
|
|
gather_facts: true
|
|
tasks:
|
|
- name: Run overcloud update prepare
|
|
import_role:
|
|
name: tripleo_overcloud_update_prepare
|
|
vars:
|
|
tripleo_overcloud_update_prepare_environment_files:
|
|
- /usr/share/openstack-tripleo-heat-templates/environments/enable-swap.yaml
|
|
```
|
|
|
|
License
|
|
-------
|
|
|
|
Apache-2.0
|