Mercurial > hg > orthanc-book
changeset 673:767c2550fa00
environment variable in docker compose
author | Sebastien Jodogne <s.jodogne@gmail.com> |
---|---|
date | Thu, 06 May 2021 12:37:40 +0200 |
parents | 8bda16db46cf |
children | 5ec581c7e610 |
files | Sphinx/source/users/configuration.rst Sphinx/source/users/docker.rst |
diffstat | 2 files changed, 16 insertions(+), 4 deletions(-) [+] |
line wrap: on
line diff
--- a/Sphinx/source/users/configuration.rst Mon May 03 14:31:42 2021 +0200 +++ b/Sphinx/source/users/configuration.rst Thu May 06 12:37:40 2021 +0200 @@ -82,6 +82,8 @@ page <log>`. +.. _orthanc-environment-variables: + Environment variables ---------------------
--- a/Sphinx/source/users/docker.rst Mon May 03 14:31:42 2021 +0200 +++ b/Sphinx/source/users/docker.rst Thu May 06 12:37:40 2021 +0200 @@ -147,7 +147,7 @@ unfortunately it is only available to `Docker Swarm <https://github.com/docker/compose/issues/5110>`__). -.. highlight:: yml +.. highlight:: yaml First create the ``docker-compose.yml`` file as follows (this one uses the `YAML file format <https://en.wikipedia.org/wiki/YAML>`__):: @@ -161,7 +161,9 @@ - 4242:4242 - 8042:8042 secrets: - - orthanc.json + - orthanc.json + environment: + - ORTHANC_NAME=HelloWorld secrets: orthanc.json: file: orthanc.json @@ -172,7 +174,7 @@ ``docker-compose.yml`` file. Here is a minimalist ``orthanc.json``:: { - "Name" : "Orthanc in Docker", + "Name" : "${ORTHANC_NAME} in Docker Compose", "RemoteAccessAllowed" : true } @@ -184,7 +186,15 @@ $ docker-compose up +Note how the `environment variable +<https://docs.docker.com/compose/environment-variables/>`__ +``ORTHANC_NAME`` has been used in order to easily adapt the +configuration of Orthanc. This results from the fact that Orthanc +injects :ref:`environment variables <orthanc-environment-variables>` +once reading the content of its configuration files (since Orthanc +1.5.0). + Making the Orthanc database persistent -------------------------------------- @@ -261,7 +271,7 @@ $ docker inspect --format '{{ .NetworkSettings.Ports }}' some-postgres $ docker run --rm --entrypoint=cat jodogne/orthanc-plugins /etc/orthanc/orthanc.json > /tmp/orthanc.json -.. highlight:: json +.. highlight:: text Add the following section to ``/tmp/orthanc.json`` (adapting the values Host and Port to what docker inspect said above)::