Build docker image

Prerequisites

To build docker image:

docker

To run docker image with dependencies:

docker-compose

Build docker image for any commit

Replace YOUR_TAG and YOUR_CHECKOUT_COMMIT in the below command to build:

git checkout YOUR_CHECKOUT_COMMIT
docker build . -t temporalio/auto-setup:YOUR_TAG --build-arg TARGET=auto-setup

Run Temporal with custom docker image

Clone Temporal docker-compose repo: https://github.com/temporalio/docker-compose:

git clone https://github.com/temporalio/docker-compose.git

Replace the tag of image: temporalio/auto-setup to YOUR_TAG in docker-compose.yml. Then start the service using the below command:

docker-compose up

Quickstart for production

In a typical production setting, dependencies (such as cassandra or elasticsearch) are managed/started independently of the Temporal server. To use the container in a production setting, use the following command:

docker run -e CASSANDRA_SEEDS=10.x.x.x                  -- csv of cassandra server ipaddrs
    -e KEYSPACE=<keyspace>                              -- Cassandra keyspace
    -e VISIBILITY_KEYSPACE=<visibility_keyspace>        -- Cassandra visibility keyspace
    -e SKIP_SCHEMA_SETUP=true                           -- do not setup cassandra schema during startup
    -e NUM_HISTORY_SHARDS=1024  \                       -- Number of history shards
    -e SERVICES=history,matching \                      -- Spinup only the provided services
    -e LOG_LEVEL=debug,info \                           -- Logging level
    -e DYNAMIC_CONFIG_FILE_PATH=config/foo.yaml         -- Dynamic config file to be watched
    temporalio/server:<tag>