Guided Exercise: Navigate the OpenShift Web Console

Access an OpenShift cluster by using its web console and review pages to identify key OpenShift cluster services.

Outcomes

  • Explore the features and components of Red Hat OpenShift by using the web console.

  • Create a sample application by using the Developer perspective in the web console.

  • Switch to the Administrator perspective and examine the resources that are created for the sample application.

  • Use the web console to describe the cluster nodes, networking, storage, and authentication.

  • View the default cluster operators, pods, deployments, and services.

As the student user on the workstation machine, use the lab command to prepare your system for this exercise.

This command ensures that the cluster is validated for the exercise.

[student@workstation ~]$ lab start intro-navigate

Instructions

  1. As the developer user, locate and then navigate to the Red Hat OpenShift web console.

    1. Use the terminal to log in to the OpenShift cluster as the developer user with the developer password.

      [student@workstation ~]$ oc login -u developer -p developer \
        https://api.ocp4.example.com:6443
      
      ...output omitted...
    2. Identify the URL for the OpenShift web console.

      [student@workstation ~]$ oc whoami --show-console
      https://console-openshift-console.apps.ocp4.example.com
    3. Open a web browser and navigate to https://console-openshift-console.apps.ocp4.example.com. Either type the URL in a web browser, or right-click and select Open Link from the terminal.

  2. Log in to the OpenShift web console as the developer user.

    1. Click Red Hat Identity Management and log in as the developer user with the developer password.

      Note

      Click Skip Tour to dismiss the option to view a short tour on the first visit.

  3. Use the Developer perspective of the web console to create your first project.

    1. From the Getting Started section in the +Add page, click Create a new project to open the Create Project wizard.

    2. Create a project named intro-navigate by using the wizard. Use intro-navigate for the display name, and add a brief description of the project.

    3. Click Create to create the project.

    4. Click Topology to view the project.

  4. Deploy a sample application in the project.

    1. Select the Start building your application link to browse the available sample applications.

    2. Enter Apache into the search bar to see the available sample applications for deployment.

    3. Select the samples option from Apache HTTP Server (httpd) from the list of available applications, and then click Create from the side panel.

    4. Use application-test for the application name and the name of the deployment, https://git.ocp4.example.com/developer/httpd-ex.git for the git repository URL, and GitLab for the git type. Leave the rest of the default values, and select Create at the bottom of the page to create the application.

      The Topology page opens and displays the application-test application deployment.

  5. View the deployment details for the application-test application.

    1. Select the application-test deployment to view the details of the application.

    2. Select the Actions list to view the available controls for the application-test deployment.

  6. Switch into the Administrator perspective and inspect the deployment.

    1. From the OpenShift web console, locate the left panel. If you do not see the left panel, then click the main menu icon at the upper left of the web console. Click Developer and then click Administrator to change to the Administrator perspective. The web console changes to the new perspective and exposes additional information through the sidebar.

    2. Select the intro-navigate project to open the Project Details page. This page includes a general overview of the project, such as the project status and resource usage details.

  7. View the application-test pods and deployment.

    1. From the OpenShift web console menu, navigate to Workloads → Pods to view the application-test pods.

    2. Navigate to Workloads → Deployments to view the list of deployments in the project.

    3. Click application-test to view the deployment details.

  8. View the application-test service and route.

    1. Navigate to Networking → Services and click application-test to view the details of the application-test service.

    2. Navigate to Networking → Route and click application-test to view the details of the application-test route.

  9. Delete the project and log out of the web console.

    1. From the OpenShift web console menu, navigate to Home → Projects. Select Delete Project from the context menu for the intro-navigate project.

    2. Enter the project name in the text field and then select Delete.

    3. Log out of the web console. From the OpenShift web console right panel, click developer and then select Log out from the account menu.

  10. Log in to the OpenShift web console as the admin user to inspect additional cluster details.

    Note

    When you use a cluster administrator account, you can browse the cluster components, but do not alter or remove any components.

    1. Log in to the web console. Select Red Hat Identity Management and then enter the admin username and the redhatocp password.

    2. From the OpenShift web console menu, navigate to Operators → Installed Operators. Each operator provides a specific function for the cluster. Select an individual operator to display its details.

    3. Navigate to Workloads → Pods to view the list of all pods in the cluster. The search bar at the top can narrow down the list of pods. Select an individual pod to display its details.

    4. Navigate to Workloads → Deployments to view the list of all deployments in the cluster. Select an individual deployment to display its details.

    5. Navigate to Networking → Services to view the list of all services in the cluster. Select an individual service to display its details.

  11. Log out of the web console.

    1. Log out of the web console. From the OpenShift web console right panel, click Administrator and then select Log out from the account menu.

Finish

On the workstation machine, use the lab command to complete this exercise. This step is important to ensure that resources from previous exercises do not impact upcoming exercises.

[student@workstation ~]$ lab finish intro-navigate