doc: add a install-debian.rst

This patch adds a section on how to install CloudKitty on Debian,
which is the primary source for Ubuntu packages.

Change-Id: Ie6df6ccb5f9b7873bb541cedb45b044058ab3e70
Signed-off-by: Thomas Goirand <zigo@debian.org>

doc/source/admin/install/index.rst

@@ -6,6 +6,7 @@ Installation Guide
    :glob:
 
    install-source
+   install-debian
    install-ubuntu
    install-rdo
    mod_wsgi

doc/source/admin/install/install-debian.rst

@@ -0,0 +1,45 @@
+Install from packages for Debian
+================================
+
+Packages for Debian are available since CloudKitty 6.0.0 (OpenStack Pike) in
+2018.
+
+Optional: enable the OpenStack repository for a specific release
+----------------------------------------------------------------
+
+If using Debian Stable, and do not wish to install unofficial backports from
+osbpo.debian.net, skip this step. Otherwise, here is how to enable the
+repository:
+
+.. code-block:: console
+
+   apt-get install extrepo
+   extrepo search openstack
+   extrepo enable openstack_epoxy
+   apt-get update
+
+Note that it is possible to use a local mirror, and avoid internet access, by
+using the extrepo-offline-data package:
+
+.. code-block:: console
+
+   apt-get install extrepo-offline-data
+   extrepo search openstack --offlinedata
+   extrepo enable openstack_epoxy --offlinedata --mirror YOUR_MIRROR
+
+Note that extrepo-offline-data may be lagging behind the online data and it may
+not contain the latest OpenStack repositories.
+
+Upgrade the packages on your host
+---------------------------------
+
+.. code-block:: console
+
+   apt update && apt dist-upgrade
+
+Install the packages
+--------------------
+
+.. code-block:: console
+
+   apt-get install cloudkitty-api cloudkitty-processor cloudkitty-dashboard

doc/source/admin/install/install-ubuntu.rst

@@ -1,13 +1,9 @@
-Install from packages for Ubuntu (16.04)
-========================================
+Install from packages for Ubuntu
+================================
 
-Packages for Ubuntu 16.04 are available starting from the Newton release.
-
-#. Enable the OpenStack repository for the Newton or Ocata release::
-
-    apt install software-properties-common
-    add-apt-repository ppa:objectif-libre/cloudkitty # Newton
-    add-apt-repository ppa:objectif-libre/cloudkitty-ocata # Ocata
+Note that Canonical doesn't maintain CloudKitty packages. These are only
+maintained in Debian, and then imported from Debian Unstable to the
+Ubuntu Universe repository.
 
 #. Upgrade the packages on your host::