Creating a Workspace
Step-by-step guide to creating a Workspace on DevZero.
Creating a Workspace on DevZero
Workspaces are custom environments built dynamically from recipes. A recipe is a pre-defined configuration file that specifies the tools, dependencies, and environment setup for your Workspace. This guide walks you through creating a Workspace using either a custom recipe or a template recipe provided by DevZero.
Navigate to the Workspace Page
From your DevZero Console, go to the Workspaces section and select Launch New Workspace
.
Configure Workspace Settings
Configure the following settings for your Workspace:
- Workspace Name: Provide a name for your Workspace.
- Workspace Region: Define a region to launch your Workspace. Defaults to your preferred region as defined in the settings.
- Attach Storage Volume: Select a shared storage volume to attach to your Workspace. Volumes must already exist in the selected region.
The Attach Storage Volume option is available only for Pro users.
Choose a Recipe
Every Workspace requires a recipe. You can:
- Use Recipe Library: Select a recipe youโve created or customized.
- Use Starter Templates: Choose from pre-configured templates provided by DevZero.
If you donโt have a recipe yet, create one here.
Once configured, click on Launch
. This will initialize the environment based on your chosen recipe.
Launch the Workspace
Your workspace will start building and you can monitor the logs in real-time. Once it has been successfully built, you can now connect to it. Once your Workspace is created, it will appear in the Workspaces list.
Access and Connect to the Workspace
After launching, you can access your Workspace via:
- DevZero CLI: Use the
dz workspace connect
command to SSH into the Workspace. - Integrated Development Environments (IDEs): Connect directly using IDEs like VSCode or JetBrains Gateway.
- Web-based SSH: Access the Workspace via the DevZero Console.
For more details on accessing a Workspace, see Accessing the Workspace.
Make sure the DevZero CLI is installed to connect to your Workspace.