Skip to main content

Installing OpenShift on Azure

Hands-On Lab


Photo of Jesse Hoch

Jesse Hoch

DevOps Training Architect II





In this lab you will be running the Ansible playbooks to install OpenShift on your cluster from your bastion host. Once installed you will have a funtional OpenShift cluster in Azure.

What are Hands-On Labs?

Hands-On Labs are scenario-based learning environments where learners can practice without consequences. Don't compromise a system or waste money on expensive downloads. Practice real-world skills without the real-world risk, no assembly required.

Install OpenShift and Connect


In this hands-on lab, we will need to install the necessary packages and configure the bastion host to run the OpenShift installation playbooks.


Log in to the Azure Portal using the credentials provided on the lab instructions page.

Configure Cloud Shell

  1. If prompted with a Welcome to Microsoft Azure get started window, click Maybe layer.

  2. On the left-hand side navigation menu, click All Resources.

  3. Let's set up Cloud Shell by clicking the Cloud Shell button in the top-right corner of the screen:

    !["Azure Cloud Shell"]( "Azure Cloud Shell")

  4. Begin configuring the Cloud Shell, click Bash.

  5. Leave the default for the storage mounted window.

  6. Click Show advanced settings.

  7. Leave the existing subscription, resource group, and storage account.

    Note: If the storage account does not populate, ensure that South Central US is selected for the Cloud Shell region field .

  8. Under Storage account, click the radio button for Use existing.

  9. Under File share, choose the radio button Create new and specify okdcloudshell as the new file share.

  10. Click Create Storage.

    Note: We should see a status of Cloud Shell.Succeeded.

Download SSH Keys for the Lab

  1. We will need to pull down the SSH keys to be able connect to the VMs using SSH. First, make the .ssh directory, if it isn't already there, with:

    mkdir .ssh
  2. Then, cd into the directory with:

    cd .ssh
  3. Pull down the SSH private key, and then the public key with the following commands and links:

  4. Check the files with:

  5. Set the correct permissions with:

    chmod 600 id_rsa*

Reset the SSH public key for each VM

  1. Use cd to go back to our home directory.
  2. On the left-hand side navigation menu, click Virtual machines.
  3. Click bastionVM-0.
  4. Scroll down till you see Support + troubleshooting.
  5. Click Reset password.
  6. Make sure Reset SSH public key is selected.
  7. In the username field, type azureuser
  8. Copy the contents of your file and past it in the SSH public key field.
  9. Click update and then click it again.
  10. Now repeat these steps for the other VMs.

SSH to the bastion node

  1. Go back to the overview of your bastionVM-0
  2. Click the Connect button.
  3. On the Connect to virtual machine window, click the "Copy to clipboard" icon button for the Login using VM local account section.
  4. Paste it into the Bash environment terminal. It should look similar to this:

    ssh azureuser@
  5. Type y for yes when asked to continue connecting.

Install the Necessary Packages for the OpenShift Installation

  1. Install the centos-release-openshift-origin package:

    sudo yum -y install centos-release-openshift-origin
  2. Install the openshift-ansible package:

    sudo yum -y install openshift-ansible docker

    Configure Docker

  3. We will need to add the following options to /etc/sysconfig/docker:

    sudo sed -i -e "s#^OPTIONS='--selinux-enabled'#OPTIONS='--selinux-enabled --insecure-registry'#" /etc/sysconfig/docker
  4. Next, we will enable docker-cleanup, and then Docker:

    sudo systemctl enable docker-cleanup
    sudo systemctl enable docker
  5. Start the Docker service:

    sudo systemctl start docker

Create Your Inventory File

  1. Use the inventory file from the Git repo to create and inventory file for the OpenShift installation. We will find the inventory file at this link:

  2. We will need to copy this to /etc/ansible/hosts with:

    sudo vim /etc/ansible/hosts
  3. Verify that no errors will be encountered:

    sudo chmod -R 777 /usr/share/ansible/openshift-ansible/playbooks
  4. Navigate to the directory:

    cd /usr/share/ansible/openshift-ansible/playbooks

Install OpenShift

  1. Use Ansible to run the prerequisites.yml and the deploy_cluster.yml playbooks to install OpenShift:

    ansible-playbook prerequisites.yml
    ansible-playbook deploy_cluster.yml

    Note: The deploy_cluster.yml playbook may take approximately 30 minutes to complete.

  1. The install may get hung, but a retry file is created for us and can be used like so to run it again:

    ansible-playbook deploy_cluster.yml --limit @/usr/share/ansible/openshift-ansible/playbooks/deploy_cluster.retry
  2. Use exit to logout of the bastion host.
  3. Click Virtual machines in the left-hand side menu in the Microsoft Azure portal.
  4. Click masterVM-0.
  5. Click Connect.
  6. On the Connect to virtual machine window, click the "Copy to clipboard" icon button for the Login using VM local account section for the SSH command.
  7. Paste the SSH command into the Bash environment terminal, that look like this:

    ssh azureuser@
  8. Check the nodes:

    oc get nodes

    Note: We should see a STATUS of Ready.


Congratulations — you've completed this hands-on lab!