Every stack includes a sample codebase, which is defined by the devfile of the stack. This section explains how to create a workspace from this code sample in a sequence of three procedures.

For more information on devfiles, see Configuring a Che workspace using a devfile.

Creating a workspace from User Dashboard

This section describes how to create a workspace from the User Dashboard.

Prerequisites
  • A running instance of Eclipse Che. To install an instance of Eclipse Che, see Che quick-starts

Procedure
  1. Navigate to the Che Dashboard. See Navigating Che using the Dashboard.

  2. In the left navigation panel, navigate to Workspaces.

  3. Click on the Add Workspace button.

  4. Define a Name for the workspace. A generated name is proposed. It can be modified.

  5. In the Stack section, select the workspace runtime environment that will be used to build and run projects from the list.

    Select a stack from the list
    Viewing the compute resource limits

    The memory needed by the stack is pre-calculated and displayed on the stack description line. Changing the memory requirements is only possible from the devfile.

  6. Start the workspace: click on the Create & Open button at the top or bottom of the form:

    Create and Open
Configuring the workspace before start

Instead of configuring the workspace once it has started, it is possible to configure the workspace before start.

  1. From the top of the page, click the down arrow next to the Create & Open button.

  2. Select the menu item below to edit the workspace configuration.

Create and Edit
Devfile’s name is ignored

The dashboard always use name specified in step 4. as a workspace name. The stack’s underlying devfile’s name and generateName are overriden by it.

Changing the configuration of an existing workspace from the User Dashboard

This section describes how to change the configuration of an existing workspace from the User Dashboard.

Prerequisites
Procedure
  1. Navigate to the Che Dashboard. See Navigating Che using the dashboard.

  2. In the left navigation panel, navigate to Workspaces.

  3. Click on the name of a workspace to navigate to the configuration overview page.

  4. Click on the Overview tab, to execute following actions:

    • Change the Workspace name.

    • Toggle Ephemeral mode.

    • Export the workspace configuration to a file or private cloud.

    • Delete the workspace.

      Worksapce configuration overview
  1. In the Projects section, choose the projects to integrate in the workspace.

    1. Click on the Add Project button

    2. Select the projects to integrate in the workspace.

    3. Click on th Add button.

      Add projects to workspace
  2. In the Plugins section, choose the plugins to integrate in the workspace.

    Example

    Start with a generic Java-based stack, then later add support for Node or Python.

  3. In the Editors section, choose the editors to integrate in the workspace. The Che 7.3 editor is based on Che-Theia.

    Example: Switch to the Che 6.x editor
    • To Switch to the Che 6.x editor, select the GWT IDE.

  1. From the Devfile tab, edit the workspace’s YAML configuration. See Devfile reference.

    Example: add commands
    YAML configuration
    Example: add a project

    To add a project into the workspace, add or edit the following section:

    projects:
      - name: che
        source:
          type: git
          location: 'https://github.com/eclipse/che.git'

Running an existing workspace from the User Dashboard

This section describes how to run an existing workspace from the User Dasboard

Running an existing workspace from the User Dashboard with the Run button

This section describes how to run an existing workspace from the User Dashboard using the Run button.

Prerequisites
Procedure
  1. Navigate to the Che Dashboard. See Navigating Che using the dashboard.

  2. In the left navigation panel, navigate to Workspaces.

  3. Click on the name of a non-running workspace to navigate to the overview page.

  4. Click on the Run button in the top right corner of the page.

  5. The workspace is started.

  6. The browser does not navigates to the workspace.

Running an existing workspace from the User Dashboard using the Open button

This section describes how to run an existing workspace from the User Dashboard using the Open button.

Prerequisites
Procedure
  1. Navigate to the Che Dashboard. See Navigating Che using the dashboard.

  2. In the left navigation panel, navigate to Workspaces.

  3. Click on the name of a non-running workspace to navigate to the overview page.

  4. Click on the Open button in the top right corner of the page.

  5. The workspace is started.

  6. The browser navigates to the workspace.

Running an existing workspace from the User Dashboard using the Recent Workspaces

This section describes how to run an existing workspace from the User Dashboard using the Recent Workspaces.

Prerequisites
Procedure
  1. Navigate to the Che Dashboard. See Navigating Che using the dashboard.

  2. In the left navigation panel, in the Recent Workspaces section, right-click on the name of a non-running workspace and click on Run in the contextual menu to start it.

    Run from Recent Workspaces
Tags: