Review Accessing the web console.
You must be able to access a running instance of OpenShift Container Platform. If you do not have access, contact your cluster administrator.
You can log in to the OpenShift Container Platform web console to access and manage your cluster.
You must have access to an OpenShift Container Platform cluster.
Log in to the OpenShift Container Platform web console using your login credentials.
You are redirected to the Projects page. For non-administrative users, the default view is the Developer perspective. For cluster administrators, the default view is the Administrator perspective. If you do not have cluster-admin
privileges, you will not see the Administrator perspective in your web console.
The web console provides two perspectives: the Administrator perspective and Developer perspective. The Developer perspective provides workflows specific to the developer use cases.
Use the perspective switcher to switch to the Developer perspective. The Topology view with options to create an application is displayed.
A project enables a community of users to organize and manage their content in isolation. Projects are OpenShift Container Platform extensions to Kubernetes namespaces. Projects have additional features that enable user self-provisioning.
Users must receive access to projects from administrators. Cluster administrators can allow developers to create their own projects. In most cases, users automatically have access to their own projects.
Each project has its own set of objects, policies, constraints, and service accounts.
You are logged in to the OpenShift Container Platform web console.
You are in the Developer perspective.
You have the appropriate roles and permissions in a project to create applications and other workloads in OpenShift Container Platform.
In the +Add view, select Project → Create Project.
In the Name field, enter user-getting-started
.
Optional: In the Display name field, enter Getting Started with OpenShift
.
Display name and Description fields are optional. |
Click Create.
You have created your first project on OpenShift Container Platform.
OpenShift Container Platform automatically creates a few special service accounts in every project. The default service account takes responsibility for running the pods. OpenShift Container Platform uses and injects this service account into every pod that launches.
The following procedure creates a RoleBinding
object for the default ServiceAccount
object. The service account communicates with the OpenShift Container Platform API to learn about pods, services, and resources within the project.
You are logged in to the OpenShift Container Platform web console.
You have a deployed image.
You are in the Administrator perspective.
From the Administrator perspective, navigate to User Management and then click RoleBindings.
Click Create binding.
Select Namespace role binding (RoleBinding)
.
In the Name field, enter sa-user-account
.
In the Namespace field, search for and select user-getting-started
.
In the Role name field, search for view
and select view
.
In the Subject field, select ServiceAccount
.
In the Subject namespace field, search for and select user-getting-started
.
In the Subject name field, enter default
.
Click Create.
The simplest way to deploy an application in OpenShift Container Platform is to run an existing container image. The following procedure deploys a front end component of an application called national-parks-app
. The web application displays an interactive map. The map displays the location of major national parks across the world.
You are logged in to the OpenShift Container Platform web console.
You are in the Developer perspective.
You have the appropriate roles and permissions in a project to create applications and other workloads in OpenShift Container Platform.
From the +Add view in the Developer perspective, click Container images to open a dialog.
In the Image Name field, enter the following: quay.io/openshiftroadshow/parksmap:latest
Ensure that you have the current values for the following:
Application: national-parks-app
Name: parksmap
Select Deployment as the Resource.
Select Create route to the application.
In the Advanced Options section, click Labels and add labels to better identify this deployment later. Labels help identify and filter components in the web console and in the command line. Add the following labels:
app=national-parks-app
component=parksmap
role=frontend
Click Create.
You are redirected to the Topology page where you can see the parksmap
deployment in the national-parks-app
application.
OpenShift Container Platform leverages the Kubernetes concept of a pod, which is one or more containers deployed together on one host, and the smallest compute unit that can be defined, deployed, and managed. Pods are the rough equivalent of a machine instance, physical or virtual, to a container.
The Overview panel enables you to access many features of the parksmap
deployment. The Details and Resources tabs enable you to scale application pods, check build status, services, and routes.
You are logged in to the OpenShift Container Platform web console.
You are in the Developer perspective.
You have a deployed image.
Click D parksmap
in the Topology view to open the Overview panel.