The intention of the Docker configurations in this directory is to enable anyone to develop and test NuCypher on all major operating systems with minimal prerequisites and installation hassle.
- install Docker
- install Docker Compose
- cd to dev/docker (where this README is located)
docker-compose up --build
this must be done once to complete install
Then you can do things like:
-
run the tests:
docker-compose run nucypher-dev pytest
-
start up an ursula:
docker-compose run nucypher-dev nucypher ursula run --dev --federated-only
-
open a shell:
docker-compose run nucypher-dev bash
-
try some of the scripts in
dev/docker/scripts/
*tested on (Ubuntu 16, MacOS 10.14, Windows 10)
From there you can develop, modify code, test as normal.
- run a network of 8 independent Ursulas
docker-compose -f 8-federated-ursulas.yml up
- get the local ports these ursulas will be exposed on
docker ps
- to stop them...
docker-compose -f 8-federated-ursulas.yml stop
- You can configure pycharm to use the python interpreter inside docker.
- docs for this are here