tripleo-quickstart-extras/roles/undercloud-setup
John Trowbridge df7f888aa6 Remove duplicate meta/main from undercloud-setup role
Accidentally got in via:

62cf304ede

Change-Id: I721900c2601ae3ea335c5dcbf46551496ab2852f
2017-01-24 15:21:32 -05:00
..
defaults Integrate undercloud_user var into oooq-extras 2017-01-18 09:32:16 -05:00
files undercloud-setup: Add SSH arguments to multinode vxlan subnode setup 2017-01-06 13:44:32 +08:00
meta Remove duplicate meta/main from undercloud-setup role 2017-01-24 15:21:32 -05:00
tasks Integrate undercloud_user var into oooq-extras 2017-01-18 09:32:16 -05:00
templates Integrate undercloud_user var into oooq-extras 2017-01-18 09:32:16 -05:00
README.md Integrate undercloud_user var into oooq-extras 2017-01-18 09:32:16 -05:00

undercloud-setup

This role encompasses the setup required when using a standard CentOS/RHEL undercloud host in substitution for a 'ready-made' undercloud image. If an undercloud machine or node is launched a 'vanilla' CentOS and RHEL image, there are a number of steps that need to be run to get the undercloud to the point where TripleO Quickstart can be run.

Some steps are generic to all undercloud nodes or machines and some steps are specific to the environment in which the undercloud is launched.

Steps to download or build overcloud images are included in the overcloud-images role. Steps to prepare the undercloud repos are included in the repo-setup role.

Requirements

This role should not be included in a generic virtual TripleO Quickstart playbook. Therefore including environment-specific code (which is switch cased to run only on the desired environment) is acceptable. It will not add complexity to the default TripleO Quickstart workflow.

Role Variables

  • local_working_dir: <"{{ lookup('env', 'HOME') }}/.quickstart"> -- Directory for quickstart.sh script
  • non_root_user: -- The non-root user operating on the virthost
  • undercloud_user: -- The non-root user operating on the undercloud
  • undercloud_key: <"{{ local_working_dir }}/id_rsa_undercloud"> -- Key to access the undercloud node/machine
  • non_root_user_setup: -- Switch to setup a non-root user
  • toci_vxlan_networking: -- Switch to setup the VXLAN networking from devstack-gate
  • toci_vxlan_networking_multinode: -- Switch to setup the VXLAN networking from devstack-gate on a multinode setup provided from nodepool.
  • undercloud_hostname: -- Optionally, the hostname to set on the host.
  • hostname_correction: -- Switch to set the transient hostname to the static hostname (TripleO requirement)
  • step_set_undercloud_hostname: -- Switch to set the undercloud hostname explicitly
  • package_installs: -- Switch to install required OpenStack packages for an undercloud (requires repos to already be setup)
  • custom_nameserver: <8.8.8.8> -- Added to /etc/resolv.conf for access in custom environments
  • ovb_setup_connectivity: -- Setup external network, custom nameserver and set MTUS valuse for OVB environments

Dependencies

This playbook has no dependencies. If a provisioning step is not included in this role, it is assumed that the node/machine to set up already exists and is accessible.

Example Playbook

  1. Sample playbook to call the role
- name: Set up CentOS undercloud node to run TripleO Quickstart
  hosts: undercloud
  gather_facts: no
  roles:
    - undercloud-setup

License

Apache-2.0

Author Information

RDO-CI Team