Getting Started: Developing NDS Labs

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".

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.

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.

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

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

Leave container running, but temporarily exit its shell:

CTRL+P, CTRL+Q, CTRL+C

Leave and stop the container:

exit