diff --git a/_topic_maps/_topic_map_rosa.yml b/_topic_maps/_topic_map_rosa.yml index 9666fc2d44..ef5e82e843 100644 --- a/_topic_maps/_topic_map_rosa.yml +++ b/_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 diff --git a/cloud_experts_tutorials/cloud-experts-getting-started/cloud-experts-getting-started-accessing.adoc b/cloud_experts_tutorials/cloud-experts-getting-started/cloud-experts-getting-started-accessing.adoc new file mode 100644 index 0000000000..8bc000512c --- /dev/null +++ b/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 | 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[] \ No newline at end of file diff --git a/images/cloud-experts-getting-started-accessing-copy-login.png b/images/cloud-experts-getting-started-accessing-copy-login.png new file mode 100644 index 0000000000..ce1c7fbdc0 Binary files /dev/null and b/images/cloud-experts-getting-started-accessing-copy-login.png differ diff --git a/images/cloud-experts-getting-started-accessing-copy-token.png b/images/cloud-experts-getting-started-accessing-copy-token.png new file mode 100644 index 0000000000..3dbae5f60c Binary files /dev/null and b/images/cloud-experts-getting-started-accessing-copy-token.png differ diff --git a/images/cloud-experts-getting-started-accessing-logged.png b/images/cloud-experts-getting-started-accessing-logged.png new file mode 100644 index 0000000000..9506ec6bce Binary files /dev/null and b/images/cloud-experts-getting-started-accessing-logged.png differ diff --git a/images/cloud-experts-getting-started-accessing-login.png b/images/cloud-experts-getting-started-accessing-login.png new file mode 100644 index 0000000000..3b85df91df Binary files /dev/null and b/images/cloud-experts-getting-started-accessing-login.png differ