title | description | keywords | author | ms.author | ms.date | ms.topic | ms.service | ms.custom |
---|---|---|---|---|---|---|---|---|
Set up your Azure Red Hat OpenShift development environment |
Here are the prerequisites for working with Microsoft Azure Red Hat OpenShift. |
red hat openshift setup set up |
sakthi-vetrivel |
suvetriv |
11/04/2019 |
conceptual |
azure-redhat-openshift |
devx-track-azurecli |
Important
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.
Follow this guide to create an Azure Red Hat OpenShift 4 cluster. If you have specific questions, please contact us.
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
AROGA
feature 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.
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:
az --version
The first line of output will have the CLI version, for example azure-cli (2.0.65)
.
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.
The Microsoft.ContainerService AROGA
feature, Microsoft.Solutions
, Microsoft.Compute
, Microsoft.Storage
, Microsoft.KeyVault
and 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
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.
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:
[!div class="nextstepaction"] Create an Azure Red Hat OpenShift cluster