Deploy a Microsoft Azure Red Hat OpenShift cluster

• Setting environment variables and resource groups
• Creating a virtual network with two empty subnets 
• Creating your cluster

• Completed all prerequisites

1. Sign into the Azure CLI by running az login and following the steps to authorize your account. 
2. Set the following environment variables. You can change the values to suit your environment, but these defaults should work.

   AZR_RESOURCE_LOCATION=eastus # the location of your cluster
   AZR_RESOURCE_GROUP=openshift # the name of the resource group where you want to create your cluster
   AZR_CLUSTER=cluster # the name of your cluster
   AZR_PULL_SECRET=~/Downloads/pull-secret.txt # the download file of your Red Hat pull secret

3. Create an Azure resource group.

   az group create \
     --name $AZR_RESOURCE_GROUP \
     --location $AZR_RESOURCE_LOCATION

Create a virtual network with two empty subnets.

1. Create the virtual network.

   az network vnet create \
     --address-prefixes 10.0.0.0/22 \
     --name "$AZR_CLUSTER-aro-vnet-$AZR_RESOURCE_LOCATION" \
     --resource-group $AZR_RESOURCE_GROUP

2. Create the control plane subnet.

   az network vnet subnet create \
     --resource-group $AZR_RESOURCE_GROUP \
     --vnet-name "$AZR_CLUSTER-aro-vnet-$AZR_RESOURCE_LOCATION" \
     --name "$AZR_CLUSTER-aro-control-subnet-$AZR_RESOURCE_LOCATION" \
     --address-prefixes 10.0.0.0/23 \
     --service-endpoints Microsoft.ContainerRegistry

3. Create the machine subnet.

   az network vnet subnet create \
     --resource-group $AZR_RESOURCE_GROUP \
     --vnet-name "$AZR_CLUSTER-aro-vnet-$AZR_RESOURCE_LOCATION" \
     --name "$AZR_CLUSTER-aro-machine-subnet-$AZR_RESOURCE_LOCATION" \
     --address-prefixes 10.0.2.0/23 \
     --service-endpoints Microsoft.ContainerRegistry

4. Disable network policies on the control plane subnet. This is required for the service to be able to connect to and manage the cluster.

   az network vnet subnet update \
     --name "$AZR_CLUSTER-aro-control-subnet-$AZR_RESOURCE_LOCATION" \
     --resource-group $AZR_RESOURCE_GROUP \
     --vnet-name "$AZR_CLUSTER-aro-vnet-$AZR_RESOURCE_LOCATION" \
     --disable-private-link-service-network-policies true

This process will take between 30 and 45 minutes to create the cluster.

1. Create your cluster.

   az aro create \
     --resource-group $AZR_RESOURCE_GROUP \
     --name $AZR_CLUSTER \
     --vnet "$AZR_CLUSTER-aro-vnet-$AZR_RESOURCE_LOCATION" \
     --master-subnet "$AZR_CLUSTER-aro-control-subnet-$AZR_RESOURCE_LOCATION" \
     --worker-subnet "$AZR_CLUSTER-aro-machine-subnet-$AZR_RESOURCE_LOCATION" \
     --pull-secret @$AZR_PULL_SECRET

2. Get the OpenShift console URL.

   az aro show \
     --name $AZR_CLUSTER \
     --resource-group $AZR_RESOURCE_GROUP \
     -o tsv --query consoleProfile

3. Get your OpenShift credentials.

   az aro list-credentials \
     --name $AZR_CLUSTER \
     --resource-group $AZR_RESOURCE_GROUP \
     -o tsv

4. Use the URL and the credentials provided by the output of the last two commands to log into OpenShift via a web browser. Here, you can monitor and update your cluster as needed.

Once these steps are complete, your cluster is ready for application deployment, which you can do in the OpenShift console or via the CLI. 

Next, however, we’ll show you how to delete your cluster and resource group so you aren’t surprised with any unnecessary charges.

• Troubleshoot with Red Hat support
• Troubleshoot with Microsoft Azure support