Prerequisites

Software Prerequisites

Make sure you have installed the following software before proceeding.
Software Version Number
Docker The latest version is recommended (versions 18.x and 19.x have been verified with the Local Edition installer).

Platform Prerequisites

Make sure you have performed the following platform requirements before proceeding:
  1. Create a Service Principal
    1. Refer to the following website for information about how to create a Service Principal:

      https://docs.microsoft.com/en-us/azure/active-directory/develop/howto-create-service-principal-portal

  2. Register a New Application
    1. Log in to the Azure portal, https://portal.azure.com.
    2. Select Azure Active Directory > App Registrations > New Registration.
  3. Add a New Client Secret
    1. In the newly created application, select Certificates & secrets > New client secret.
    2. Ensure that you record the new client secret.
  4. Assign the application to role "Contributor"
    1. Select All resources > Subscriptions .
    2. Click the subscription to assign the application to a role.
    3. Select Access Control (IAM) > Add > Add role assignment.
    4. Assign the newly created application.
      • Role: Contributor
      • Assign access to: Azure AD user, group, or service principal

Other Prerequisites

  • Openshift 4.7 version on Microsoft Azure requires 2.6.0 or higher version.
    To check the version you are working on, use
    az --version

    For information on install or upgrade, see Install Azure CLI.

  • Install the OpenShift CLI tool, oc. For information, see:

    Installing OpenShift CLI

  • You must have full rights in the Azure portal to execute tasks such as creating a service principal and assigning roles.