Set up your Azure Red Hat OpenShift dev environment
Azure Red Hat OpenShift 3.11 will be retired 30 June 2022. Support for creation of new Azure Red Hat OpenShift 3.11 clusters continues through 30 November 2020. Following retirement, remaining Azure Red Hat OpenShift 3.11 clusters will be shut down to prevent security vulnerabilities.
To build and run Microsoft Azure Red Hat OpenShift applications, you'll need to:
- Install version 2.0.65 (or higher) of the Azure CLI (or use the Azure Cloud Shell).
- Register for the
AROGAfeature and associated resource providers.
- Create an Azure Active Directory (Azure AD) tenant.
- Create an Azure AD application object.
- Create an Azure AD user.
The following instructions will walk you through all of these prerequisites.
Install the Azure CLI
Azure Red Hat OpenShift requires version 2.0.65 or higher of the Azure CLI. If you've already installed the Azure CLI, you can check which version you have by running:
The first line of output will have the CLI version, for example
Here are instructions for installing the Azure CLI if you require a new installation or an upgrade.
Alternately, you can use the Azure Cloud Shell. When using the Azure Cloud Shell, be sure to select the Bash environment if you plan to follow along with the Create and manage an Azure Red Hat OpenShift cluster tutorial series.
Register providers and features
Microsoft.ContainerService AROGA feature,
Microsoft.Network providers must be registered to your subscription manually before deploying your first Azure Red Hat OpenShift cluster.
To register these providers and features manually, use the following instructions from a Bash shell if you've installed the CLI, or from the Azure Cloud Shell (Bash) session in your Azure portal:
If you have multiple Azure subscriptions, specify the relevant subscription ID:
az account set --subscription <SUBSCRIPTION ID>
Register the Microsoft.ContainerService AROGA feature:
az feature register --namespace Microsoft.ContainerService -n AROGA
Register the Microsoft.Storage provider:
az provider register -n Microsoft.Storage --wait
Register the Microsoft.Compute provider:
az provider register -n Microsoft.Compute --wait
Register the Microsoft.Solutions provider:
az provider register -n Microsoft.Solutions --wait
Register the Microsoft.Network provider:
az provider register -n Microsoft.Network --wait
Register the Microsoft.KeyVault provider:
az provider register -n Microsoft.KeyVault --wait
Refresh the registration of the Microsoft.ContainerService resource provider:
az provider register -n Microsoft.ContainerService --wait
Create an Azure Active Directory (Azure AD) tenant
The Azure Red Hat OpenShift service requires an associated Azure Active Directory (Azure AD) tenant that represents your organization and its relationship to Microsoft. Your Azure AD tenant enables you to register, build, and manage apps, as well as use other Azure services.
If you don't have an Azure AD to use as the tenant for your Azure Red Hat OpenShift cluster, or you wish to create a tenant for testing, follow the instructions in Create an Azure AD tenant for your Azure Red Hat OpenShift cluster before continuing with this guide.
Create an Azure AD user, security group and application object
Azure Red Hat OpenShift requires permissions to perform tasks on your cluster, such as configuring storage. These permissions are represented through a service principal. You'll also want to create a new Active Directory user for testing apps running on your Azure Red Hat OpenShift cluster.
Follow the instructions in Create an Azure AD app object and user to create a service principal, generate a client secret and authentication callback URL for your app, and create a new Azure AD security group and user to access the cluster.
You're now ready to use Azure Red Hat OpenShift!
Try the tutorial: