Reference

Workspace

A workspace is an ephemeral development environment with a cloud IDE and preview environment — created per user and branch.

Workspaces do database seeding and migrations when they start to make them more ephemeral and realistic. Workspaces can also run different commands from production for things like auto-reloading.

More than one workspace can be running at the same time.

Workspaces run in Coherence's cloud. They do not run on your infrastructure.

Starting a workspace

Start workspace button

Open workspace & dev preview

Open Workspace

Default IDE

By default, workspaces are a VSCode instance, however we also support VI and Emacs.

Workspace lifecycle

Below are the various stages and lifecyle for a workspace.

Create

After creating a workspace, Coherence will create the infrastructure, including a new disk that will persist across restarts. It will also clone your repo onto the workspace’s disk.

Start

Each time a workspace starts, it will pull the containers for the latest commit built on the feature. If the last build did not produce containers for the commit, starting the workspace will fail.

Timeout

Workspaces will time out after 30 minutes.

Delete

Deleting a workspace will destroy the infrastructure including the disk with the code on it.

Any unsaved work will be lost

Workspace UI

Workspace dropdown menu

Dropdown menu options:

  • Open: Opens the workspace IDE (defaults to VSCode).
  • Preview: Opens the workspace preview.
  • Refresh: Updates the UI to reflect the state of the workspace in the cluster.
  • Stop: Stops the workspace.
    • Stopping the workspace will not destory the disk or cause loss of work/data.

Updating a workspace

If a workspace’s branch gets commits after it is created you will need to update it manually with git pull via the terminal in the workspace, or using the VSCode git UI.

Unsupported extensions

The following extensions are not currently supported:

Cookies

Our workspaces use cookies to work properly. If you have disabled 3rd party cookies in your browser, you will need to make an exception for [*.]withcoherence.com for them to work.

Learn more

If you would like to know how to customize your workspace, please read Add a VSCode configuration to your workspace docs.

Previous
Toolbox