OpenShift docs are moving and will soon only be available at docs.redhat.com, the home of all Red Hat product documentation. Explore the new docs experience today.
  1. Documentation
    2. history bug_report picture_as_pdf
×

Using the web terminal

edit

You can launch an embedded command line terminal instance in the web console. This terminal instance is preinstalled with common CLI tools for interacting with the cluster, such as oc, kubectl,odo, kn, tkn, helm, and subctl. It also has the context of the project you are working on and automatically logs you in using your credentials.

edit

Accessing the web terminal

After the Web Terminal Operator is installed, you can access the web terminal. After the web terminal is initialized, you can use the preinstalled CLI tools like oc, kubectl, odo, kn, tkn, helm, and subctl in the web terminal. You can re-run commands by selecting them from the list of commands you have run in the terminal. These commands persist across multiple terminal sessions. The web terminal remains open until you close it or until you close the browser window or tab.

Prerequisites

  • You have access to an Red Hat OpenShift Service on AWS cluster and are logged into the web console.

  • The Web Terminal Operator is installed on your cluster.

Procedure

  1. To launch the web terminal, click the command line terminal icon (odc wto icon) in the masthead of the console. A web terminal instance is displayed in the Command line terminal pane. This instance is automatically logged in with your credentials.

  2. If a project has not been selected in the current session, select the project where the DevWorkspace CR must be created from the Project drop-down list. By default, the current project is selected.

    • One DevWorkspace CR defines the web terminal of one user. This CR contains details about the user’s web terminal status and container image components.

    • The DevWorkspace CR is created only if it does not already exist.

  3. Click Start to initialize the web terminal using the selected project.

  4. Click + to open multiple tabs within the web terminal in the console.