# Access IBM Cloud Shell

For this workshop we'll be using the IBM Cloud Shell. The IBM Cloud Shell is a cloud-based shell workspace that you can access through your browser. It's preconfigured with the full IBM Cloud CLI and other 3rd party CLIs like OpenShift's `oc`, Helm's `helm` and Kubernetes' `kubectl`.

## Step 1: Set up Terminal

When using OpenShift on IBM Cloud no client side setup is required for this workshop. Instead we will use the IBM Cloud Shell (Beta) which comes with all necessary CLIs (command line tools).

In your browser, login to the [IBM Cloud](https://cloud.ibm.com) Dashboard. Make sure you select your own account in the account list at the top, then click on the IBM Cloud Shell icon.

![cloud-shell-launch](/files/-M8GM73zduC-ola9myLx)

Note: Your workspace includes 500 MB of temporary storage. This session will close after an hour of inactivity. If you don't have any active sessions for an hour or you reach the 30-hour weekly usage limit, your workspace data is removed.

This is what you should see:

![cloud-shell](/files/-M8GM740ckxYsbiAwaW9)

When using OpenShift locally, you need a local terminal and the following tools:

* [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
* [curl](https://curl.haxx.se/download.html)
* [oc](https://docs.openshift.com/container-platform/4.3/welcome/index.html)
* [mvn](https://maven.apache.org/ref/3.6.3/maven-embedder/cli.html)
* Java 9 or higher

## Step 2: Get the Code

In the IBM Cloud Shell execute the following command:

```bash
git clone https://github.com/IBM/cloud-native-starter.git
cd cloud-native-starter/reactive
ROOT_FOLDER=$(pwd)
```

![cloud-shell-clone](/files/-M8GM7419J2XIaoxKtaF)

## Step 3. Get Access to OpenShift

Open the [IBM Cloud Dashboard](https://cloud.ibm.com). In the row at the top switch from your **own** account to the **IBM account** given to you by the instructor from the pulldown in the uper right corner.

The select 'OpenShift' in the burger menu in the upper left corner followed by 'Clusters'.

![openshift-console-launch1](/files/-M8GM742smNKyXtMLMLO)

Click on your cluster.

![openshift-console-launch2](/files/-M8GM743dCZ15zO5rkaC)

Open the OpenShift web console.

![Open the OpenShift web console](/files/-M8GM7447EBtYUx1Nunu)

From the dropdown menu in the upper right of the page, click 'Copy Login Command'.

![openshift-login1](/files/-M8GM745QeK7wDuJSkSv)

Click on 'Display Token', then copy and paste the command 'Log in with this token' into your terminal in the IBM Cloud Shell.

![openshift-login2](/files/-M8GM746Rm2H2Q12Xtfx)

Login to OpenShift in IBM Cloud Shell

```bash
oc login https://c1XX-XX-X.containers.cloud.ibm.com:XXXXX --token=xxxxxx'
```

!\[openshift-login3openshift-login3.png)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ibm-developer.gitbook.io/reactive-endpoints-with-quarkus-on-openshift/setup-the-ibm-cloud-environment/cloud_shell.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.