storj/all-in-one.md
Matt Robinson 026997e725
All-in-one docker-compose project (#267)
* First pass at an all-in-one compose project

* Sort out dependencies so uplink can build in docker

* Added the final bits to make this work

* Add readme for all-in-one

* Fix sed to work on OS X and Linux

* Make the readme for all-in-one better

* Only bring up the satellite and uplink after fixing the mock overlay

* Use a dummy value for mock overlay for now

* Finishing touches

* Fix url form for aws cli tool

* Move files out of all-in-one directory to help with directory confusion.

* Added a make target to make all-in-one even better
2018-08-23 11:48:03 -04:00

34 lines
1.3 KiB
Markdown

Steps to setup a local network
==============================
Run `make all-in-one` from the repo root. This will build new images and stand
them up locally. If you want to test a different version, run
`VERSION=latest make all-in-one`. If you want to stand them up by hand, run the
following:
1. `make images`
If you don't want to build the images locally, you can skip this step.
Otherwise, you'll need the version number presented here if you don't use
latest in the next step:
`Built version: c6cd912-all-in-one-go1.10`
2. `export VERSION=latest`
Export the version of the network you want to run. Latest should be ok, but
if you're testing something else, set the version here. ex: `c6cd912-all-in-one-go1.10`
Usable images should be pushed to the Docker Hub:
- https://hub.docker.com/r/storjlabs/storage-node/tags/
- https://hub.docker.com/r/storjlabs/satellite/tags/
- https://hub.docker.com/r/storjlabs/uplink/tags/
3. `docker-compose up -d storage-node`
Create the first storage node.
4. `scripts/fix-mock-overlay`
Fix the mock-overlay flag for the satellite. This is needed until the overlay
network is populated from kademlia correctly.
5. `docker-compose up satellite uplink`
Bring up the satellite and uplink
6. Visit http://localhost:7777 or use the aws tool with `--endpoint=http://localhost:7777`