woop/scripts/docker/README.md

Docker Image

Included in this repo is a Dockerfile that you can launch harmony node for trying it out. Docker images are available on harmonyone/harmony.

You can build the docker image with the following commands:

make docker

If your build machine has an ARM-based chip, like Apple silicon (M1), the image is built for linux/arm64 by default. To build for x86_64, apply the --platform arg:

docker build --platform linux/amd64 -t harmonyone/harmony -f Dockerfile .

Before start the docker, dump the default config harmony.conf by running:

for testnet

docker run -v $(pwd)/config:/harmony --rm --name harmony harmonyone/harmony harmony config dump --network testnet harmony.conf

for mainnet

docker run -v $(pwd)/config:/harmony --rm --name harmony harmonyone/harmony harmony config dump harmony.conf

make your customization. harmony.conf should be mounted into default HOME directory /harmony inside the container. Assume harmony.conf, blskeys and hmykey are under ./config in your current working directory, you can start your docker container with the following command:

docker run -v $(pwd)/config:/harmony --rm --name harmony -it harmonyone/harmony

If you need to open another shell, just do:

docker exec -it harmonyone/harmony /bin/bash

We also provide a docker-compose file for local testing

To use the container in kubernetes, you can use a configmap or secret to mount the harmony.conf into the container

containers:
  - name: harmony
    image: harmonyone/harmony
    ports:
      - name: p2p
        containerPort: 9000  
      - name: rpc
        containerPort: 9500
      - name: ws
        containerPort: 9800     
    volumeMounts:
      - name: config
        mountPath: /harmony/harmony.conf
  volumes:
    - name: config
      configMap:
        name: cm-harmony-config
    

Your configmap cm-harmony-config should look like this:

apiVersion: v1
kind: ConfigMap
metadata:
  name: cm-harmony-config
data:
  harmony.conf: |
    ...