Configuring for OpenStack

Overview

When deployed on OpenStack, OKD can be configured to access the OpenStack infrastructure, including using OpenStack Cinder volumes as persistent storage for application data.

OKD 3.11 is supported for use with Red Hat OpenStack Platform 13.

The latest OKD release supports both the latest Red Hat OpenStack Platform long life release and intermediate release. The release cycles of OKD and Red Hat OpenStack Platform are different and versions tested may vary in the future depending on the release dates of both products.

Before you Begin

OKD SDN

The default OKD SDN is OpenShiftSDN. There is another option: use Kuryr SDN.

Kuryr SDN

Kuryr is a CNI plug-in that uses Neutron and Octavia to provide networking for pods and services. It is primarily designed for OKD clusters that run on OpenStack virtual machines. Kuryr improves the network performance by plugging OKD pods into OpenStack SDN. In addition it provides interconnectivity between OKD pods and OpenStack virtual instances.

Kuryr is recommended for OKD deployments on encapsulated OpenStack tenant networks in order to avoid double encapsulation, such as running an encapsulated OpenShift SDN over an OpenStack network. Kuryr is recommended whenever VXLAN, GRE, or GENEVE are required.

Conversely, implementing Kuryr does not make sense in the following cases:

  • You use provider networks, tenant VLANs, or a third party commercial SDN such as Cisco ACI or Juniper Contrail.

  • The deployment will use many services on a few hypervisors, or OKD virtual machine nodes. Each OKD service creates an Octavia Amphora virtual machine in OpenStack that hosts a required load balancer.

To enable Kuryr SDN, your environment must meet the following requirements:

  • Running OpenStack 13 or later

  • Overcloud with Octavia

  • Neutron Trunk ports extension enabled

  • If ML2/OVS Neutron driver is used the OpenvSwitch firewall driver must be used, instead of the ovs-hybrid one.

OKD Prerequisites

A successful deployment of OKD requires many prerequisites. This consists of a set of infrastructure and host configuration steps prior to the actual installation of OKD using Ansible. In the following subsequent sections, details regarding the prerequisites and configuration changes required for an OKD on a OpenStack environment are discussed in detail.

All of the OpenStack CLI commands in this reference environment are executed using the CLI openstack commands within a different node from the director node. The commands are executed in the other node to avoid package conflicts with Ansible version 2.6 and above. Be sure to install the following packages in the specified repositories.

Example:

Enable the rhel-7-server-openstack-13-tools-rpms and the required OKD repositories from Set Up Repositories.

  1. $ sudo subscription-manager repos \
  2. --enable rhel-7-server-openstack-{rhosp_version}-tools-rpms \
  3. --enable rhel-7-server-openstack-14-tools-rpms
  4. $ sudo subscription-manager repo-override --repo=rhel-7-server-openstack-14-tools-rpms --add=includepkgs:"python2-openstacksdk.* python2-keystoneauth1.* python2-os-service-types.*"
  5. $ sudo yum install -y python2-openstackclient python2-heatclient python2-octaviaclient ansible

Verify the packages are of at least the following versions (use rpm -q <package_name>):

  • python2-openstackclient - 3.14.1.-1

  • python2-heatclient 1.14.0-1

  • python2-octaviaclient 1.4.0-1

  • python2-openstacksdk 0.17.2

Enabling Octavia: OpenStack Load Balancing as a Service (LBaaS)

Octavia is a supported load balancer solution that is recommended to be used in conjunction with OKD in order to load balance the external incoming traffic and provide a single view of the OKD master services for the applications.

In order to enable Octavia, the Octavia service must be included during the installation of the OpenStack overcloud or upgraded if the overcloud already exists. The following steps provide basic non-custom steps in enabling Octavia and apply to both either a clean install of the overcloud or an overcloud update.

The following steps only capture the key pieces required during the deployment of OpenStack when dealing with Octavia. For more information visit the documentation of Installation of OpenStack. It is also important to note that registry methods vary. For more information visit the documentation on Registry Methods. This example used the local registry method.

If using the local registry, create a template to upload the images to the registry. Example shown below.

  1. (undercloud) $ openstack overcloud container image prepare \
  2. -e /usr/share/openstack-tripleo-heat-templates/environments/services-docker/octavia.yaml \
  3. --namespace=registry.access.redhat.com/rhosp13 \
  4. --push-destination=<local-ip-from-undercloud.conf>:8787 \
  5. --prefix=openstack- \
  6. --tag-from-label {version}-{release} \
  7. --output-env-file=/home/stack/templates/overcloud_images.yaml \
  8. --output-images-file /home/stack/local_registry_images.yaml

Verify that the created local_registry_images.yaml contains the Octavia images.

Octavia images in local registry file

  1. ...
  2. - imagename: registry.access.redhat.com/rhosp13/openstack-octavia-api:13.0-43
  3. push_destination: <local-ip-from-undercloud.conf>:8787
  4. - imagename: registry.access.redhat.com/rhosp13/openstack-octavia-health-manager:13.0-45
  5. push_destination: <local-ip-from-undercloud.conf>:8787
  6. - imagename: registry.access.redhat.com/rhosp13/openstack-octavia-housekeeping:13.0-45
  7. push_destination: <local-ip-from-undercloud.conf>:8787
  8. - imagename: registry.access.redhat.com/rhosp13/openstack-octavia-worker:13.0-44
  9. push_destination: <local-ip-from-undercloud.conf>:8787

The versions of the Octavia containers will vary depending upon the specific Red Hat OpenStack Platform release installed.

The following step pulls the container images from registry.redhat.io to the undercloud node. This process might take some time depending on the speed of the network and undercloud disk.

  1. (undercloud) $ sudo openstack overcloud container image upload \
  2. --config-file /home/stack/local_registry_images.yaml \
  3. --verbose

As an Octavia Load Balancer is used to access the OpenShift API, there is a need to increase their listeners default timeouts for the connections. The default timeout is 50 seconds. Increase the timeout to 20 minutes by passying the following file to the overcloud deploy command:

  1. (undercloud) $ cat octavia_timeouts.yaml
  2. parameter_defaults:
  3. OctaviaTimeoutClientData: 1200000
  4. OctaviaTimeoutMemberData: 1200000

This is not needed from Red Hat OpenStack Platform 14 and onwards.

Install or update your overcloud environment with Octavia:

  1. openstack overcloud deploy --templates \
  2. .
  3. .
  4. .
  5. -e /usr/share/openstack-tripleo-heat-templates/environments/services-docker/octavia.yaml \
  6. -e octavia_timeouts.yaml
  7. .
  8. .
  9. .

The command above only includes the files associated with Octavia. This command will vary based upon your specifc installation of OpenStack. See the official OpenStack documentation for further information. For more information on customizing your Octavia installation, see installation of Octavia using Director.

If Kuryr SDN is used, the overcloud installation requires the “trunk” extension to be enabled at Neutron. This is enabled by default on Director deployments. Use the openvswitch firewall instead of the default ovs-hybrid when the Neutron backend is ML2/OVS. There is no need for modifications if the backend is ML2/OVN.

Creating OpenStack User Accounts, Projects, and Roles

Before installing OKD, the Red Hat OpenStack Platform (RHOSP) environment requires a project, often referred to as a tenant, that stores the OpenStack instances that are to install the OKD. This project requires ownership by a user and the role of that user to be set to _member_.

The following steps show how to accomplish the above.

As the OpenStack overcloud administrator,

  1. Create a project (tenant) that is to store the RHOSP instances

    1. $ openstack project create <project>
  2. Create a RHOSP user that has ownership of the previously created project:

    1. $ openstack user create --password <password> <username>
  3. Set the role of the user:

    1. $ openstack role add --user <username> --project <project> _member_

The default quotas assigned to new RH OSP projects are not high enough for OKD installations. Increase the quotas to at least 30 security groups, 200 security group rules, and 200 ports.

  1. $ openstack quota set --secgroups 30 --secgroup-rules 200 --ports 200 <project>
  2. (1)
1For <project>, specify the name of the project to modify

Extra steps for Kuryr SDN

If Kuryr SDN is enabled, especially if you are using namespace isolation, increase your project’s quotas to meet these minimum requirements:

  • 300 security groups - one for each namespace plus one for each load balancer

  • 150 networks - one for each namespace

  • 150 subnets - one for each namespace

  • 500 security group rules

  • 500 ports - one port per Pod and additional ports for pools to speed up Pod creation

This is not a global recommendation. Adjust your quotas to meet your requirements.

If you are using namespace isolation, each namespace is given a new network and subnet. Additionally, a security group is created to enable traffic between Pods in the namespace.

  1. $ openstack quota set --networks 150 --subnets 150 --secgroups 300 --secgroup-rules 500 --ports 500 <project>
  2. (1)
1For <project>, specify the name of the project to modify

If you enabled namespace isolation, you must add the project ID to the octavia.conf configuration file after you create the project. This step ensures that required LoadBalancer security groups belong to that project and that they can be updated to enforce services isolation across namespaces.

  1. Get the project ID

    1. $ openstack project show *<project>*
    2. +-------------+----------------------------------+
    3. | Field | Value |
    4. +-------------+----------------------------------+
    5. | description | |
    6. | domain_id | default |
    7. | enabled | True |
    8. | id | PROJECT_ID |
    9. | is_domain | False |
    10. | name | *<project>* |
    11. | parent_id | default |
    12. | tags | [] |
    13. +-------------+----------------------------------+
  2. Add the project ID to [filename]octavia.conf on the controllers and restart octavia worker.

    1. $ source stackrc # undercloud credentials
    2. $ openstack server list
    3. +--------------------------------------+--------------+--------+-----------------------+----------------+------------+
    4. | ID | Name | Status | Networks
    5. | Image | Flavor |
    6. +--------------------------------------+--------------+--------+-----------------------+----------------+------------+
    7. | 6bef8e73-2ba5-4860-a0b1-3937f8ca7e01 | controller-0 | ACTIVE |
    8. ctlplane=192.168.24.8 | overcloud-full | controller |
    9. | dda3173a-ab26-47f8-a2dc-8473b4a67ab9 | compute-0 | ACTIVE |
    10. ctlplane=192.168.24.6 | overcloud-full | compute |
    11. +--------------------------------------+--------------+--------+-----------------------+----------------+------------+
    12. $ ssh heat-admin@192.168.24.8 # ssh into the controller(s)
    13. controller-0$ vi /var/lib/config-data/puppet-generated/octavia/etc/octavia/octavia.conf
    14. [controller_worker]
    15. # List of project ids that are allowed to have Load balancer security groups
    16. # belonging to them.
    17. amp_secgroup_allowed_projects = PROJECT_ID
    18. controller-0$ sudo docker restart octavia_worker

Configuring the RC file

After you configure the project, an OpenStack administrator can create an RC file with all the required information to the user(s) implementing the OKD environment.

An example RC file:

  1. $ cat path/to/examplerc
  2. # Clear any old environment that may conflict.
  3. for key in $( set | awk '{FS="="} /^OS_/ {print $1}' ); do unset $key ; done
  4. export OS_PROJECT_DOMAIN_NAME=Default
  5. export OS_USER_DOMAIN_NAME=Default
  6. export OS_PROJECT_NAME=<project-name>
  7. export OS_USERNAME=<username>
  8. export OS_PASSWORD=<password>
  9. export OS_AUTH_URL=http://<ip>:5000//v3
  10. export OS_CLOUDNAME=<cloud-name>
  11. export OS_IDENTITY_API_VERSION=3
  12. # Add OS_CLOUDNAME to PS1
  13. if [ -z "${CLOUDPROMPT_ENABLED:-}" ]; then
  14. export PS1=${PS1:-""}
  15. export PS1=\${OS_CLOUDNAME:+"(\$OS_CLOUDNAME)"}\ $PS1
  16. export CLOUDPROMPT_ENABLED=1
  17. fi

Changing _OS_PROJECT_DOMAIN_NAME and _OS_USER_DOMAIN_NAME from the Default value is supported as long as both reference the same domain.

As the user(s) implementing the OKD environment, within the OpenStack director node or workstation, ensure to source the credentials as follows:

  1. $ source path/to/examplerc

Create an OpenStack Flavor

Within OpenStack, flavors define the size of a virtual server by defining the compute, memory, and storage capacity of nova computing instances. Since the base image within this reference architecture is Red Hat Enterprise Linux 7.5, a m1.node and m1.master sized flavor is created with the following specifications as shown in Minimum System Requirements for OpenShift.

Although the minimum system requirements are sufficient to run a cluster, to improve performance, it is recommended to increase vCPU on master nodes. Additionally, more memory is recommended if etcd is co-located on the master nodes.

Table 1. Minimum System Requirements for OpenShift
Node TypeCPURAMRoot DiskFlavor

Masters

4

16 GB

45 GB

m1.master

Nodes

1

8 GB

20 GB

m1.node

As an OpenStack administrator,

  1. $ openstack flavor create <flavor_name> \
  2. --id auto \
  3. --ram <ram_in_MB> \
  4. --disk <disk_in_GB> \
  5. --vcpus <num_vcpus>

An example below showing the creation of flavors within this reference environment.

  1. $ openstack flavor create m1.master \
  2. --id auto \
  3. --ram 16384 \
  4. --disk 45 \
  5. --vcpus 4
  6. $ openstack flavor create m1.node \
  7. --id auto \
  8. --ram 8192 \
  9. --disk 20 \
  10. --vcpus 1
If access to OpenStack administrator privileges to create new flavors is unavailable, use existing flavors within the OpenStack environment that meet the requirements in Minimum System Requirements for OpenShift.

Verification of the OpenStack flavors via:

  1. $ openstack flavor list

Creating an OpenStack Keypair

Red Hat OpenStack Platform uses cloud-init to place an ssh public key on each instance as it is created to allow ssh access to the instance. Red Hat OpenStack Platform expects the user to hold the private key.

Losing the private key will cause the inability to access the instances.

To generate a keypair, use the following command:

  1. $ openstack keypair create <keypair-name> > /path/to/<keypair-name>.pem

Verification of the keypair creation can be done via:

  1. $ openstack keypair list

Once the keypair is created, set the permissions to 600 thus only allowing the owner of the file to read and write to that file.

  1. $ chmod 600 /path/to/<keypair-name>.pem

Setting up DNS for OKD

DNS service is an important component in the OKD environment. Regardless of the provider of DNS, an organization is required to have certain records in place to serve the various OKD components.

Using /etc/hosts is not valid, a proper DNS service must exist.

Using the key secret of the DNS, you can provide the information to the OpenShift Ansible Installer and it will automatically add A records for the target instances and the various OKD components. This process setup is described later when configuring the OpenShift Ansible Installer.

Access to a DNS server is expected. You can use Red Hat Labs DNS Helper for assistance with access.

Application DNS

Applications served by OpenShift are accessible by the router on ports 80/TCP and 443/TCP. The router uses a wildcard record to map all host names under a specific sub domain to the same IP address without requiring a separate record for each name.

This allows OKD to add applications with arbitrary names as long as they are under that sub domain.

For example, a wildcard record for *.apps.example.com causes DNS name lookups for tax.apps.example.com and home-goods.apps.example.com to both return the same IP address: 10.19.x.y. All traffic is forwarded to the OpenShift Routers. The Routers examine the HTTP headers of the queries and forward them to the correct destination.

With a load-balancer such as Octavia, host address of 10.19.x.y, the wildcard DNS record can be added as follows:

Table 2. Load Balancer DNS records
IP AddressHostnamePurpose

10.19.x.y

*.apps.example.com

User access to application web services

Creation of OKD Networks via OpenStack

When deploying OKD on Red Hat OpenStack Platform as described in this segment, the requirements are two networks — public and internal network.

Public Network

The public network is a network that contains external access and can be reached by the outside world. The public network creation can be only done by an OpenStack administrator.

The following commands provide an example of creating an OpenStack provider network for public network access.

As an OpenStack administrator (overcloudrc access),

  1. $ source /path/to/examplerc
  2. $ openstack network create <public-net-name> \
  3. --external \
  4. --provider-network-type flat \
  5. --provider-physical-network datacentre
  6. $ openstack subnet create <public-subnet-name> \
  7. --network <public-net-name> \
  8. --dhcp \
  9. --allocation-pool start=<float_start_ip>,end=<float_end_ip> \
  10. --gateway <ip> \
  11. --subnet-range <CIDR>

Once the network and subnet have been created verify via:

  1. $ openstack network list
  2. $ openstack subnet list

<float_start_ip> and <float_end_ip> are the associated floating IP pool provided to the network labeled public network. The Classless Inter-Domain Routing (CIDR) uses the format <ip>/<routing_prefix>, i.e. 10.0.0.1/24.

Internal Network

The internal network is connected to the public network via a router during the network setup. This allows each Red Hat OpenStack Platform instance attached to the internal network the ability to request a floating IP from the public network for public access. The internal network is created automically by the OpenShift Ansible installer via setting the openshift_openstack_private_network_name. More information regarding changes required for the OpenShift Ansible installer are described later.

Creating OpenStack Deployment Host Security Group

OpenStack networking allows the user to define inbound and outbound traffic filters that can be applied to each instance on a network. This allows the user to limit network traffic to each instance based on the function of the instance services and not depend on host based filtering. The OpenShift Ansible installer handles the proper creation of all the ports and services required for each type of host that is part of the OKD cluster except for the deployment host.

The following command creates an empty security group with no rules set for the deployment host.

  1. $ source path/to/examplerc
  2. $ openstack security group create <deployment-sg-name>

Verify the creation of the security group:

  1. $ openstack security group list

Deployment Host Security Group

The deployment instance only needs to allow inbound ssh. This instance exists to give operators a stable base to deploy, monitor and manage the OKD environment.

Table 3. Deployment Host Security Group TCP ports
Port/ProtocolServiceRemote sourcePurpose

ICMP

ICMP

Any

Allow ping, traceroute, etc.

22/TCP

SSH

Any

Secure shell login

Creation of the above security group rules is as follows:

  1. $ source /path/to/examplerc
  2. $ openstack security group rule create \
  3. --ingress \
  4. --protocol icmp \
  5. <deployment-sg-name>
  6. $ openstack security group rule create \
  7. --ingress \
  8. --protocol tcp \
  9. --dst-port 22 \
  10. <deployment-sg-name>

Verification of the security group rules is as follows:

  1. $ openstack security group rule list <deployment-sg-name>
  2. +--------------------------------------+-------------+-----------+------------+-----------------------+
  3. | ID | IP Protocol | IP Range | Port Range | Remote Security Group |
  4. +--------------------------------------+-------------+-----------+------------+-----------------------+
  5. | 7971fc03-4bfe-4153-8bde-5ae0f93e94a8 | icmp | 0.0.0.0/0 | | None |
  6. | b8508884-e82b-4ee3-9f36-f57e1803e4a4 | None | None | | None |
  7. | cb914caf-3e84-48e2-8a01-c23e61855bf6 | tcp | 0.0.0.0/0 | 22:22 | None |
  8. | e8764c02-526e-453f-b978-c5ea757c3ac5 | None | None | | None |
  9. +--------------------------------------+-------------+-----------+------------+-----------------------+

OpenStack Cinder Volumes

OpenStack Block Storage provides persistent block storage management via the cinder service. Block storage enables the OpenStack user to create a volume that may be attached to different OpenStack instances.

Docker Volume

The master and node instances contain a volume to store docker images. The purpose of the volume is to ensure that a large image or container does not compromise node performance or abilities of the existing node.

A docker volume of a minimum of 15GB is required for running containers. This may need adjustment depending on the size and number of containers each node will run.

The docker volume is created by the OpenShift Ansible installer via the variable openshift_openstack_docker_volume_size. More information regarding changes required for the OpenShift Ansible installer are described later.

Registry volume

The OpenShift image registry requires a cinder volume to ensure that images are saved in the event that the registry needs to migrate to another node. The following steps show how to create the image registry via OpenStack. Once the volume is created, the volume ID will be included in the OpenShift Ansible Installer OSEv3.yml file via the parameter openshift_hosted_registry_storage_openstack_volumeID as described later.

  1. $ source /path/to/examplerc
  2. $ openstack volume create --size <volume-size-in-GB> <registry-name>
The registry volume size should be at least 30GB.

Verify the creation of the volume.

  1. $ openstack volume list
  2. ----------------------------------------+------------------------------------------------+
  3. | ID | Name | Status | Size | Attached to |
  4. +--------------------------------------+-------------------------------------------------+
  5. | d65209f0-9061-4cd8-8827-ae6e2253a18d | <registry-name>| available | 30 | |
  6. +--------------------------------------+-------------------------------------------------+

Creating and Configuring the Deployment Instance

The role of the deployment instance is to serve as a utility host for the deployment and management of OKD.

Creating the Deployment Host Network and Router

Prior to instance creation, an internal network and router must be created for communication with the deployment host. The following commands create that network and router.

  1. $ source path/to/examplerc
  2. $ openstack network create <deployment-net-name>
  3. $ openstack subnet create --network <deployment-net-name> \
  4. --subnet-range <subnet_range> \
  5. --dns-nameserver <dns-ip> \
  6. <deployment-subnet-name>
  7. $ openstack router create <deployment-router-name>
  8. $ openstack router set --external-gateway <public-net-name> <deployment-router-name>
  9. $ openstack router add subnet <deployment-router-name> <deployment-subnet-name>

Deploying the Deployment Instance

With the network and security group created, deploy the instance.

  1. $ domain=<domain>
  2. $ netid1=$(openstack network show <deployment-net-name> -f value -c id)
  3. $ openstack server create \
  4. --nic net-id=$netid1 \
  5. --flavor <flavor> \
  6. --image <image> \
  7. --key-name <keypair> \
  8. --security-group <deployment-sg-name> \
  9. deployment.$domain
If the m1.small flavor does not exist by default then use an existing flavor that meets the requirements of 1 vCPU and 2GB of RAM.

Creating and Adding Floating IP to the Deployment Instance

Once the deployment instance is created, a floating IP must be created and then allocated to the instance. The following shows an example.

  1. $ source /path/to/examplerc
  2. $ openstack floating ip create <public-network-name>
  3. +---------------------+--------------------------------------+
  4. | Field | Value |
  5. +---------------------+--------------------------------------+
  6. | created_at | 2017-08-24T22:44:03Z |
  7. | description | |
  8. | fixed_ip_address | None |
  9. | floating_ip_address | 10.20.120.150 |
  10. | floating_network_id | 084884f9-d9d2-477a-bae7-26dbb4ff1873 |
  11. | headers | |
  12. | id | 2bc06e39-1efb-453e-8642-39f910ac8fd1 |
  13. | port_id | None |
  14. | project_id | ca304dfee9a04597b16d253efd0e2332 |
  15. | project_id | ca304dfee9a04597b16d253efd0e2332 |
  16. | revision_number | 1 |
  17. | router_id | None |
  18. | status | DOWN |
  19. | updated_at | 2017-08-24T22:44:03Z |
  20. +---------------------+--------------------------------------+

Within the above output, the floating_ip_address field shows that the floating IP 10.20.120.150 is created. In order to assign this IP to the deployment instance, run the following command:

  1. $ source /path/to/examplerc
  2. $ openstack server add floating ip <deployment-instance-name> <ip>

For example, if instance deployment.example.com is to be assigned IP 10.20.120.150 the command would be:

  1. $ source /path/to/examplerc
  2. $ openstack server add floating ip deployment.example.com 10.20.120.150

Adding the RC File to the Deployment Host

Once the deployment host exists, copy the RC file created earlier to the deployment host via scp as follows

  1. scp <rc-file-deployment-host> cloud-user@<ip>:/home/cloud-user/

Deployment Host Configuration for OKD

The following subsections describe all the steps needed to properly configure the deployment instance.

Configure ~/.ssh/config to use Deployment Host as a Jumphost

To easily connect to the OKD environment, follow the steps below.

On the OpenStack director node or local workstation with the private key, .pem:

  1. $ exec ssh-agent bash
  2. $ ssh-add /path/to/<keypair-name>.pem
  3. Identity added: /path/to/<keypair-name>.pem (/path/to/<keypair-name>.pem)

Add to the ~/.ssh/config file:

  1. Host deployment
  2. HostName <deployment_fqdn_hostname OR IP address>
  3. User cloud-user
  4. IdentityFile /path/to/<keypair-name>.pem
  5. ForwardAgent yes

ssh into the deployment host with the -A option that enables forwarding of the authentication agent connection.

Ensure the permissions are read write only for the owner of the ~/.ssh/config file:

  1. $ chmod 600 ~/.ssh/config
  1. $ ssh -A cloud-user@deployment

Once logged into the deployment host, verify the ssh agent forwarding is working via checking for the SSH_AUTH_SOCK

  1. $ echo "$SSH_AUTH_SOCK"
  2. /tmp/ssh-NDFDQD02qB/agent.1387

Subscription Manager and Enabling OKD Repositories

Within the deployment instance, register it with the Red Hat Subscription Manager. This can be accomplished by using credentials:

  1. $ sudo subscription-manager register --username <user> --password '<password>'

Alternatively, you can use an activation key:

  1. $ sudo subscription-manager register --org="<org_id>" --activationkey=<keyname>

Once registered, enable the following repositories as follows.

  1. $ sudo subscription-manager repos \
  2. --enable="rhel-7-server-rpms" \
  3. --enable="rhel-7-server-extras-rpms" \
  4. --enable="rhel-7-server-ose-3.11-rpms" \
  5. --enable="rhel-7-server-ansible-2.6-rpms" \
  6. --enable="rhel-7-server-openstack-13-rpms" \
  7. --enable="rhel-7-server-openstack-13-tools-rpms"

Refer to the Set Up Repositories to confirm the proper OKD repositories and Ansible versions to enable. The above file is just a sample.

Required Packages on the Deployment Host

The following packages are required to be installed on the deployment host.

Install the following packages:

  • openshift-ansible

  • python-openstackclient

  • python2-heatclient

  • python2-octaviaclient

  • python2-shade

  • python-dns

  • git

  • ansible

  1. $ sudo yum -y install openshift-ansible python-openstackclient python2-heatclient python2-octaviaclient python2-shade python-dns git ansible

Configure Ansible

ansible is installed on the deployment instance to perform the registration, installation of packages, and the deployment of the OKD environment on the master and node instances.

Before running playbooks, it is important to create an ansible.cfg file to reflect the environment you wish to deploy:

  1. $ cat ~/ansible.cfg
  2. [defaults]
  3. forks = 20
  4. host_key_checking = False
  5. remote_user = openshift
  6. gathering = smart
  7. fact_caching = jsonfile
  8. fact_caching_connection = $HOME/ansible/facts
  9. fact_caching_timeout = 600
  10. log_path = $HOME/ansible.log
  11. nocows = 1
  12. callback_whitelist = profile_tasks
  13. inventory = /usr/share/ansible/openshift-ansible/playbooks/openstack/inventory.py,/home/cloud-user/inventory
  14. [ssh_connection]
  15. ssh_args = -o ControlMaster=auto -o ControlPersist=600s -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=false
  16. control_path = %(directory)s/%%h-%%r
  17. pipelining = True
  18. timeout = 10
  19. [persistent_connection]
  20. connect_timeout = 30
  21. connect_retries = 30
  22. connect_interval = 1

The following parameters values are important to the ansible.cfg file.

  • The remote_user must remain as the user openshift.

  • The inventory parameter ensure that there is no space between the two inventories.

Example: inventory = path/to/inventory1,path/to/inventory2

The code block above can overwrite the default values in the file. Ensure to populate with the keypair that was copied to the deployment instance.

The inventory folder is created in Preparing the Inventory for Provisioning.

OpenShift Authentication

OKD provides the ability to use many different authentication platforms. A listing of authentication options are available at Configuring Authentication and User Agent.

Configuring the default identity provider is important as the default configuration is to Deny All.

Provisioning OKD Instances using the OpenShift Ansible Playbooks

Once the creation and configuration of the deployment host is complete, we turn to preparing the environment for the deployment of OKD using Ansible. In the following subsections, Ansible is configured and certain YAML files are modified to achieve a successful OKD on OpenStack deployment.

Preparing the Inventory for Provisioning

With the installation of the openshift-ansible package complete via our previous steps, there resides a sample-inventory directory that we will copy to our cloud-user home directory of the deployment host.

On the deployment host,

  1. $ cp -r /usr/share/ansible/openshift-ansible/playbooks/openstack/sample-inventory/ ~/inventory

Within this inventory directory, the all.yml file contains all the different parameters that must be set in to order to achieve successful provisioning of the RHOCP instances. The OSEv3.yml file contains some references required by the all.yml file and all the available OKD cluster parameters that you can customize.

OpenShiftSDN All YAML file

The all.yml file has many options that can be modified to meet your specific needs. The information gathered in this file is for the provisioning portion of the instances required for a successful deployment of OKD. It is important to review these carefully. This document will provide a condensed version of the All YAML file and focus on the most critical parameters that need to be set for a successful deployment.

  1. $ cat ~/inventory/group_vars/all.yml
  2. ---
  3. openshift_openstack_clusterid: "openshift"
  4. openshift_openstack_public_dns_domain: *"example.com"*
  5. openshift_openstack_dns_nameservers: *["10.19.115.228"]*
  6. openshift_openstack_public_hostname_suffix: "-public"
  7. openshift_openstack_nsupdate_zone: "{{ openshift_openstack_public_dns_domain }}"
  8. openshift_openstack_keypair_name: *"openshift"*
  9. openshift_openstack_external_network_name: *"public"*
  10. openshift_openstack_default_image_name: *"rhel75"*
  11. ## Optional (Recommended) - This removes the need for floating IPs
  12. ## on the OpenShift Cluster nodes
  13. openshift_openstack_node_subnet_name: *<deployment-subnet-name>*
  14. openshift_openstack_router_name: *<deployment-router-name>*
  15. openshift_openstack_master_floating_ip: *false*
  16. openshift_openstack_infra_floating_ip: *false*
  17. openshift_openstack_compute_floating_ip: *false*
  18. ## End of Optional Floating IP section
  19. openshift_openstack_num_masters: *3*
  20. openshift_openstack_num_infra: *3*
  21. openshift_openstack_num_cns: *0*
  22. openshift_openstack_num_nodes: *2*
  23. openshift_openstack_master_flavor: *"m1.master"*
  24. openshift_openstack_default_flavor: *"m1.node"*
  25. openshift_openstack_use_lbaas_load_balancer: *true*
  26. openshift_openstack_docker_volume_size: "15"
  27. # # Roll-your-own DNS
  28. *openshift_openstack_external_nsupdate_keys:*
  29. public:
  30. *key_secret: '/alb8h0EAFWvb4i+CMA12w=='*
  31. *key_name: "update-key"*
  32. *key_algorithm: 'hmac-md5'*
  33. *server: '<ip-of-DNS>'*
  34. private:
  35. *key_secret: '/alb8h0EAFWvb4i+CMA12w=='*
  36. *key_name: "update-key"*
  37. *key_algorithm: 'hmac-md5'*
  38. *server: '<ip-of-DNS>'*
  39. ansible_user: openshift
  40. ## cloud config
  41. openshift_openstack_disable_root: true
  42. openshift_openstack_user: openshift
Due to using an external DNS server, the private and public sections use the public IP address of the DNS server as the DNS server does not reside in the OpenStack environment.

The values above that are enclosed by asterisks (*) require modification based upon your OpenStack environment and DNS server.

In order to properly modify the DNS portion of the All YAML file, login to the DNS server and perform the following commands to capture the key name, key algorithm and key secret:

  1. $ ssh <ip-of-DNS>
  2. $ sudo -i
  3. # cat /etc/named/<key-name.key>
  4. key "update-key" {
  5. algorithm hmac-md5;
  6. secret "/alb8h0EAFWvb4i+CMA02w==";
  7. };
The key name may vary and the above is only an example.

KuryrSDN All YAML file

The following all.yml file enables Kuryr SDN instead of the default OpenShiftSDN. Note that the example below is a condensed version and it is important to review the default template carefully.

  1. $ cat ~/inventory/group_vars/all.yml
  2. ---
  3. openshift_openstack_clusterid: "openshift"
  4. openshift_openstack_public_dns_domain: *"example.com"*
  5. openshift_openstack_dns_nameservers: *["10.19.115.228"]*
  6. openshift_openstack_public_hostname_suffix: "-public"
  7. openshift_openstack_nsupdate_zone: "{{ openshift_openstack_public_dns_domain }}"
  8. openshift_openstack_keypair_name: *"openshift"*
  9. openshift_openstack_external_network_name: *"public"*
  10. openshift_openstack_default_image_name: *"rhel75"*
  11. ## Optional (Recommended) - This removes the need for floating IPs
  12. ## on the OpenShift Cluster nodes
  13. openshift_openstack_node_subnet_name: *<deployment-subnet-name>*
  14. openshift_openstack_router_name: *<deployment-router-name>*
  15. openshift_openstack_master_floating_ip: *false*
  16. openshift_openstack_infra_floating_ip: *false*
  17. openshift_openstack_compute_floating_ip: *false*
  18. ## End of Optional Floating IP section
  19. openshift_openstack_num_masters: *3*
  20. openshift_openstack_num_infra: *3*
  21. openshift_openstack_num_cns: *0*
  22. openshift_openstack_num_nodes: *2*
  23. openshift_openstack_master_flavor: *"m1.master"*
  24. openshift_openstack_default_flavor: *"m1.node"*
  25. ## Kuryr configuration
  26. openshift_use_kuryr: True
  27. openshift_use_openshift_sdn: False
  28. use_trunk_ports: True
  29. os_sdn_network_plugin_name: cni
  30. openshift_node_proxy_mode: userspace
  31. kuryr_openstack_pool_driver: nested
  32. openshift_kuryr_precreate_subports: 5
  33. kuryr_openstack_public_net_id: *<public_ID>*
  34. # To disable namespace isolation, comment out the next 2 lines
  35. openshift_kuryr_subnet_driver: namespace
  36. openshift_kuryr_sg_driver: namespace
  37. # If you enable namespace isolation, `default` and `openshift-monitoring` become the
  38. # global namespaces. Global namespaces can access all namespaces. All
  39. # namespaces can access global namespaces.
  40. # To make other namespaces global, include them here:
  41. kuryr_openstack_global_namespaces: default,openshift-monitoring
  42. # If OpenStack cloud endpoints are accessible over HTTPS, provide the CA certificate
  43. kuryr_openstack_ca: *<path-to-ca-certificate>*
  44. openshift_master_open_ports:
  45. - service: dns tcp
  46. port: 53/tcp
  47. - service: dns udp
  48. port: 53/udp
  49. openshift_node_open_ports:
  50. - service: dns tcp
  51. port: 53/tcp
  52. - service: dns udp
  53. port: 53/udp
  54. # End of Kuryr configuration
  55. openshift_openstack_use_lbaas_load_balancer: *true*
  56. openshift_openstack_docker_volume_size: "15"
  57. # # Roll-your-own DNS
  58. *openshift_openstack_external_nsupdate_keys:*
  59. public:
  60. *key_secret: '/alb8h0EAFWvb4i+CMA12w=='*
  61. *key_name: "update-key"*
  62. *key_algorithm: 'hmac-md5'*
  63. *server: '<ip-of-DNS>'*
  64. private:
  65. *key_secret: '/alb8h0EAFWvb4i+CMA12w=='*
  66. *key_name: "update-key"*
  67. *key_algorithm: 'hmac-md5'*
  68. *server: '<ip-of-DNS>'*
  69. ansible_user: openshift
  70. ## cloud config
  71. openshift_openstack_disable_root: true
  72. openshift_openstack_user: openshift

If you are using namespace isolation, the Kuryr-controller creates a new Neutron network and subnet for each namespace.

Network policies and nodeport services are not supported when Kuryr SDN is enabled.

If Kuryr is enabled, OKD services are implemented through OpenStack Octavia Amphora VMs.

Octavia does not support UDP load balancing. Services that expose UDP ports are not supported.

Configuring global namespace access

The kuryr_openstack_global_namespace parameter contains a list that defines global namespaces. By default, only the default and openshift-monitoring namespaces are included in this list.

If you are upgrading from a previous z-release of OKD 3.11, note that access to other namespaces from global namespaces is controlled by the security group *-allow_from_default.

Although the remote_group_id rule can control access to other namespaces from global namespaces, using it can cause scaling and connectivity problems. To avoid these problems, switch from using remote_group_id at *_allow_from_default to remote_ip_prefix:

  1. From a command line, retrieve your networks’ subnetCIDR value:

    1. $ oc get kuryrnets ns-default -o yaml | grep subnetCIDR
    2. subnetCIDR: 10.11.13.0/24
  2. Create TCP and UDP rules for this range:

    1. $ openstack security group rule create --remote-ip 10.11.13.0/24 --protocol tcp openshift-ansible-openshift.example.com-allow_from_default
    2. $ openstack security group rule create --remote-ip 10.11.13.0/24 --protocol udp openshift-ansible-openshift.example.com-allow_from_default
  3. Remove the security group rule that uses remote_group_id:

    1. $ openstack security group show *-allow_from_default | grep remote_group_id
    2. $ openstack security group rule delete REMOTE_GROUP_ID
Table 4. Description of Variables in the All YAML file
VariableDescription

openshift_openstack_clusterid

Cluster identification name

openshift_openstack_public_dns_domain

Public DNS domain name

openshift_openstack_dns_nameservers

IP of DNS nameservers

openshift_openstack_public_hostname_suffix

Adds a suffix to the node hostname in the DNS record for both public and private

openshift_openstack_nsupdate_zone

Zone to be updated with OCP instance IPs

openshift_openstack_keypair_name

Keypair name used to log into OCP instances

openshift_openstack_external_network_name

OpenStack public network name

openshift_openstack_default_image_name

OpenStack image used for OCP instances

openshift_openstack_num_masters

Number of master nodes to deploy

openshift_openstack_num_infra

Number of infrastructure nodes to deploy

openshift_openstack_num_cns

Number of container native storage nodes to deploy

openshift_openstack_num_nodes

Number of application nodes to deploy

openshift_openstack_master_flavor

Name of the OpenStack flavor used for master instances

openshift_openstack_default_flavor

Name of the Openstack flavor used for all instances, if specific flavor not specified.

openshift_openstack_use_lbaas_load_balancer

Boolean value enabling Octavia load balancer (Octavia must be installed)

openshift_openstack_docker_volume_size

Minimum size of the Docker volume (required variable)

openshift_openstack_external_nsupdate_keys

Updating the DNS with the instance IP addresses

ansible_user

Ansible user used to deploy OKD. “openshift” is the required name and must not be changed.

openshift_openstack_disable_root

Boolean value that disables root access

openshift_openstack_user

OCP instances created with this user

openshift_openstack_node_subnet_name

Name of existing OpenShift subnet to use for deployment. This should be the same subnet name used for your deployment host.

openshift_openstack_router_name

Name of existing OpenShift router to use for deployment. This should be the same router name used for your deployment host.

openshift_openstack_master_floating_ip

Default is true. Must set to false if you do not want floating IPs assigned to master nodes.

openshift_openstack_infra_floating_ip

Default is true. Must set to false if you do not want floating IPs assigned to infrastructure nodes.

openshift_openstack_compute_floating_ip

Default is true. Must set to false if you do not want floating IPs assigned to compute nodes.

openshift_use_openshift_sdn

Must set to false if you want to disable openshift-sdn

openshift_use_kuryr

Must set to true if you want to enable kuryr sdn

use_trunk_ports

Must be set to true to create the OpenStack VMs with trunk ports (required by kuryr)

os_sdn_network_plugin_name

selection of the SDN behavior. Must set to cni for kuryr

openshift_node_proxy_mode

Must set to userspace for Kuryr

openshift_master_open_ports

Ports to be opened on the VMs when using Kuryr

kuryr_openstack_public_net_id

Need by Kuryr. ID of the public OpenStack network from where FIPs are obtained

openshift_kuryr_subnet_driver

Kuryr Subnet driver. Must be namespace for creating a subnet per namespace

openshift_kuryr_sg_driver

Kuryr Security Group driver. Must be namespace for namespace isolation

kuryr_openstack_global_namespaces

Global namespaces to use for namespace isolation. The default values are default, openshift-monitoring.

kuryr_openstack_ca

Path to the CA certificate of the cloud. Required if OpenStack cloud endpoints are accessible over HTTPS.

OSEv3 YAML file

The OSEv3 YAML file file specifies all the different parameters and customizations relating the installation of OpenShift.

Below is a condensed version of the file with all required variables for a successful deployment. Additional variables may be required depending on what customization is required for your specific OKD deployment.

  1. $ cat ~/inventory/group_vars/OSEv3.yml
  2. ---
  3. openshift_deployment_type: openshift-enterprise
  4. openshift_release: v3.11
  5. oreg_url: registry.access.redhat.com/openshift3/ose-${component}:${version}
  6. openshift_examples_modify_imagestreams: true
  7. oreg_auth_user: <oreg_auth_user>
  8. oreg_auth_password: <oreg_auth_pw>
  9. # The following is required if you want to deploy the Operator Lifecycle Manager (OLM)
  10. openshift_additional_registry_credentials: [{'host':'registry.connect.redhat.com','user':'REGISTRYCONNECTUSER','password':'REGISTRYCONNECTPASSWORD','test_image':'mongodb/enterprise-operator:0.3.2'}]
  11. openshift_master_default_subdomain: "apps.{{ (openshift_openstack_clusterid|trim == '') | ternary(openshift_openstack_public_dns_domain, openshift_openstack_clusterid + '.' + openshift_openstack_public_dns_domain) }}"
  12. openshift_master_cluster_public_hostname: "console.{{ (openshift_openstack_clusterid|trim == '') | ternary(openshift_openstack_public_dns_domain, openshift_openstack_clusterid + '.' + openshift_openstack_public_dns_domain) }}"
  13. #OpenStack Credentials:
  14. openshift_cloudprovider_kind: openstack
  15. openshift_cloudprovider_openstack_auth_url: "{{ lookup('env','OS_AUTH_URL') }}"
  16. openshift_cloudprovider_openstack_username: "{{ lookup('env','OS_USERNAME') }}"
  17. openshift_cloudprovider_openstack_password: "{{ lookup('env','OS_PASSWORD') }}"
  18. openshift_cloudprovider_openstack_tenant_name: "{{ lookup('env','OS_PROJECT_NAME') }}"
  19. openshift_cloudprovider_openstack_blockstorage_version: v2
  20. openshift_cloudprovider_openstack_domain_name: "{{ lookup('env','OS_USER_DOMAIN_NAME') }}"
  21. openshift_cloudprovider_openstack_conf_file: <path_to_local_openstack_configuration_file>
  22. #Use Cinder volume for Openshift registry:
  23. openshift_hosted_registry_storage_kind: openstack
  24. openshift_hosted_registry_storage_access_modes: ['ReadWriteOnce']
  25. openshift_hosted_registry_storage_openstack_filesystem: xfs
  26. openshift_hosted_registry_storage_volume_size: 30Gi
  27. openshift_hosted_registry_storage_openstack_volumeID: d65209f0-9061-4cd8-8827-ae6e2253a18d
  28. openshift_hostname_check: false
  29. ansible_become: true
  30. #Setting SDN (defaults to ovs-networkpolicy) not part of OSEv3.yml
  31. #For more info, on which to choose, visit:
  32. #https://docs.openshift.com/container-platform/3.11/architecture/networking/sdn.html#overview
  33. networkPluginName: redhat/ovs-networkpolicy
  34. #networkPluginName: redhat/ovs-multitenant
  35. #Configuring identity providers with Ansible
  36. #For initial cluster installations, the Deny All identity provider is configured
  37. #by default. It is recommended to be configured with either htpasswd
  38. #authentication, LDAP authentication, or Allowing all authentication (not recommended)
  39. #For more info, visit:
  40. #https://docs.openshift.com/container-platform/3.10/install_config/configuring_authentication.html#identity-providers-ansible
  41. #Example of Allowing All
  42. #openshift_master_identity_providers: [{'name': 'allow_all', 'login': 'true', 'challenge': 'true', 'kind': 'AllowAllPasswordIdentityProvider'}]
  43. #Optional Metrics (uncomment below lines for installation)
  44. #openshift_metrics_install_metrics: true
  45. #openshift_metrics_cassandra_storage_type: dynamic
  46. #openshift_metrics_storage_volume_size: 25Gi
  47. #openshift_metrics_cassandra_nodeselector: {"node-role.kubernetes.io/infra":"true"}
  48. #openshift_metrics_hawkular_nodeselector: {"node-role.kubernetes.io/infra":"true"}
  49. #openshift_metrics_heapster_nodeselector: {"node-role.kubernetes.io/infra":"true"}
  50. #Optional Aggregated Logging (uncomment below lines for installation)
  51. #openshift_logging_install_logging: true
  52. #openshift_logging_es_pvc_dynamic: true
  53. #openshift_logging_es_pvc_size: 30Gi
  54. #openshift_logging_es_cluster_size: 3
  55. #openshift_logging_es_number_of_replicas: 1
  56. #openshift_logging_es_nodeselector: {"node-role.kubernetes.io/infra":"true"}
  57. #openshift_logging_kibana_nodeselector: {"node-role.kubernetes.io/infra":"true"}
  58. #openshift_logging_curator_nodeselector: {"node-role.kubernetes.io/infra":"true"}

For further details on any of the variables listed, see an example OpenShift-Ansible host inventory.

OpenStack Prerequisites Playbook

The OKD Ansible Installer provides a playbook to ensure all the provisioning steps of the OpenStack instances have been met.

Prior to running the playbook, ensure to source the RC file

  1. $ source path/to/examplerc

Via the ansible-playbook command on the deployment host, ensure all the prerequisites are met using prerequisites.yml playbook:

  1. $ ansible-playbook /usr/share/ansible/openshift-ansible/playbooks/openstack/openshift-cluster/prerequisites.yml

Once the prerequisite playbook completes successfully, run the provision playbook as follows:

  1. $ ansible-playbook /usr/share/ansible/openshift-ansible/playbooks/openstack/openshift-cluster/provision.yml

If provision.yml prematurely errors, check if the status of the OpenStack stack and wait for it finish

  1. $ watch openstack stack list
  2. +———————————————————+—————————-+——————————+———————————+———————+
  3. | ID | Stack Name | Stack Status | Creation Time | Updated Time |
  4. +———————————————————+—————————-+——————————+———————————+———————+
  5. | 87cb6d1c-8516-40fc-892b-49ad5cb87fac | openshift-cluster | CREATE_IN_PROGRESS | 2018-08-20T23:44:46Z | None |
  6. +———————————————————+—————————-+——————————+———————————+———————+

If the stack shows a CREATE_IN_PROGRESS, wait for the stack to complete with a final result such as CREATE_COMPLETE. If the stack does complete successfully, re-run the provision.yml playbook for it to finish all the additional required steps.

If the stack shows a CREATE_FAILED, make sure to run the following command to see what caused the errors:

  1. $ openstack stack failures list openshift-cluster

Stack Name Configuration

By default, the Heat stack that is created by OpenStack for the OKD cluster is named openshift-cluster. If you want to use a different name then you must set the OPENSHIFT_CLUSTER environment variable before running the playbooks:

  1. $ export OPENSHIFT_CLUSTER=openshift.example.com

If you use a non-default stack name and run the openshift-ansible playbooks to update your deployment, you must set OPENSHIFT_CLUSTER to your stack name to avoid errors.

Registering with Subscription Manager the OKD Instances

With the nodes successfully provisioned, the next step is to ensure all the nodes are successfully registered via subscription-manager to install all the required packages for a successful OKD installation. For simplicity, a repos.yml file has been created and provided.

  1. $ cat ~/repos.yml
  2. ---
  3. - name: Enable the proper repositories for OpenShift installation
  4. hosts: OSEv3
  5. become: yes
  6. tasks:
  7. - name: Register with activationkey and consume subscriptions matching Red Hat Cloud Suite or Red Hat OpenShift Container Platform
  8. redhat_subscription:
  9. state: present
  10. activationkey: <key-name>
  11. org_id: <orig_id>
  12. pool: '^(Red Hat Cloud Suite|Red Hat OpenShift Container Platform)$'
  13. - name: Disable all current repositories
  14. rhsm_repository:
  15. name: '*'
  16. state: disabled
  17. - name: Enable Repositories
  18. rhsm_repository:
  19. name: "{{ item }}"
  20. state: enabled
  21. with_items:
  22. - rhel-7-server-rpms
  23. - rhel-7-server-extras-rpms
  24. - rhel-7-server-ansible-2.6-rpms
  25. - rhel-7-server-ose-3.11-rpms

Refer to the Set Up Repositories to confirm the proper repositories and versions to enable. The above file is just a sample.

With the repos.yml, run the ansible-playbook command:

  1. $ ansible-playbook repos.yml

The above example uses Ansible’s redhat_subscription and rhsm_repository modules for all registration, disabling and enabling of repositories. This specific example takes advantage of using a Red Hat activation key. If you don’t have an activation key, ensure to visit the Ansible redhat_subscription module to modify using a username and password instead as shown in the examples: https://docs.ansible.com/ansible/2.6/modules/redhat_subscription_module.html

At times, the redhat_subscription module may fail on certain nodes. If this issue occurs, please manually register that OKD instance using subscription-manager.

Installing OKD by Using an Ansible Playbook

With the OpenStack instances provisioned, the focus shifts to the installation OKD. The installation and configuration is done via a series of Ansible playbooks and roles provided by the OpenShift RPM packages. Review the OSEv3.yml file that was previous configured to ensure all the options have been properly set.

Prior to running the installer playbook, ensure all the {rhocp} prerequisites are met via:

  1. $ ansible-playbook /usr/share/ansible/openshift-ansible/playbooks/prerequisites.yml

Run the installer playbook to install Red Hat OpenShift Container Platform:

  1. $ ansible-playbook /usr/share/ansible/openshift-ansible/playbooks/openstack/openshift-cluster/install.yml

OKD version 3.11 is supported on RH OSP 14 and RH OSP 13. OKD version 3.10 is supported on RH OSP 13.

Applying Configuration Changes to Existing OKD Environment

Start or restart OKD services on all master and node hosts to apply your configuration changes, see Restarting OKD services:

  1. # master-restart api
  2. # master-restart controllers
  3. # systemctl restart atomic-openshift-node

Kubernetes architecture expects reliable endpoints from cloud providers. When a cloud provider is down, the kubelet prevents OKD from restarting. If the underlying cloud provider endpoints are not reliable, do not install a cluster that uses the cloud provider integration. Install the cluster as if it is a bare metal environment. It is not recommended to toggle cloud provider integration on or off in an installed cluster. However, if that scenario is unavoidable, then complete the following process.

Switching from not using a cloud provider to using a cloud provider produces an error message. Adding the cloud provider tries to delete the node because the node switches from using the hostname as the **externalID** (which would have been the case when no cloud provider was being used) to using the cloud provider’s **instance-id** (which is what the cloud provider specifies). To resolve this issue:

  1. Log in to the CLI as a cluster administrator.

  2. Check and back up existing node labels:

    1. $ oc describe node <node_name> | grep -Poz '(?s)Labels.*\n.*(?=Taints)'
  3. Delete the nodes:

    1. $ oc delete node <node_name>
  4. On each node host, restart the OKD service.

    1. # systemctl restart origin-node
  5. Add back any labels on each node that you previously had.

Configuring OpenStack Variables on an existing OpenShift Environment

To set the required OpenStack variables, modify the /etc/origin/cloudprovider/openstack.conf file with the following contents on all of your OKD hosts, both masters and nodes:

  1. [Global]
  2. auth-url = <OS_AUTH_URL>
  3. username = <OS_USERNAME>
  4. password = <password>
  5. domain-id = <OS_USER_DOMAIN_ID>
  6. tenant-id = <OS_TENANT_ID>
  7. region = <OS_REGION_NAME>
  8. [LoadBalancer]
  9. subnet-id = <UUID of the load balancer subnet>

Consult your OpenStack administrators for values of the **OS_** variables, which are commonly used in OpenStack configuration.

Configuring Zone Labels for Dynamically Created OpenStack PVs

Administrators can configure zone labels for dynamically created OpenStack PVs. This option is useful if the OpenStack Cinder zone name does not match the compute zone names, for example, if there is only one Cinder zone and many compute zones. Administrators can create Cinder volumes dynamically and then check the labels.

To view the zone labels for the PVs:

  1. # oc get pv --show-labels
  2. NAME CAPACITY ACCESS MODES RECLAIM POLICY STATUS CLAIM STORAGECLASS REASON AGE LABELS
  3. pvc-1faa6f93-64ac-11e8-930c-fa163e3c373c 1Gi RWO Delete Bound openshift-node/pvc1 standard 12s failure-domain.beta.kubernetes.io/zone=nova

The default setting is enabled. Using the oc get pv --show-labels command returns the failure-domain.beta.kubernetes.io/zone=nova label.

To disable the zone label, update the openstack.conf file by adding:

  1. [BlockStorage]
  2. ignore-volume-az = yes

The PVs created after restarting the master services will not have the zone label.