Appearance
systemslab import context
| Description | Import a previously exported SystemsLab context. |
|---|---|
| Usage | systemslab import context [OPTIONS] <SOURCE> |
Description
The systemslab import context command imports an context tar file that was generated by a previous systemslab export context command. This allows you to move entire contexts between different SystemsLab servers.
Notebooks in the export are imported after the experiments and added to the same workspaces as the context. They are pointed at the imported context, experiments, jobs and artifacts; references to anything else are kept as they are. A notebook that fails to import is reported as a warning, without undoing the rest of the import.
TIP
systemslab import context does not handle compressed tar files on its own. You can import compressed tar files by passing them to stdin like so
bash
gzip -d experiment.tar.gz -c | systemslab import context -Options
| Option | Default | Description |
|---|---|---|
<SOURCE> | Tarball or folder containing the context to import. This can be - to read the tar file from stdin. | |
-j, --parallel | 1 | Number of requests allowed to be made in parallel. Passing 0 will make this use the number of CPUs on the current machine. |
--workspace <WORKSPACE> | Add the new context to this workspace, given by its slug or id. Repeat the flag to add it to several workspaces. Defaults to SYSTEMSLAB_WORKSPACE, or else the workspace config option. An unknown workspace is an error, and nothing is created. | |
--no-workspace | Don't add the new context to the default workspace. | |
--label <KEY=VALUE> | Label the new context in each workspace it is added to. Repeat the flag to set several labels. Each key must already be a label facet of the workspace (see systemslab workspace facet), or nothing is created. |
Common Options
| Option | Default | Description |
|---|---|---|
--systemslab-url | The URL at which to access the systemslab server. | |
--color | auto | Controls when color is used in the output. Possible values are auto, always, and never. |
--output-format | long | Output format to use when outputting messages. long will result output designed to be human-readable while short is short output meant to be used within scripts. |
Environment Variables
| Variable | Description |
|---|---|
SYSTEMSLAB_URL | Specify the URL used to contact the SystemsLab server. Equivalent to --systemslab-url. |
SYSTEMSLAB_WORKSPACE | The workspace new contexts are added to by default. Overridden by --workspace. |