Creating workspaces

Use the stacks in the Dashboard to create a workspace. Images and configuration in these stacks are certified both for Docker and OpenShift. These stacks are used in daily functional testing.

Creating a workspace from stacks in the dashboard

To create a workspace from stacks in the Dashboard, take the following steps:

  1. In the Dashboard, in the left panel, click Stacks.

  2. Click the Duplicate stack icon for the stack that you want to create a clone of. A page titled after the selected stack opens.

  3. Edit the fields that you want to edit.

  4. Click Save.

ready to go stacks

Duplicating an existing stack

Create a stack and then use the resulting stack to create a workspace.

To create a copy of an existing stack, take the following steps:

  1. In the Dashboard, in the left panel, click Stacks.

  2. Click the Duplicate stack icon for the stack that you want to clone.

  3. Edit the Name field.

  4. In the Machines field, edit the Source field.

  5. Click Save. The Stack is successfully updated message confirms that the stack is updated.

  6. In the Dashboard, click Workspaces > Add Workspace.

  7. In the SELECT STACK section, scroll through the list to locate the stack that you created in the preceding steps.

  8. Click Create to create the workspace based on this stack.

duplicate stack

Creating a custom stack from a custom recipe

Author a custom recipe and then create a stack. Use the resulting stack to create a workspace.

To create a custom stack from a custom recipe, take the following steps:

  1. In the Dashboard, click Workspaces > Add Workspace.

  2. From the SELECT STACK field, select the required stack.

  3. Click Add Stack.

  4. In the Create Stack dialog box, click Yes to confirm that you want to create the stack from a recipe.

  5. In the Build stack from recipe window, type the recipe name from which you want to build this stack (example: FROM: eclipse/new-stack).

  6. Click OK.

  7. In the Name field, type a name for the stack.

  8. In the Runtimes > Machines > Recipe section, click Show to ensure that the stack is being created using the recipe that you set in the preceding steps (eclipse/new-stack, in this case).

  9. Click Save.

custom recipe stack

Starting workspaces

You can start a workspace in one of the following ways:

  • The workspace starts automatically after it is created in the user’s Dashboard.

  • In the user’s Dashboard, use the Run or Open buttons in the Workspace Details view.

  • Click a workspace name from the Recent Workspaces displayed in the left panel.

  • Use the REST API. For more information about the REST API, see REST API.

The workspace may take time to start depending on factors like network conditions, container image availability, and configured installers attempting to install additional tools and software in the runtime. Track the progress of the workspace start operation in the Workspace Start tab. The tabs for each machine in the workspace environment stream logs from the installers (terminal, exec agent, ws agent, and language servers if any).

Managing a workspace

After a workspace is created or started, you can modify it by adding projects, installers, environment variables, and volumes.

To edit a raw workspace configuration, back up the working configuration to avoid breaking your workspace.

Change the configuration of a running workspace and saving it restarts the workspace. To learn more about workspace configuration, see:

ws details