tripleo-operator-ansible/roles/tripleo_overcloud_ffwd_upgr...
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 ffwd-upgrade run 2020-03-24 10:19:40 -06:00
molecule/default Add overcloud ffwd-upgrade run 2020-03-24 10:19:40 -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 ffwd-upgrade run 2020-03-24 10:19:40 -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_ffwd_upgrade_run

A role to execute an overcloud ffwd-upgrade run.

Requirements

None.

Role Variables

  • tripleo_overcloud_ffwd_upgrade_run_debug: (Boolean) Flag to print out the command that is run. Default: false
  • tripleo_overcloud_ffwd_upgrade_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_ffwd_upgrade_run_generate_scripts_only: (Boolean) Do not run the actual command - to be used in conjonction with tripleo_overcloud_ffwd_upgrade_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_ffwd_upgrade_run_home_dir: (String) Home directory to where the command is run from. Default: "{{ ansible_env.HOME }}"
  • tripleo_overcloud_ffwd_upgrade_run_log_combine: (Boolean) Flag to enable captching stderr with stdout. Default: true
  • tripleo_overcloud_ffwd_upgrade_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_ffwd_upgrade_run_log: (String) Path to a log file for the command output. Default: "{{ tripleo_overcloud_ffwd_upgrade_run_home_dir }}/overcloud_ffwd_upgrade_run.log"
  • tripleo_overcloud_ffwd_upgrade_run_playbook: (List) List of playbook(s) to use for the upgrade. Defaults: []
  • tripleo_overcloud_ffwd_upgrade_run_poll: (Integer) Number of seconds to wait between each checks to see if the deployment command has completed. Default: 10
  • tripleo_overcloud_ffwd_upgrade_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_ffwd_upgrade_run_ssh_user: (String) Username of user to be used as the ssh user.
  • tripleo_overcloud_ffwd_upgrade_run_stack: (String) Name of the stack to deploy.
  • tripleo_overcloud_ffwd_upgrade_run_static_inventory: (String) Path to an existing ansible inventory to use.
  • tripleo_overcloud_ffwd_upgrade_run_timeout: (Integer) Number in seconds to wait for the ansible execution of the deployment command to finish. Default: 5700
  • tripleo_overcloud_ffwd_upgrade_run_yes: (Boolean) Flag to skip the confirmation required before any ffwd-upgrade operation. Default: true

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

Dependencies

None.

Example Playbook

Example overcloud ffwd-upgrade run execution playbook

- hosts: undercloud
  gather_facts: true
  tasks:
    - name: Run overcloud ffwd-upgrade run
      import_role:
        name: tripleo_overcloud_ffwd_upgrade_run

License

Apache-2.0