Connect to OpenShift cluster on Azure

The section below describes how to connect to an OpenShift 4 cluster. More details can be found in Microsoft documentation, Connecting to a cluster section. The below example is given using Ubuntu 20.04.

Connect to the cluster

If you did not set environment variables before, set them by running the following.

export LOCATION=eastus                 # the location of your cluster
export RESOURCEGROUP=aro-rg            # the name of the resource group where you want to create your cluster
export CLUSTER=cluster                 # the name of your cluster

You can log into the cluster using the kubeadmin user. Run the following command to find the password for the kubeadmin user.

az aro list-credentials \
  --name $CLUSTER \
  --resource-group $RESOURCEGROUP

The following example output shows what the password will be in kubeadminPassword.

{
  "kubeadminPassword": "<generated password>",
  "kubeadminUsername": "kubeadmin"
}

You can find the cluster console URL by running the following command, the URL will look like https://console-openshift-console.apps.<random>.<region>.aroapp.io/.

az aro show \
    --name $CLUSTER \
    --resource-group $RESOURCEGROUP \
    --query "consoleProfile.url" -o tsv

Launch the console URL in a browser and login using the kubeadmin credentials.

Install the OpenShift CLI

More details on this step can be found in Microsoft documentation.

Once you're logged into the OpenShift Web Console, click on the ? sign in the top right and then go to Command Line Tools. Download the release appropriate to your machine.

You can also download the latest release of the CLI appropriate to your machine from their website.

If you're running the commands on the Azure Cloud Shell, download the latest OpenShift 4 CLI for Linux.

cd ~
wget https://mirror.openshift.com/pub/openshift-v4/clients/ocp/latest/openshift-client-linux.tar.gz

mkdir openshift
tar -zxvf openshift-client-linux.tar.gz -C openshift
echo 'export PATH=$PATH:~/openshift' >> ~/.bashrc && source ~/.bashrc

Connect using the OpenShift CLI

You can get kubeadmin password and cluster URL by running the following. Make sure not to forget to set variables before CLUSTER and RESOURCEGROUP.

az aro list-credentials \
  --name $CLUSTER \
  --resource-group $RESOURCEGROUP


az aro show \
    --name $CLUSTER \
    --resource-group $RESOURCEGROUP \
    --query "consoleProfile.url" -o tsv

Retrieve the API server's address.

export apiServer=$(az aro show -g $RESOURCEGROUP -n $CLUSTER --query apiserverProfile.url -o tsv)

Login to the OpenShift cluster's API server using the following command. Replace <kubeadmin password> with the password you just retrieved.

oc login $apiServer -u kubeadmin -p <kubeadmin password>