ceph/doc/install/containers.rst

   1 .. _containers:
   2
   3 Ceph Container Images
   4 =====================
   5
   6 Official Releases
   7 -----------------
   8
   9 Ceph Container images are available from Docker Hub at::
  10
  11   https://hub.docker.com/r/ceph
  12
  13
  14 ceph/ceph
  15 ^^^^^^^^^
  16
  17 - General purpose Ceph container with all necessary daemons and
  18   dependencies installed.
  19
  20 +----------------------+--------------------------------------------------------------+
  21 | Tag                  | Meaning                                                      |
  22 +----------------------+--------------------------------------------------------------+
  23 | vRELNUM              | Latest release in this series (e.g., *v14* = Nautilus)       |
  24 +----------------------+--------------------------------------------------------------+
  25 | vRELNUM.2            | Latest *stable* release in this stable series (e.g., *v14.2*)|
  26 +----------------------+--------------------------------------------------------------+
  27 | vRELNUM.Y.Z          | A specific release (e.g., *v14.2.4*)                         |
  28 +----------------------+--------------------------------------------------------------+
  29 | vRELNUM.Y.Z-YYYYMMDD | A specific build (e.g., *v14.2.4-20191203*)                  |
  30 +----------------------+--------------------------------------------------------------+
  31
  32 ceph/daemon-base
  33 ^^^^^^^^^^^^^^^^
  34
  35 - General purpose Ceph container with all necessary daemons and
  36   dependencies installed.
  37 - Basically the same as *ceph/ceph*, but with different tags.
  38 - Note that all of the *-devel* tags (and the *latest-master* tag) are based on
  39   unreleased and generally untested packages from https://shaman.ceph.com.
  40
  41 :note: This image will soon become an alias to *ceph/ceph*.
  42
  43 +------------------------+---------------------------------------------------------+
  44 | Tag                    | Meaning                                                 |
  45 +------------------------+---------------------------------------------------------+
  46 | latest-master          | Build of master branch a last ceph-container.git update |
  47 +------------------------+---------------------------------------------------------+
  48 | latest-master-devel    | Daily build of the master branch                        |
  49 +------------------------+---------------------------------------------------------+
  50 | latest-RELEASE-devel   | Daily build of the *RELEASE* (e.g., nautilus) branch    |
  51 +------------------------+---------------------------------------------------------+
  52
  53
  54 ceph/daemon
  55 ^^^^^^^^^^^
  56
  57 - *ceph/daemon-base* plus a collection of BASH scripts that are used
  58   by ceph-nano and ceph-ansible to manage a Ceph cluster.
  59
  60 +------------------------+---------------------------------------------------------+
  61 | Tag                    | Meaning                                                 |
  62 +------------------------+---------------------------------------------------------+
  63 | latest-master          | Build of master branch a last ceph-container.git update |
  64 +------------------------+---------------------------------------------------------+
  65 | latest-master-devel    | Daily build of the master branch                        |
  66 +------------------------+---------------------------------------------------------+
  67 | latest-RELEASE-devel   | Daily build of the *RELEASE* (e.g., nautilus) branch    |
  68 +------------------------+---------------------------------------------------------+
  69
  70
  71 Development builds
  72 ------------------
  73
  74 We automatically build container images for development ``wip-*``
  75 branches in the ceph-ci.git repositories and push them to Quay at::
  76
  77   https://quay.io/organization/ceph-ci
  78
  79 ceph-ci/ceph
  80 ^^^^^^^^^^^^
  81
  82 - This is analogous to the ceph/ceph image above
  83 - TODO: remove the ``wip-*`` limitation and also build ceph.git branches.
  84
  85 +------------------------------------+------------------------------------------------------+
  86 | Tag                                | Meaning                                              |
  87 +------------------------------------+------------------------------------------------------+
  88 | BRANCH                             | Latest build of a given GIT branch (e.g., *wip-foo*) |
  89 +------------------------------------+------------------------------------------------------+
  90 | BRANCH-SHORTSHA1-BASEOS-ARCH-devel | A specific build of a branch                         |
  91 +------------------------------------+------------------------------------------------------+
  92 | SHA1                               | A specific build                                     |
  93 +------------------------------------+------------------------------------------------------+