openstack-ansible/doc/source/install-guide/deploymenthost.rst

3.3 KiB

Prepare deployment host

When installing OpenStack in a production environment, we recommend using a separate deployment host which contains Ansible and orchestrates the OpenStack-Ansible installation on the target hosts. In a test environment, we prescribe using one of the infrastructure target hosts as the deployment host.

To use a target host as a deployment host, follow the steps in Chapter 3, Target hosts on the deployment host.

Installing the operating system

Install one of the following supported operating systems on the deployment hosts: * Ubuntu Server 16.04 (Xenial Xerus) LTS 64-bit * Ubuntu Server 14.04 (Trusty Tahr) LTS 64-bit Configure at least one network interface to access the internet or suitable local repositories.

Configuring the operating system

Install additional software packages and configure NTP. Before you begin, we recommend upgrading your system packages and kernel:

  1. Update package source lists:

    # apt-get update
  2. Upgrade system packages and kernel:

    # apt-get dist-upgrade

Reboot before you continue.

  1. Install additional software packages if not already installed during operating system installation:

    # apt-get install aptitude build-essential git ntp ntpdate \
      openssh-server python-dev sudo
  2. Configure NTP to synchronize with a suitable time source.

Configuring the network

Ansible deployments fail if the deployment server is unable to SSH to the containers. Configure the deployment host (where Ansible is executed) to be on the same L2 network as the network designated for container management. By default, this is br-mgmt. This configuration reduces the rate of failure due to connectivity issues.

The following network information is used as an example:

Container management: 172.29.236.0/22 (VLAN 10)

Select an IP from this range to assign to the deployment host.

Installing source and dependencies

Install the source and dependencies for the deployment host.

  1. Clone the latest stable release of the OpenStack-Ansible git repository into the /opt/openstack-ansible directory:

    # git clone -b https://github.com/openstack/openstack-ansible /opt/openstack-ansible

  2. Change to the /opt/openstack-ansible directory, and run the Ansible bootstrap script:

    # scripts/bootstrap-ansible.sh

Configuring Secure Shell (SSH) keys

Ansible uses Secure Shell (SSH) with public key authentication for connectivity between the deployment and target hosts. To reduce user interaction during Ansible operations, do not include pass phrases with key pairs. However, if a pass phrase is required, consider using the ssh-agent and ssh-add commands to temporarily store the pass phrase before performing Ansible operations.