Getting started with Microsoft Azure Red Hat OpenShift

Learn how to get started on Microsoft Azure Red Hat® OpenShift®, including how to prepare your environment, deploy a cluster, and connect to your cluster.

You can also watch this interactive demonstration on how to install Azure Red Hat OpenShift and create a cluster.

Learn how to get started on Microsoft Azure Red Hat® OpenShift®, including how to prepare your environment, deploy a cluster, and connect to your cluster.

You can also watch this interactive demonstration on how to install Azure Red Hat OpenShift and create a cluster.

Requirements for Microsoft Azure Red Hat OpenShift

10 mins

Before deploying your Microsoft Azure Red Hat® OpenShift® cluster, you’ll need to complete a few steps to prepare your accounts and environment. 

What will you learn?

  • Setting up your accounts
  • Installing the Azure CLI
  • Verifying quotas
  • Setting up resource providers and pull requests

What do you need before starting?

Setting up your accounts

  1. If you don’t already have a Microsoft Azure account, sign up at https://azure.microsoft.com.
  2. In order to create a resource provider in the next steps (which gives you the virtual network needed for your cluster), you’ll need to verify you have certain permissions with Azure Red Hat OpenShift by using Azure Active Directory (Azure AD) in the Azure portal
    1. Check for Contributor and User Access Administrator permissions or Owner permissions, either directly on the virtual network, the resource group, or the subscription containing it. Instructions for viewing your role assignments can be found here.
    2. You'll also need sufficient Azure Active Directory permissions, either a member user of the tenant, or a guest assigned with role Application administrator. Instructions for assigning permissions can be found here

Install the Azure CLI

  1. For Linux systems
    1. Import the Microsoft Keys
      sudo rpm --import 
      https://packages.microsoft.com/keys/microsoft.asc
    2. Add the Microsoft Yum Repository. 
      cat << EOF | sudo tee /etc/yum.repos.d/azure-cli.repo
      [azure-cli]
      name=Azure CLI
      baseurl=https://packages.microsoft.com/yumrepos/azure-cli
      enabled=1
      gpgcheck=1
      gpgkey=https://packages.microsoft.com/keys/microsoft.asc
      EOF
    3. Install the Azure CLI. 
      sudo dnf install -y azure-cli
  2. For Microsoft systems: You can install the Azure CLI one of two ways: download the Microsoft Installer (MSI) file or install using PowerShell.
    1. If you would like to install via the MSI, download the latest version of the Azure CLI here.
    2. If using PowerShell, you can run:
      $ProgressPreference = 'SilentlyContinue'; 
      Invoke-WebRequest -Uri https://aka.ms/installazurecliwindows -OutFile .\AzureCLI.msi; 
      Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'; 
      Remove-Item .\AzureCLI.msi

      Note: PowerShell must be run as an administrator.
  3. For MacOS systemsInstall the Azure CLI using homebrew. 
    brew update && brew install azure-cli

     

Verify quotas

  1. Log in to the Azure CLI by running az login. This will open a web browser where you can authorize your Microsoft account.
  2. Verify you have the correct number of Azure resource quotas, in this case Total Regional vCPUs. Change the location if you’re not using “East US.”
    az vm list-usage --location "East US" -o table
  3. Azure Red Hat OpenShift requires at least 40 cores to create and run a cluster. The default Azure resource quota for a new Azure subscription is only 10. If you do not have the required number of cores, start by creating an Azure Support Request and fill out the following:
    1. Set Issue Type to “Service and subscription limits (quotas)”
    2. Set Quota Type to “Compute-VM (cores-vCPUs) subscription limit increases”
    3. Click Next Solutions
    4. Click Enter details
    5. Set Deployment Model to “Resource Manager”
    6. Set Locations to “(US) East US”
    7. Set Types to “Standard”
    8. Under Standard check “DSv3” and “DSv4”
    9. Set New vCPU Limit for each (example “60”)
    10. Click Save and continue
    11. Click Review + create »
    12. Wait until the quota has increased.

Register the resource providers

  1. If you have multiple accounts, specify the subscription ID you want to work with by running:
    az account set --subscription <SUBSCRIPTION ID>

    If you only have a single account, you can skip this step.
  2. Register the following resource providers:
    az provider register -n Microsoft.RedHatOpenShift --wait
    az provider register -n Microsoft.Compute --wait
    az provider register -n Microsoft.Storage --wait
    ​​​​​​​az provider register -n Microsoft.Authorization --wait

Get a Red Hat pull secret

  1. Log in to the Red Hat Hybrid Cloud Console to access the Azure Red Hat OpenShift pull secret page
  2. Click Download pull secret and save the pull secret in a secure place as a .txt file. You’ll reference it later.
    Microsoft Azure Red Hat OpenShift pull secret page in the Hybrid Cloud Console
    Figure 3. Microsoft Azure Red Hat OpenShift pull secret page in the Hybrid Cloud Console​​​​

With these prerequisites fulfilled, you are ready to deploy your first Azure Red Hat OpenShift cluster.

Previous resource
Overview: Getting started with Microsoft Azure Red Hat OpenShift
Next resource
Deploy a cluster
Hybrid Cloud Logo LinkedIn YouTube Facebook Twitter

Products

Tools

Try, buy, sell

Communicate

About Red Hat

We’re the world’s leading provider of enterprise open source solutions—including Linux, cloud, container, and Kubernetes. We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.