diff options
Diffstat (limited to 'docs/docker.rst')
-rw-r--r-- | docs/docker.rst | 72 |
1 files changed, 70 insertions, 2 deletions
diff --git a/docs/docker.rst b/docs/docker.rst index f54a0816..fe005f0f 100644 --- a/docs/docker.rst +++ b/docs/docker.rst @@ -9,7 +9,24 @@ Get the Glances container: .. code-block:: console - docker pull nicolargo/glances + docker pull nicolargo/glances:<version> + +Available tags (all images are based on both Alpine and Ubuntu Operating System): + +- *latest-full* for a full Alpine Glances image (latest release) with all dependencies +- *latest* for a basic Alpine Glances (latest release) version with minimal dependencies (Bottle and Docker) +- *dev* for a basic Alpine Glances image (based on development branch) with all dependencies (Warning: may be instable) +- *ubuntu-latest-full* for a full Ubuntu Glances image (latest release) with all dependencies +- *ubuntu-latest* for a basic Ubuntu Glances (latest release) version with minimal dependencies (Bottle and Docker) +- *ubuntu-dev* for a basic Ubuntu Glances image (based on development branch) with all dependencies (Warning: may be instable) + +You can also specify a version (example: 3.4.0). All available versions can be found on `DockerHub`_. + +An Example to pull the `latest` tag: + +.. code-block:: console + + docker pull nicolargo/glances:latest Run the container in *console mode*: @@ -75,7 +92,7 @@ You can also include Glances container in you own `docker-compose.yml`. Here's a - "traefik.frontend.rule=Host:glances.docker.localhost" How to protect your Dockerized server (or Web server) with a login/password ? ------------------------------------------------------------------- +----------------------------------------------------------------------------- Below are two methods for setting up a login/password to protect Glances running inside a Docker container. @@ -152,3 +169,54 @@ You can add a ``[passwords]`` block to the Glances configuration file as mention # Additionally (and optionally) a default password could be defined localhost=mylocalhostpassword default=mydefaultpassword + +Using GPU Plugin with Docker (Only Nvidia GPUs) +----------------------------------------------- + +Complete the steps mentioned in the `docker docs <https://docs.docker.com/config/containers/resource_constraints/#gpu>`_ +to make the GPU accessible by the docker engine. + +With `docker run` +^^^^^^^^^^^^^^^^^ +Include the `--gpus` flag with the `docker run` command. + +**Note:** Make sure the `--gpus` is present before the image name in the command, otherwise it won't work. + +.. code-block:: ini + + docker run --rm -v /var/run/docker.sock:/var/run/docker.sock:ro --gpus --pid host --network host -it docker.io/nicolargo/glances:latest-full + +.. + + +With `docker-compose` +^^^^^^^^^^^^^^^^^^^^^ +Include the `deploy` section in compose file as specified below in the example service definition. + +.. code-block:: ini + + version: '3' + + services: + monitoring: + image: nicolargo/glances:latest-full + pid: host + network_mode: host + volumes: + - /var/run/docker.sock:/var/run/docker.sock + environment: + - "GLANCES_OPT=-w" + # For nvidia GPUs + deploy: + resources: + reservations: + devices: + - driver: nvidia + count: 1 + capabilities: [gpu] + +.. + +Reference: https://docs.docker.com/compose/gpu-support/ + +.. _DockerHub: https://hub.docker.com/r/nicolargo/glances/tags |