Manage Dev Environments
View dev environments
To view all dev environments in CodeCanvas (system admin view)
In the sidebar menu, select Administration, then Dev environments.
Use filters on top of the page to choose environments by state, by IDE, by template, by namespace, by computing platform, and by owner.
To view all personal dev environments
In CodeCanvas, click the CodeCanvas logo in the upper-left corner. This page shows all dev environments that you have access to.
Use filters on top of the page to choose environments by state, by IDE, by template, by namespace, and by computing platform.
To view dev environments created within a namespace
In the sidebar menu, select Dev Environments.
Use filters on top of the page to choose environments by state, by IDE, by template, by namespace, by computing platform, and by owner (the result of this filter depends on your permissions).
To view dev environment logs and other details
In the sidebar menu, select Dev environments.
Open the required dev environment.
View the details:
The Timeline page is a chat channel where the dev environment posts messages about its current state.
The Logs page contains dev environment logs.
To download logs, in the dev environment menu , select Download logs.
To view your dev environments
In Gateway, open the connection to your CodeCanvas instance.
All your dev environments are listed on the Dev environments page. Here you can find specific environments by name and by namespace.
To view dev environment logs
In Gateway, open the connection to your CodeCanvas instance.
Find the required dev environment and click Download logs in its menu.
Stop and activate dev environments
To stop a dev environment
In the sidebar menu, select Dev environments.
Find the required dev environment and click Stop.
CodeCanvas will initiate stopping the dev environment: save the contents of the working directory
/mnt/jetbrains
and user home directory/root
to the dev environment storage, unmount the storage, and perform graceful shutdown for the container (docker stop
). All uncommitted changes will be available after you restart the environment.All other directories aren't saved. For example, if, during your session, you installed additional tools with
apt get
, they won't survive stopping the environment. For this purpose, you should use custom dev environment images.
To activate a stopped dev environment
In the sidebar menu, select Dev environments.
Find the required dev environment and select Reactivate in the dev environment menu.
To stop a dev environment
In Gateway, open the connection to your CodeCanvas instance.
Find the required dev environment and click Stop in its menu.
CodeCanvas will initiate stopping the dev environment: save the contents of the working directory
/mnt/jetbrains
and user home directory/root
to the dev environment storage, unmount the storage, and perform graceful shutdown for the container (docker stop
). All uncommitted changes will be available after you restart the environment.All other directories aren't saved. For example, if, during your session, you installed additional tools with
apt get
, they won't survive stopping the environment. For this purpose, you should use custom dev environment images.
To activate a stopped dev environment
In Gateway, open the connection to your CodeCanvas instance.
Find the required dev environment and click Activate in its menu.
Recover failed dev environments
If a dev environment fails to start, you can try to recover it. During recovery, CodeCanvas will create a new dev environment container and re-download the IDE. User data will be preserved.
In CodeCanvas, find the namespace.
In the sidebar menu, select Dev environments.
Find the required dev environment and select Restart in recovery mode in the dev environment menu.
In the dialog that opens, click Recover.
Delete dev environments
In the sidebar menu, select Dev environments.
Find the required dev environment and select Delete in the dev environment menu.
In Gateway, open the connection to your CodeCanvas instance.
Find the required dev environment and click Delete in its menu.
Dev environment states
State | Description |
---|---|
Starting | CodeCanvas is creating the dev environment. The environment is not yet accessible. |
Active | The dev environment is up and running. |
Stopping, Stopped | The dev environment wasn't used for more than 30 minutes, or you stopped it manually. The virtual machine is released, the dev environment disk is stored in the CodeCanvas cloud storage. |
Failed | CodeCanvas failed to create the dev environment. Delete this environment and try creating a new one. |