Allocate VM on Nebula
Log into Nebula and create a VM under the project NDSLabsDev.
Be sure to select a size. If you are unsure which to use, you likely should use "large" or "medium".
Clone the Source Repo
To start, you will need the code. Clone it and change into the new directory:
git clone https://github.com/nds-org/nds-labs
cd nds-labs/
NOTE: Once we have an ndsdev image circulating, this step should no longer be necessary.
Create a Data Container Containing the Source (NDSSRC)
Execute the following command at the project root to create a Data Container from the source code:
. ./devtools/ndsdev/create-data-volume.sh
This data container will hold the source code mapped to your host VM. This will allow your code to survive container restarts.
NOTE: It is interesting to note that you should be able to access the data on any volumes defined by the container without it needing to run.
Building Development Environment (NDSDEV)
Execute the following command at the project root to build up the ndsdev image:
. ./devtools/ndsdev/ndsdevctl build
You should then be able to run this image using:
. ./devtools/ndsdev/ndsdevctl run
NDSDEV Usage
To start a stopped NDSDEV container:
. ./devtools/ndsdev/ndsdevctl start
To get back to a running instance of NDSDEV:
. ./devtools/ndsdev/ndsdevctl attach
Stop the container:
. ./devtools/ndsdev/ndsdevctl stop
Stop, the start the container:
. ./devtools/ndsdev/ndsdevctl restart
Stop the container and remove it from docker (i.e. clean):
. ./devtools/ndsdev/ndsdevctl rm
Tips and Tricks
Leave container running, but temporarily exit its shell:
CTRL+P, CTRL+Q, CTRL+C
Leave and stop the container:
exit