With each release, the maintainers publish a docker image to dockerhub at parity/substrate-api-sidecar
docker pull docker.io/parity/substrate-api-sidecar:latest
The specific image tag matches the release version.
yarn build:docker
# For default use run:
docker run --rm -it --read-only -p 8080:8080 substrate-api-sidecar
# Or if you want to use environment variables set in `.env.docker`, run:
docker run --rm -it --read-only --env-file .env.docker -p 8080:8080 substrate-api-sidecar
NOTE: While you could omit the --read-only
flag, it is strongly recommended for containers used in production.
then you can test with:
curl -s http://0.0.0.0:8080/blocks/head | jq
N.B. The docker flow presented here is just a sample to help get started. Modifications may be necessary for secure usage.
Starting with v6.0.0 of docker/build-push-action
package, Docker-build summaries are generated and exported by default.
Currently in Sidecar we do not have a major need to keep records of Docker builds, so we have disabled this feature by setting the DOCKER_BUILD_RECORD_UPLOAD
and DOCKER_BUILD_SUMMARY
environment variables to false
.
If this is needed in the future maybe for debugging reasons, we can adjust these variables accordingly.