comparison doc/installation.txt @ 7042:031cdb92fa1d

Replace hardcoded python version with ARG variable The Dockerfile had a hardcoded Python version in install paths and COPY command in the second stage build. Replace that with a hardcoded ARG pythonversion. Add RUN command to verify pythonversion against the actual version installed in the docker image. If they do not match generate an appropriate --build-arg for the docker build command that will match the docker image version. Document the use of the variable and why it's needed in installation.txt. Also fix typos referencing --build-args and bad values for the arguments.
author John Rouillard <rouilj@ieee.org>
date Mon, 07 Nov 2022 00:45:53 -0500
parents b5f8b85351a9
children 48da482d7d93
comparison
equal deleted inserted replaced
7041:0fc6e5d551b3 7042:031cdb92fa1d
288 -f scripts/Docker/Dockerfile . 288 -f scripts/Docker/Dockerfile .
289 289
290 The docker declares a single volume mounted at 290 The docker declares a single volume mounted at
291 ``/usr/src/app/tracker`` inside the container. You will mount your 291 ``/usr/src/app/tracker`` inside the container. You will mount your
292 tracker home directory at this location. The ``/usr/src/app`` path can 292 tracker home directory at this location. The ``/usr/src/app`` path can
293 be changed by using ``--build-args=/new/path``. 293 be changed by using ``--build-arg="appdir=/new/path"``.
294 294
295 You can also add additional modules to the docker container by using 295 You can also add additional modules to the docker container by using
296 `--build-args="pip_mod=requests setproctitle"`. 296 `--build-arg="pip_mod=requests setproctitle"`.
297
298 Because of deficiencies in the docker program (see:
299 https://github.com/moby/moby/issues/29110#issuecomment-1100676306),
300 there is no way to determine the version of Python inside the
301 container and make that available as part of the build process. If
302 your build fails because the ``pythonversion does not match``, add the
303 suggested ``--build-arg`` to the ``docker build`` command line.
297 304
298 By default the container runs Roundup using UID 1000. By setting 305 By default the container runs Roundup using UID 1000. By setting
299 `--build-args="roundup_uid=2000"` you can change the UID. 306 `--build-arg="roundup_uid=2000"` you can change the UID.
300 307
301 Configuring Roundup in the Container 308 Configuring Roundup in the Container
302 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 309 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
303 310
304 Once the docker is created using one of the build commands above, run 311 Once the docker is created using one of the build commands above, run

Roundup Issue Tracker: http://roundup-tracker.org/