doc/md/Shaarli-images.md

   1 ## Get and run a Shaarli image
   2
   3 ### DockerHub repository
   4 The images can be found in the [`shaarli/shaarli`](https://hub.docker.com/r/shaarli/shaarli/)
   5 repository.
   6
   7 ### Available image tags
   8 - `latest`: master branch (tarball release)
   9 - `stable`: stable branch (tarball release)
  10 - `dev`: master branch (Git clone)
  11
  12 All images rely on:
  13 - [Debian 8 Jessie](https://hub.docker.com/_/debian/)
  14 - [PHP5-FPM](http://php-fpm.org/)
  15 - [Nginx](http://nginx.org/)
  16
  17 ### Download from DockerHub
  18 ```bash
  19 $ docker pull shaarli/shaarli
  20 latest: Pulling from shaarli/shaarli
  21 32716d9fcddb: Pull complete
  22 84899d045435: Pull complete
  23 4b6ad7444763: Pull complete
  24 e0345ef7a3e0: Pull complete
  25 5c1dd344094f: Pull complete
  26 6422305a200b: Pull complete
  27 7d63f861dbef: Pull complete
  28 3eb97210645c: Pull complete
  29 869319d746ff: Already exists
  30 869319d746ff: Pulling fs layer
  31 902b87aaaec9: Already exists
  32 Digest: sha256:f836b4627b958b3f83f59c332f22f02fcd495ace3056f2be2c4912bd8704cc98
  33 Status: Downloaded newer image for shaarli/shaarli:latest
  34 ```
  35
  36 ### Create and start a new container from the image
  37 ```bash
  38 # map the host's :8000 port to the container's :80 port
  39 $ docker create -p 8000:80 shaarli/shaarli
  40 d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101
  41
  42 # launch the container in the background
  43 $ docker start d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101
  44 d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101
  45
  46 # list active containers
  47 $ docker ps
  48 CONTAINER ID  IMAGE            COMMAND               CREATED         STATUS        PORTS                 NAMES
  49 d40b7af693d6  shaarli/shaarli  /usr/bin/supervisor  15 seconds ago  Up 4 seconds  0.0.0.0:8000->80/tcp  backstabbing_galileo
  50 ```
  51
  52 ### Stop and destroy a container
  53 ```bash
  54 $ docker stop backstabbing_galileo  # those docker guys are really rude to physicists!
  55 backstabbing_galileo
  56
  57 # check the container is stopped
  58 $ docker ps
  59 CONTAINER ID  IMAGE            COMMAND               CREATED         STATUS        PORTS                 NAMES
  60
  61 # list ALL containers
  62 $ docker ps -a
  63 CONTAINER ID        IMAGE               COMMAND                CREATED             STATUS                      PORTS               NAMES
  64 d40b7af693d6        shaarli/shaarli     /usr/bin/supervisor   5 minutes ago       Exited (0) 48 seconds ago                       backstabbing_galileo
  65
  66 # destroy the container
  67 $ docker rm backstabbing_galileo  # let's put an end to these barbarian practices
  68 backstabbing_galileo
  69
  70 $ docker ps -a
  71 CONTAINER ID  IMAGE            COMMAND               CREATED         STATUS        PORTS                 NAMES
  72 ```