mirror of
https://github.com/serai-dex/serai.git
synced 2024-12-23 12:09:37 +00:00
978304e224
* add file * builds + caching fixed * bitcoin orchestration * remove default entrypoint * eth image and cleanup * working monero * remove signature file * cleanup on aisle eth * cleanup on aisle btc * eth working * remove docker ignore * remove bitcoin image readme * fix serai builds * serai clusters * added readme for docker * formatting * share the image * newlines at EOF * add multi profile example * coin order * coin order * profile order * fix grammar * fix whitespace * reduce trusted signature set, require at least 3 signatures. * remove echo * update comment to ref trusted keys * comment fix * use 16 keys, check for laanwj, name compose * don't use bash * monero fingerprints & eth fixes * eth fixes * remove extra eth keys
52 lines
2 KiB
Markdown
52 lines
2 KiB
Markdown
# Deploy
|
|
## Run with Docker Compose
|
|
Running the Serai infrastructure is easy with Docker.
|
|
|
|
We utilize compose profiles to easily orchestrate various pieces of the infrastructure.
|
|
|
|
**Example:** `docker compose --profile cluster-coins-sm up`
|
|
|
|
All commands are assumed to be ran from the deploy folder, not the serai root folder.
|
|
|
|
### Profiles:
|
|
* base - single node, named base
|
|
* coins - node clients for coins only (BTC, ETH, XMR)
|
|
* cluster-sm - Alice (Validator), Bob, Charlie
|
|
* cluster-coins-sm - cluster-sm with coins
|
|
* cluter-lg - Alice (Validator), Bob, Charlie, Dave, Eve, Ferdie
|
|
* cluster-coins-lg - cluster-lg with coins
|
|
* monero - full node monero only
|
|
* bitcoin - full node bitcoin only
|
|
* ethereum - full node ethereum only
|
|
|
|
You can supply one or more profiles to the docker compose command to orchestrate the desired components.
|
|
|
|
**Example:** `docker compose --profile base --profile bitcoin up`
|
|
|
|
## Orchestration Approach
|
|
### Builds
|
|
The Serai node is the only piece of our infrastructure that we compile locally and for the first build, it can take 10 minutes or more to complete the image. Images for external coins download binaries, then verify the signatures and checksums of the build. Overall the standard image build process looks like:
|
|
|
|
**Stage 1 -- Builder**
|
|
* Configure environment.
|
|
* Get the binary.
|
|
* Verify binary using GPG.
|
|
* Uncompress binary to prepare image.
|
|
|
|
**Stage 2 -- Image**
|
|
* Copy needed files from builder.
|
|
* Move executables to bin folder.
|
|
* Copy scripts folder.
|
|
* Expose necessary ports.
|
|
* Map necessary volumes.
|
|
|
|
The best way is to build using docker compose, but if you prefer to build using docker directly, each image can be built directly.
|
|
|
|
**Example:** `docker build ./coins/bitcoin`
|
|
|
|
### Entrypoint
|
|
The Serai full node and external full nodes each are started from an entrypoint script inside the /scripts folder.
|
|
|
|
To update the scripts on the image you must rebuild the updated images using the --build flag after "up" in docker compose.
|
|
|
|
**Example:** `docker compose --profile bitcoin up --build`
|