ARO Quickstart

A Quickstart guide to deploying an Azure Red Hat OpenShift cluster.

Video Walkthrough

If you prefer a more visual medium, you can watch Paul Czarkowski walk through this quickstart on YouTube .

Prerequisites

Azure CLI

Obviously you’ll need to have an Azure account to configure the CLI against.

MacOS

1. Install Azure CLI using homebrew

Linux

1. Import the Microsoft Keys

2. Add the Microsoft Yum Repository

3. Install Azure CLI

Prepare Azure Account for Azure OpenShift

1. Log into the Azure CLI by running the following and then authorizing through your Web Browser

2. Make sure you have enough Quota (change the location if you’re not using East US)

   see Addendum - Adding Quota to ARO account if you have less than 36 Quota left for Total Regional vCPUs.

3. Register resource providers

Get Red Hat pull secret

1. Log into https://console.redhat.com

2. Browse to https://console.redhat.com/openshift/install/azure/aro-provisioned

3. click the Download pull secret button and remember where you saved it, you’ll reference it later.

Deploy Azure OpenShift

Variables and Resource Group

Set some environment variables to use later, and create an Azure Resource Group.

1. Set the following environment variables

   Change the values to suit your environment, but these defaults should work.

2. Create an Azure resource group

Networking

Create a virtual network with two empty subnets

1. Create virtual network

2. Create control plane subnet

3. Create machine subnet

4. Disable network policies for Private Link Service on the control plane subnet

   Optional. The ARO RP will disable this for you if you skip this step.

5. Create the cluster

   This will take between 30 and 45 minutes.

6. Get OpenShift console URL

7. Get OpenShift credentials

8. Use the URL and the credentials provided by the output of the last two commands to log into OpenShift via a web browser.

1. Deploy an application to OpenShift

   See the following video for a guide on easy application deployment on OpenShift.

Delete Cluster

Once you’re done its a good idea to delete the cluster to ensure that you don’t get a surprise bill.

1. Delete the cluster

2. Delete the Azure resource group

   Only do this if there’s nothing else in the resource group.

Adendum

Adding Quota to ARO account

1. Create an Azure Support Request

2. Set Issue Type to “Service and subscription limits (quotas)”

3. Set Quota Type to “Compute-VM (cores-vCPUs) subscription limit increases”

4. Click Next Solutions »

5. Click Enter details

6. Set Deployment Model to “Resource Manager

7. Set Locations to “(US) East US”

8. Set Types to “Standard”

9. Under Standard check “DSv3” and “DSv4”

10. Set New vCPU Limit for each (example “60”)

11. Click Save and continue

12. Click Review + create »

13. Wait until quota is increased.