SLX.cloud helps teams collaborate in reproducible workspace environments. Team members can contribute to a project using the same environment (on any OS), knowing that all behaviors will match on every developer’s machine.
Export to File
In the user dashboard’s workspace detail view for a specific workspace:
- Click the “Export As A File” button to bring up the Export Workspace window. A custom recipe for the workspace will be shown. It includes environment and project information for the workspace.
- Click “Download” or “Copy to Clipboard” to get a copy of the workspace JSON which can be imported into another SLX.cloud instance.
To import the JSON in another SLX.cloud instance: f
- Ensure that the two instances are running the same SLX.cloud version.
- In the user dashboard select “Workspaces” from the left navigation bar.
- Click “Add Workspace”.
- Under “Select Source” choose “Import an existing workspace configuration”.
- Paste the JSON in the text editing area.
Share with SLX.cloud Factories
SLX.cloud includes “Factories” - templates used to generate new or open existing workspaces with a URL. Factories can be used to clone existing workspaces or repeatedly generate consistent workspaces for teams.
You can replicate a workspace by creating such a factory. There are two ways to create a workspace:
1. Within the running IDE
The easiest way to create a factory is by going to
Workspace -> Create Factory from within the main menu of the IDE in a running workspace.
You can set a name for the factory and click on
Create to generate the factory. The Factory URL will be displayed in the field underneath. Next to it you can either start or further configure it.
2. Via the Dashboard
You can also create a factory through the Dashboard by clicking on
Factories -> Create Factory. Next you will see a list of your workspaces. You can select one and click the
Create button on the bottom of the page to start the factory creation.
Create, the factory is already created and the URLs are displayed on the top of the page.
The following configuration dialog allows you to specify various parameters of the factory, but you can leave the defaults if you like. It allows you to configure the stack to be used and the amount of RAM the workspace should have (note that free accounts are limited to 2GB even though you can select more). Run commands might be handy to trigger specific build actions. On the bottom you will see the compete configuration as a JSON file.
A factory does not replicate your file system within the workspace. It replicates the stack (usually
silexica/tools:latest), all set up projects (typically imported via git or github) and all run configurations.
- if you have installed software via
apt-getor other means, it will not be included in the factory. To include those as well, you need to create a custom stack.
- if you have changed files after importing a project via git, make sure these files are committed to your repository. Otherwise they will not be included in the factory.
Creating a Custom Stack
To install additional software within a workspace or a factory, you need to create a custom stack. The details are described in Runtime Recipes.