Update the README with instructions on initialising the mongo replica set.

This commit is contained in:
Ivaylo Novakov 2020-11-18 15:23:17 +01:00
parent 5dfdb0577e
commit ae99566ed3
No known key found for this signature in database
GPG Key ID: 06B9354AB08BE9C6
1 changed files with 50 additions and 0 deletions

View File

@ -15,6 +15,56 @@ List of available parameters:
- `GATSBY_API_URL`: override api url (defaults to location origin) - `GATSBY_API_URL`: override api url (defaults to location origin)
### MongoDB Setup
Mongo needs a couple of extra steps in order to start a secure cluster.
* Open port 27017 to all nodes that will take part in the cluster.
* Manually run an initialisation `docker run` with extra environment variables
that will initialise the admin user with a password (example below).
* Manually add a `mgkey` file under `./docker/data/mongo` with the respective
secret (see Mongo's keyfile access control for details).
* During the initialisation run mentioned above, we need to make two extra steps
within the container:
* Change the ownership of `mgkey` to `mongodb:mongodb`
* Change its permissions to 400
* After these steps are done we can open a mongo shell on the master node and
run `rs.add()` in order to add the new node to the cluster.
Example initialisation docker run command:
```
docker run \
--rm \
--name mg \
-p 27017:27017 \
-e MONGO_INITDB_ROOT_USERNAME=<admin username> \
-e MONGO_INITDB_ROOT_PASSWORD=<admin password> \
-v /home/user/skynet-webportal/docker/data/mongo/db:/data/db \
-v /home/user/skynet-webportal/docker/data/mongo/mgkey:/data/mgkey \
mongo --keyFile=/data/mgkey --replSet=skynet
```
Regular docker run command:
```
docker run \
--rm \
--name mg \
-p 27017:27017 \
-v /home/user/skynet-webportal/docker/data/mongo/db:/data/db \
-v /home/user/skynet-webportal/docker/data/mongo
```
Cluster initialisation mongo command:
```
rs.initiate(
{
_id : "skynet",
members: [
{ _id : 0, host : "helsinki.siasky.net:27017" },
{ _id : 1, host : "us-va-1.siasky.net:27017" },
]
}
)
```
## Contributing ## Contributing
### Testing Your Code ### Testing Your Code