Web IDE Access

This workshop uses Visual Studio Code (VS Code) based on Red Hat OpenShift Dev Spaces. Changes to files are auto-saved every few seconds, so you don’t need to explicitly save changes.

  1. Launch a new Red Hat OpenShift Dev Spaces instance then click the Log in with OpenShift button:

    login

  2. Login using user ID and password as {user} / {password}

  3. Click on the Allow selected permissions button when prompted

auth-access

  1. The next page will display progress as Dev Spaces is Starting workspace quarkus-workshop. It takes about 60 seconds to finish the process. If the process takes substantially longer than 60 seconds to complete, click on the "Progress" tab before reloading the page.

    ds

  2. When prompted with Do you trust the authors of this repository? popup, select Do not ask again for other repositories to continue using your workspace.

    ds

  3. In a few seconds, you will have access to your own web-based IDE

    ds

    1. Click on Trust Publishers & Install when prompted.

      ds

    2. And also click on Yes, I trust the authors as indicated below.

      ds

Explore the IDE

This workshop’s IDE is based on Eclipse Che (which is in turn based on Microsoft VS Code editor).

  1. Explore the icons on the left for navigating between project explorer, search, version control (e.g. Git), debugging, and other plugins. You’ll use these during the course of this workshop. Feel free to select them and see what they do:

    cdw
    If things get weird or your browser appears unresponsive, you can simply reload the browser tab to refresh the view.

  2. Many features of VS Code are accessed via Command Palette. You can see a few of the tutorials on the Get Started page (e.g. Login/Provision OpenShift Cluster, Create Component from Devfile registries webview, and others).

    If you ever need to run commands that you don’t see in a menu, you can press F1 to open the command window, or the more traditional Control+SHIFT+P (or Command+SHIFT+P on macOS).

Terminal Access

Open a new terminal window using the menu:

commands

This workshop includes example code and commands which can be copied to your system clipboard using the clipboard icon in the top right corner.

  1. Validate your terminal environment by using the clipboard icon to copy the following command:

    oc whoami

  2. Then paste the command into your terminal window and press Enter. You will see your username ({user}) as the response:

    {user}

  3. Ensure that the correct project has been selected by using the clipboard icon to copy the following command:

    oc project {user}-quarkus

  4. Then paste the command into your terminal window and press Enter. The response should be:

    Now using project "{user}-quarkus" on server "https://openshift.default.svc:443".

If everything went as expected in the above section, then you are ready to start building your application. If not, you can try deleting your existing IDE workspace before starting this section over with a fresh IDE.

Next Steps

You can now choose either the Basic or Advanced module to start learning about Quarkus development.

Keep this browser tab with the instructions open throughout the course of this workshop.