Dmitriy Rabotyagov 456a816f40 [doc] Adjust deployment docs

Change-Id: Ia31a1c04c4e70d7180eb894f907368d7034ca41d
Closes-Bug: #1897343

2020-09-30 19:41:47 +03:00

5.2 KiB

Raw Blame History

Prepare the deployment host

When you install OpenStack in a production environment, we recommend using a separate deployment host that contains Ansible and orchestrates the OpenStack-Ansible (OSA) installation on the target hosts. In a test environment, we recommend using one of the infrastructure target hosts as the deployment host.

To use a target host as a deployment host, follow the steps in :deploy_guide:Prepare the target hosts <targethosts.html> on the deployment host.

Configuring the operating system

Install the operating system

Install one of the following supported operating systems on the deployment hosts:

Configure at least one network interface to access the Internet or suitable local repositories.

Configure Ubuntu

Install additional software packages and configure Network Time Protocol (NTP). Before you begin, we recommend upgrading your system packages and kernel.

Update package source lists:
```
# apt update
```
Upgrade the system packages and kernel:
```
# apt dist-upgrade
```
Reboot the host.
Install additional software packages if they were not installed during the operating system installation:
```
# apt install build-essential git chrony openssh-server python3-dev sudo
```
Configure NTP to synchronize with a suitable time source.

Configure CentOS

Install additional software packages and configure Network Time Protocol (NTP). Before you begin, we recommend upgrading your system packages and kernel.

Upgrade the system packages and kernel
```
# dnf upgrade
```
Reboot the host.
Install additional software packages if they were not installed during the operating system installation:

# dnf install https://repos.fedorapeople.org/repos/openstack/openstack-/rdo-release-.el8.rpm # dnf install git chrony openssh-server python3-devel sudo # dnf group install "Development Tools"
Configure NTP to synchronize with a suitable time source.
The firewalld service is enabled on most CentOS systems by default and its default ruleset prevents OpenStack components from communicating properly. Stop the firewalld service and mask it to prevent it from starting:
```
# systemctl stop firewalld
# systemctl mask firewalld
```

Note

There is future work planned to create proper firewall rules for OpenStack services in OpenStack-Ansible deployments. Until that work is complete, deployers must maintain their own firewall rulesets or disable the firewall entirely.

Configure SSH keys

Ansible uses SSH with public key authentication to connect the deployment host and target hosts. To reduce user interaction during Ansible operations, do not include passphrases with key pairs. However, if a passphrase is required, consider using the ssh-agent and ssh-add commands to temporarily store the passphrase before performing Ansible operations.

Configure the network

Ansible deployments fail if the deployment server can't use Secure Shell (SSH) to connect to the containers.

Configure the deployment host (where Ansible is executed) to be on the same layer 2 network as the network designated for container management. By default, this is the br-mgmt network. This configuration reduces the rate of failure caused by connectivity issues.

Select an IP address from the following example range to assign to the deployment host:

Container management: 172.29.236.0/22 (VLAN 10)

Install the source and dependencies

Install the source and dependencies for the deployment host.