serai/deploy
Luke Parker ffd1457927
Correct message-queue Dockerfile
It worked with my cache yet not without cache.
2023-07-21 15:08:37 -04:00
..
coins Use non-slim variants to remove needing to apt additional packages 2023-07-21 13:58:54 -04:00
kubernetes serai Dockerfile & Makefile fixed 2022-10-15 19:03:33 -05:00
message-queue Correct message-queue Dockerfile 2023-07-21 15:08:37 -04:00
processor Update how RPCs are handled 2023-07-21 14:01:42 -04:00
serai message-queue and processor Dockerfiles 2023-07-19 20:13:16 -04:00
docker-compose.yml message-queue and processor Dockerfiles 2023-07-19 20:13:16 -04:00
README.md message-queue and processor Dockerfiles 2023-07-19 20:13:16 -04:00

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 /deploy, not the root folder.

Profiles:

  • bitcoin - Bitcoin node

  • monero - Monero node

  • ethereum - Ethereum node

  • coins - Nodes for all external networks (BTC, ETH, XMR)

  • message-queue - The message queue service.

  • processor - Serai processor for one external network.

  • serai - Serai node

  • cluster-sm - "Alice", "Bob", and "Charlie" Serai nodes, all validators

  • cluster-lg - cluster-sm with non-validators "Dave", "Eve", and "Ferdie"

You can supply one or more profiles to the docker compose command to orchestrate the desired components.

Example: docker compose --profile coins --profile serai up

Orchestration Approach

Builds

The Serai infrastructure is locally compiled. This may take several minutes.

Images for external networks download binaries, before verifying their checksums and signatures.

Stage 1 -- Builder

  • Configure environment.
  • Get the binary.
  • Verify binary using GPG.
  • Decompress 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. If you'd prefer to build using docker directly, each image can be built independently.

Example: docker build ./coins/bitcoin

Entrypoint

The Serai node and external networks' nodes are each 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