tripleo-operator-ansible/roles/tripleo_overcloud_external_...
Cédric Jeanneret 5a73e0a718 Add new parameter in order to get a kind of dry-run
A new global parameter is introduced:
tripleo_generate_scripts_only

It allows to get the roles running as usual, but it won't actually
execute the "shell" module.
With the "tripleo_generate_scripts", it allows to get everything ready
for manual investigations, with the generated scripts ready.

Of course, every role can be instructed to only generate scripts, using
the standard <role_name>_generate_scripts_only parameter.

Change-Id: I841743fb6c2c24e4a3d86598f99322022b27804d
2020-05-12 15:14:47 +02:00
..
defaults Add new parameter in order to get a kind of dry-run 2020-05-12 15:14:47 +02:00
meta Add overcloud external update run 2020-03-17 15:56:19 -06:00
molecule/default Add overcloud external update run 2020-03-17 15:56:19 -06:00
tasks Add new parameter in order to get a kind of dry-run 2020-05-12 15:14:47 +02:00
tests Add overcloud external update run 2020-03-17 15:56:19 -06:00
README.md Add new parameter in order to get a kind of dry-run 2020-05-12 15:14:47 +02:00

README.md

tripleo_overcloud_external_update_run

A role to execute an overcloud external update.

Requirements

None.

Role Variables

  • tripleo_overcloud_external_update_run_debug: (Boolean) Flag to print out the command that is run. Default: false
  • tripleo_overcloud_external_update_run_extra_vars: (List) List of key=value or yaml/json file ansible refernce. Default: []
  • tripleo_overcloud_external_update_run_generate_scripts: (Boolean) Write out a shell script that can be used to reproduce the command being executed. By default uses the value of tripleo_generate_scripts or False if tripleo_generate_scripts is not defined.
  • tripleo_overcloud_external_update_run_generate_scripts_only: (Boolean) Do not run the actual command - to be used in conjonction with tripleo_overcloud_external_update_run_generate_scripts. By default uses the value of tripleo_generate_scripts_only or False if tripleo_generate_scripts_only is not defined.
  • tripleo_overcloud_external_update_run_home_dir: (String) Home directory to where the command is run from. Default: "{{ ansible_env.HOME }}"
  • tripleo_overcloud_external_update_run_log_combine: (Boolean) Flag to enable captching stderr with stdout. Default: true
  • tripleo_overcloud_external_update_run_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_external_update_run_log: (String) Path to a log file for the command output. Default: "{{ tripleo_overcloud_external_update_run_home_dir }}/overcloud_external_update_run.log"
  • tripleo_overcloud_external_update_run_poll: (Integer) Number of seconds to wait between each checks to see if the deployment command has completed. Default: 10
  • tripleo_overcloud_external_update_run_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_external_update_run_skip_tags: (String) A string specifying the tag or a comma seperated list of tags to be passed as --skip-tags to the playbook.
  • tripleo_overcloud_external_update_run_ssh_user: (String) Username of user to be used as the ssh user.
  • tripleo_overcloud_external_update_run_stack: (String) Name of the stack to deploy.
  • tripleo_overcloud_external_update_run_static_inventory: (String) Path to an existing ansible inventory to use.
  • tripleo_overcloud_external_update_run_tags: (String) A string specifying the tag or comma sperate list of tags to be passed as --tags to the playbook.
  • tripleo_overcloud_external_update_run_timeout: (Integer) Number in seconds to wait for the ansible execution of the deployment command to finish. Default: 5700

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_external_update_run_output: (String) The command standard output.
  • tripleo_overcloud_external_update_run_result: Ansible shell execution results

Dependencies

None.

Example Playbook

Example overcloud external update run execution playbook

- hosts: undercloud
  gather_facts: true
  tasks:
    - name: Run overcloud external update run
      import_role:
        name: tripleo_overcloud_external_update_run

License

Apache-2.0