OSDOCS-8380

_topic_maps/_topic_map_rosa.yml

@@ -139,6 +139,8 @@ Topics:
     File: cloud-experts-getting-started-admin
   - Name: Setting up an identity provider
     File: cloud-experts-getting-started-idp
+  - Name: Accessing your cluster
+    File: cloud-experts-getting-started-accessing
 ---
 Name: Getting started
 Dir: rosa_getting_started

cloud_experts_tutorials/cloud-experts-getting-started/cloud-experts-getting-started-accessing.adoc

@@ -0,0 +1,80 @@
+:_mod-docs-content-type: ASSEMBLY
+[id="cloud-experts-getting-started-accessing"]
+= Tutorial: Accessing your cluster
+include::_attributes/attributes-openshift-dedicated.adoc[]
+:context: cloud-experts-getting-started-accessing
+
+toc::[]
+
+//rosaworkshop.io content metadata
+//Brought into ROSA product docs 2023-11-30
+
+You can connect to your cluster using the command line interface (CLI) or the console user interface (UI).
+
+== Accessing your cluster using the CLI
+
+To access the cluster using the CLI, you must have the `oc` CLI installed. If you are following the tutorials, you already installed the `oc` CLI.
+
+. Log in to the link:https://console.redhat.com/openshift[Red Hat console].
+. Click your username in the top right corner.
+. Click *Copy Login Command*.
++
+image::cloud-experts-getting-started-accessing-copy-login.png[]
+
+. This opens a new tab with a choice of identity providers (IDPs). Click the IDP you want to use. For example, "rosa-github".
++
+image::cloud-experts-getting-started-accessing-copy-token.png[]
+
+. A new tab opens. Click *Display token*.
+
+. Run the following command in your terminal:
++
+[source,terminal]
+----
+$ oc login --token=sha256~GBAfS4JQ0t1UTKYHbWAK6OUWGUkdMGz000000000000 --server=https://api.my-rosa-cluster.abcd.p1.openshiftapps.com:6443
+----
++
+.Example output
++
+[source,terminal]
+----
+Logged into "https://api.my-rosa-cluster.abcd.p1.openshiftapps.com:6443" as "rosa-user" using the token provided.
+
+You have access to 79 projects, the list has been suppressed. You can list all projects with ' projects'
+
+Using project "default".
+----
+
+. Confirm that you are logged in by running the following command:
++
+[source,terminal]
+----
+$ oc whoami
+----
++
+.Example output
++
+[source,terminal]
+----
+rosa-user
+----
+
+. You can now access your cluster.
+
+== Accessing the cluster via the web console
+. Log in to the link:https://console.redhat.com/openshift/[Red Hat console].
+.. To retrieve the console URL run:
++
+[source,terminal]
+----
+rosa describe cluster -c <cluster-name> | grep Console
+----
+
+. Click your IDP. For example, "rosa-github".
++
+image::cloud-experts-getting-started-accessing-copy-token.png[]
+
+. Enter your user credentials.
+. You should be logged in. If you are following the tutorials, you will be a cluster-admin and should see a web console with the *Administrator* panel visible.
++
+image::cloud-experts-getting-started-accessing-logged.png[]