The easiest way to create a workspace is to use ready to go stacks in User Dashboard. Images and configuration in these stacks is certified both for Docker and OpenShift, and these are the stacks that are used in daily functional testing. There are multiple options though, namely:
Duplicate an existing stack
In this scenario, you need to create a stack first, and then use the resulting stack to create a workspace.
Create Custom stack from a custom recipe
In this scenario, you need to author a custom recipe, then a stack, and finally use the resulting stack to create a workspace.
A workspace can be started in one of the following ways:
- Auto-start when workspace is created in UD
- Run or Open buttons in workspace details view in User Dashboard
- By clicking on a workspace name in the left Dashboard sidebar (recent workspaces)
- Using REST API. See [REST API][TODO: REST API page]
It can take some time for a workspace environment to start. It depends on several factors like network conditions, Docker image availability, configured installers that may attempt to install additional tools and software in runtime etc. When a workspace is starting, you can track progress in a workspace start tab. There are also individual tabs for each machine in workspace environment that stream logs from installers (terminal, exec agent, ws agent, language servers if any).
Once a workspace is created or started, you can modify it by adding projects, installers, env variables, volumes. You can also edit raw workspace config, but beware that you may break your workspace this way, so always have a backup of a working config. If you change configuration of a running workspace and save it, a workspace will be restarted. Follow the links above to learn more about workspace configuration.