Redirects and links

Author: johnmarco

.openpublishing.redirection.json

@@ -4088,9 +4088,26 @@
             "redirect_url": "/azure",
             "redirect_document_id": false
         }
+        {
+            "source_path_from_root": "/articles/openshift/tutorial-create-cluster.md",
+            "redirect_url": "/azure/openshift/create-cluster",
+            "redirect_document_id": false
+        },
+        {
+            "source_path_from_root": "/articles/openshift/tutorial-connect-cluster.md",
+            "redirect_url": "/azure/openshift/connect-cluster",
+            "redirect_document_id": false
+        },
+        {
+            "source_path_from_root": "/articles/openshift/tutorial-delete-cluster.md",
+            "redirect_url": "/azure/openshift/delete-cluster",
+            "redirect_document_id": false
+        },
+        {
+            "source_path_from_root": "/articles/openshift/quickstart-portal.md",
+            "redirect_url": "/azure/openshift/create-cluster",
+            "redirect_document_id": false
+        },
 
-
-
-        
     ]
 }

articles/openshift/azure-redhat-openshift-release-notes.md

@@ -57,7 +57,7 @@ We're pleased to announce the launch of OpenShift 4.11 for Azure Red Hat OpenShi
 - Ability to deploy OpenShift 4.11
 - Multi-version support: 
     - This enables customers to select specific Y and Z version of the release. See [Red Hat OpenShift versions](support-lifecycle.md#red-hat-openshift-versions) for more information about versions.
-    - Customers can still deploy 4.10 clusters if that version is specified. See [Selecting a different ARO version](tutorial-create-cluster.md#selecting-a-different-aro-version) for more information.
+    - Customers can still deploy 4.10 clusters if that version is specified. See [Selecting a different ARO version](create-cluster.md#selecting-a-different-aro-version) for more information.
 - OVN as the CNI for clusters 4.11 and above
 - Accelerated networking VMs 
 - UltraSSD support

articles/openshift/built-in-container-registry.md

@@ -20,12 +20,12 @@ In this article, you'll configure the built-in container image registry for an A
 
 ## Before you begin
 
-This article assumes you have an existing ARO cluster (see [Create an Azure Red Hat OpenShift 4 cluster](./tutorial-create-cluster.md)). If you would like to configure Microsoft Entra integration, make sure to create the cluster with the `--pull-secret` argument to `az aro create`.
+This article assumes you have an existing ARO cluster (see [Create an Azure Red Hat OpenShift 4 cluster](./create-cluster.md)). If you would like to configure Microsoft Entra integration, make sure to create the cluster with the `--pull-secret` argument to `az aro create`.
 
 > [!NOTE]
 > [Configuring Microsoft Entra authentication](./configure-azure-ad-ui.md#configure-openshift-openid-authentication) for your cluster is the easiest way to interact with the internal registry from outside the cluster.
 
-Once you have your cluster, [connect to the cluster](./tutorial-connect-cluster.md) by authenticating as the `kubeadmin` user.
+Once you have your cluster, [connect to the cluster](./connect-cluster.md) by authenticating as the `kubeadmin` user.
 
 ## Configure authentication to the registry
 

articles/openshift/concepts-networking.md

@@ -82,10 +82,10 @@ The following networking features are specific to Azure Red Hat OpenShift:
 
 The following network settings are available for Azure Red Hat OpenShift 4 clusters:
 
-* **API Visibility** - Set the API visibility when running the [az aro create command](tutorial-create-cluster.md#create-the-cluster).
+* **API Visibility** - Set the API visibility when running the [az aro create command](create-cluster.md#create-the-cluster).
     * "Public" - API Server is accessible by external networks.
     * "Private" - API Server assigned a private IP from the control plane subnet, only accessible using connected networks (peered virtual networks and other subnets in the cluster).
-* **Ingress Visibility** - Set the API visibility when running the [az aro create command](tutorial-create-cluster.md#create-the-cluster).
+* **Ingress Visibility** - Set the API visibility when running the [az aro create command](create-cluster.md#create-the-cluster).
     * "Public" routes default to a public Standard Load Balancer. (The default can be changed.)
     * "Private" routes default to an internal load balancer. (The default can be changed.)
 

articles/openshift/concepts-ovn-kubernetes.md

@@ -34,4 +34,4 @@ For more information about OVN-Kubernetes CNI network provider, see [About the O
 
 ## Recommended content
 
-[Tutorial: Create an Azure Red Hat OpenShift 4 cluster](tutorial-create-cluster.md)
+[Tutorial: Create an Azure Red Hat OpenShift 4 cluster](create-cluster.md)

articles/openshift/connect-cluster.md

@@ -0,0 +1,87 @@
+---
+title: Connect to an Azure Red Hat OpenShift 4 cluster
+description: Learn how to connect a Microsoft Azure Red Hat OpenShift cluster
+author: johnmarco
+ms.author: johnmarc
+ms.topic: article
+ms.service: azure-redhat-openshift
+ms.date: 06/12/2024
+#Customer intent: As a developer, I want learn how to create an Azure Red Hat OpenShift cluster, scale it, and then clean up resources so that I am not charged for what I'm not using.
+---
+
+# Connect to an Azure Red Hat OpenShift 4 cluster
+
+This article shows you how to connect to an Azure Red Hat OpenShift cluster running OpenShift 4 as the kubeadmin user through the OpenShift web console.
+
+## Before you begin
+
+This article requires Azure CLI version 2.6.0 or later. Run `az --version` to find the version. If you need to install or upgrade, see [Install Azure CLI](/cli/azure/install-azure-cli).
+
+## Connect to the cluster
+
+You can log into the cluster using the `kubeadmin` user. Run the following command to find the password for the `kubeadmin` user.
+
+```azurecli-interactive
+az aro list-credentials \
+  --name $CLUSTER \
+  --resource-group $RESOURCEGROUP
+```
+
+The following example output shows the password in `kubeadminPassword`.
+
+```json
+{
+  "kubeadminPassword": "<generated password>",
+  "kubeadminUsername": "kubeadmin"
+}
+```
+
+You can find the cluster console URL by running the following command, which will look like `https://console-openshift-console.apps.<random>.<region>.aroapp.io/`.
+
+```azurecli-interactive
+ 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.
+
+![Azure Red Hat OpenShift login screen](media/aro4-login.png)
+
+## Install the OpenShift CLI
+
+Once you're logged into the OpenShift Web Console, select the **?** at the top right and then on **Command Line Tools**. Download the release appropriate to your machine.
+
+![Screenshot that highlights the Command Line Tools option in the list when you select the ? icon.](media/aro4-download-cli.png)
+
+You can also download the [latest release of the CLI](https://mirror.openshift.com/pub/openshift-v4/clients/ocp/latest/) appropriate to your machine.
+
+If you're running the commands on the Azure Cloud Shell, download the latest OpenShift 4 CLI for Linux.
+
+```azurecli-interactive
+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
+
+Retrieve the API server's address.
+
+```azurecli-interactive
+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 retrieved.
+
+```azurecli-interactive
+oc login $apiServer -u kubeadmin -p <kubeadmin password>
+```
+
+## Next steps
+
+Learn how to [delete an Azure Red Hat OpenShift cluster](delete-cluster.md).