getting-started-codeready.adoc

Getting Started with OpenShift

5 MINUTE EXERCISE

In this lab you will learn about providing your Developer Workspace with a Kubernetes-native development platform and getting familiar with the OpenShift CLI and OpenShift Web Console.

What is CodeReady Workspaces?

Red Hat CodeReady Workspaces is a collaborative Kubernetes-native development platform that delivers OpenShift workspaces and an IDE for rapid cloud application development.

Built on the open Eclipse Che project, Red Hat CodeReady Workspaces provides developer workspaces on OpenShift with all the tools and the dependencies that are needed to code, build, test, run, and debug containerized applications. The entire product runs in the cloud and eliminates the need to install anything on a local machine.

• It offers fast onboarding capabilities for teams with powerful collaboration, workspace automation, and management at scale

• It removes inconsistencies and the “works on my machine” syndrome

• It protects source code from the hard-to-secure developer and personal laptops

Logging in to CodeReady Workspaces

Go to {{ CODEREADY_WORKSPACES_URL }}[CodeReady Workspaces^] then click on 'Openshift v3' to log in through OpenShift OAuth.

Log in as {{OPENSHIFT_USER}}/{{OPENSHIFT_PASSWORD}} and click on 'Allow selected permissions'

Finally, enter your account information and click on 'Submit'

Creating a Workspace

Once logged into CodeReady Workspaces, you can now create your workspace based on the Cloud-Native Stack.

Tip	A Stack is a template for workspace configuration. It includes the programming language and tools needed in your workspace to create applications. Stacks make it possible to deploy identical workspaces for all users on demand.

Select the stack called 'Cloud-Native' and then click on 'CREATE & OPEN'.

Caution

Make sure to select the stack called 'Cloud-Native' otherwise, you will not be able to complete the lab!

It takes a little while for the workspace to be ready. When it’s ready, you will see a fully functional CodeReady Workspaces IDE running in your browser.

Importing the lab project

Now you can import the project skeletons into your workspace.

In the Project Explorer pane, click on 'Import Project…​' and enter the following:

• Type: ZIP

• URL: {{LABS_DOWNLOAD_URL}}

• Name: labs

• Check Skip the root folder of the archive

Click on 'Import'. Make sure you choose the Blank project configuration since the zip file contains multiple project skeletons. Click on 'Save'

Converting your project skeletons

The projects are imported now into your workspace and is visible in the project explorer.

CodeReady Workspaces is a full featured IDE and provides language specific capabilities for various project types. In order to enable these capabilities, let’s convert the imported project skeletons to Maven projects.

In the Project Explorer, right-click on 'catalog-spring-boot' then, click on 'Convert to Project'.

Choose 'JAVA > Maven' from the project configurations and then click on 'Save'

Warning

Project Conversion Repeat the above for inventory-thorntail and gateway-vertx projects.

Important

Terminal Window of CodeReady Workspaces For the rest of these labs, anytime you need to run a command in a terminal, you can use the CodeReady Workspaces Terminal window.

Explore OpenShift with OpenShift CLI

In order to login, issue the following command and log in as {{OPENSHIFT_USER}}/{{OPENSHIFT_PASSWORD}}

$ oc login {{OPENSHIFT_CONSOLE_URL}}

Tip

You may see the following output: The server uses a certificate signed by an unknown authority. You can bypass the certificate check, but any data you send to the server could be intercepted by others. Use insecure connections? (y/n): Enter in Y to use a potentially insecure connection. The reason you received this message is because we are using a self-signed certificate for this workshop, but we did not provide you with the CA certificate that was generated by OpenShift. In a real-world scenario, either OpenShift’s certificate would be signed by a standard CA (eg: Thawte, Verisign, StartSSL, etc.) or signed by a corporate-standard CA that you already have installed on your system.

Congratulations, you are now authenticated to the OpenShift server.

{{OPENSHIFT_DOCS_BASE}}/architecture/core_concepts/projects_and_users.html#projects[Projects^] are a top level concept to help you organize your deployments. An OpenShift project allows a community of users (or a user) to organize and manage their content in isolation from other communities. Each project has its own resources, policies (who can or cannot perform actions), and constraints (quotas and limits on resources, etc). Projects act as a "wrapper" around all the application services and endpoints you (or your teams) are using for your work.

Warning

Make sure to use your dedicated project {{COOLSTORE_PROJECT}} by running the following command: $ oc project {{COOLSTORE_PROJECT}}

OpenShift ships with a web-based console that will allow users to perform various tasks via a browser. To get a feel for how the web console works, open your browser and go to {{OPENSHIFT_CONSOLE_URL}}[OpenShift Web Console^].

The first screen you will see is the authentication screen. Enter your username and password ({{OPENSHIFT_USER}}/{{OPENSHIFT_PASSWORD}}) and then log in. After you have authenticated to the web console, you will be presented with a list of projects that your user has permission to work with.

Click on '{{COOLSTORE_PROJECT}}' project to be taken to the project overview page which will list all of the routes, services, deployments, and pods that you have running as part of your project. There’s nothing there now, but that’s about to change.

Now you are ready to get started with the labs!