docker.md

Docker

Build

To build the Docker container:

docker buildx build . -t rundler

Run

Simple full node docker-compose configuration:

version: "3.8"

services:
  rundler:
    image: rundler
    command: node
    ports:
      # RPC port
      - "3000:3000"
      # Metrics port
      - "8080:8080"
    environment:
      - ENTRY_POINTS=0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789
      - NODE_HTTP=[YOUR NODE HTTP HERE]
      - CHAIN_ID=[YOUR CHAIN ID HERE]
      - BUILDER_PRIVATE_KEY=[YOUR PRIVATE KEY HERE]

An example docker-compose configuration running Rundler in its distributed mode can be found here.

Cross-Platform Docker Builds with Docker and cross-rs

Prerequisites

• cross-rs
• tonistiigi/binfmt
• docker-buildx

Build Phase Dockerfile.build

This phase compiles and imports required libraries for successful compilation. It uses the Dockerfile.build as an environment. The base image is specified by the CROSS_BASE_IMAGE argument. A list of images that cross-rs provides can be found here.

Release Phase Dockerfile.cross

This phase imports the compiled binary from the previous stage into its environment and exposes relevant ports for the correct functioning of the program. The target platform is specified by the TARGETPLATFORM argument.

Usage

GitHub Actions

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - name: Set up Docker builder
        run: |
          docker run --privileged --rm tonistiigi/binfmt --install arm64,amd64
          docker buildx create --use --name cross-builder

      - name: Build and push image
        run: |
          cargo install cross --git https://github.com/cross-rs/cross 
          sudo -E env "PATH=$PATH" make docker-build-latest

Local Builds

These command should only be used if you are trying to cross compile the application locally. If you just want to build cross compiled docker images, you should use the commands above.

docker run --privileged --rm tonistiigi/binfmt --install arm64,amd64
docker buildx create --use --name cross-builder
cargo install cross --git https://github.com/cross-rs/cross 
sudo -E env "PATH=$PATH" make docker-build-latest