2020-02-28 13:19:40 +00:00
|
|
|
.. _install-overview:
|
2012-11-07 22:09:57 +00:00
|
|
|
|
2020-02-28 13:19:40 +00:00
|
|
|
===============
|
|
|
|
|
Installing Ceph
|
|
|
|
|
===============
|
2012-05-18 20:54:51 +00:00
|
|
|
|
2023-12-15 15:54:02 +00:00
|
|
|
There are multiple ways to install Ceph.
|
2020-02-28 13:19:40 +00:00
|
|
|
|
2020-03-15 13:45:46 +00:00
|
|
|
Recommended methods
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~
|
2020-03-11 15:28:28 +00:00
|
|
|
|
2023-10-29 11:47:04 +00:00
|
|
|
:ref:`Cephadm <cephadm_deploying_new_cluster>` is a tool that can be used to
|
2023-12-15 15:54:02 +00:00
|
|
|
install and manage a Ceph cluster.
|
2023-01-21 16:32:59 +00:00
|
|
|
|
|
|
|
|
* cephadm supports only Octopus and newer releases.
|
|
|
|
|
* cephadm is fully integrated with the orchestration API and fully supports the
|
|
|
|
|
CLI and dashboard features that are used to manage cluster deployment.
|
|
|
|
|
* cephadm requires container support (in the form of Podman or Docker) and
|
2020-03-15 13:45:46 +00:00
|
|
|
Python 3.
|
2023-10-29 11:47:04 +00:00
|
|
|
* cephadm requires systemd.
|
2020-03-11 15:28:28 +00:00
|
|
|
|
2020-03-15 13:45:46 +00:00
|
|
|
`Rook <https://rook.io/>`_ deploys and manages Ceph clusters running
|
|
|
|
|
in Kubernetes, while also enabling management of storage resources and
|
2023-01-21 16:32:59 +00:00
|
|
|
provisioning via Kubernetes APIs. We recommend Rook as the way to run Ceph in
|
2020-03-15 13:45:46 +00:00
|
|
|
Kubernetes or to connect an existing Ceph storage cluster to Kubernetes.
|
2020-03-11 15:28:28 +00:00
|
|
|
|
2023-01-21 16:32:59 +00:00
|
|
|
* Rook supports only Nautilus and newer releases of Ceph.
|
2020-03-15 13:45:46 +00:00
|
|
|
* Rook is the preferred method for running Ceph on Kubernetes, or for
|
|
|
|
|
connecting a Kubernetes cluster to an existing (external) Ceph
|
|
|
|
|
cluster.
|
2023-01-21 16:32:59 +00:00
|
|
|
* Rook supports the orchestrator API. Management features in the CLI and
|
|
|
|
|
dashboard are fully supported.
|
2020-03-11 15:28:28 +00:00
|
|
|
|
2020-03-15 13:45:46 +00:00
|
|
|
Other methods
|
|
|
|
|
~~~~~~~~~~~~~
|
2020-03-11 15:28:28 +00:00
|
|
|
|
2020-03-15 13:45:46 +00:00
|
|
|
`ceph-ansible <https://docs.ceph.com/ceph-ansible/>`_ deploys and manages
|
|
|
|
|
Ceph clusters using Ansible.
|
2020-03-11 15:28:28 +00:00
|
|
|
|
2020-03-15 13:45:46 +00:00
|
|
|
* ceph-ansible is widely deployed.
|
2023-01-21 16:32:59 +00:00
|
|
|
* ceph-ansible is not integrated with the orchestrator APIs that were
|
|
|
|
|
introduced in Nautilus and Octopus, which means that the management features
|
|
|
|
|
and dashboard integration introduced in Nautilus and Octopus are not
|
|
|
|
|
available in Ceph clusters deployed by means of ceph-ansible.
|
2020-03-11 15:28:28 +00:00
|
|
|
|
|
|
|
|
|
2023-01-21 16:32:59 +00:00
|
|
|
`ceph-deploy <https://docs.ceph.com/projects/ceph-deploy/en/latest/>`_ is a
|
|
|
|
|
tool that can be used to quickly deploy clusters. It is deprecated.
|
2013-10-11 22:08:22 +00:00
|
|
|
|
2020-03-11 15:28:28 +00:00
|
|
|
.. IMPORTANT::
|
2013-10-11 22:08:22 +00:00
|
|
|
|
2023-01-21 16:32:59 +00:00
|
|
|
ceph-deploy is not actively maintained. It is not tested on versions of Ceph
|
|
|
|
|
newer than Nautilus. It does not support RHEL8, CentOS 8, or newer operating
|
|
|
|
|
systems.
|
2012-11-08 06:42:41 +00:00
|
|
|
|
2021-02-08 12:35:02 +00:00
|
|
|
`ceph-salt <https://github.com/ceph/ceph-salt>`_ installs Ceph using Salt and cephadm.
|
2016-02-08 11:11:21 +00:00
|
|
|
|
2020-03-15 13:45:46 +00:00
|
|
|
`jaas.ai/ceph-mon <https://jaas.ai/ceph-mon>`_ installs Ceph using Juju.
|
2013-11-21 03:27:20 +00:00
|
|
|
|
2020-03-15 13:45:46 +00:00
|
|
|
`github.com/openstack/puppet-ceph <https://github.com/openstack/puppet-ceph>`_ installs Ceph via Puppet.
|
2012-11-08 06:42:41 +00:00
|
|
|
|
2023-12-15 15:54:02 +00:00
|
|
|
`OpenNebula HCI clusters <https://docs.opennebula.io/stable/provision_clusters/hci_clusters/overview.html>`_ deploys Ceph on various cloud platforms.
|
|
|
|
|
|
2020-03-15 13:45:46 +00:00
|
|
|
Ceph can also be :ref:`installed manually <install-manual>`.
|
2012-11-08 06:42:41 +00:00
|
|
|
|
|
|
|
|
|
2020-03-13 14:15:29 +00:00
|
|
|
.. toctree::
|
|
|
|
|
:hidden:
|
|
|
|
|
|
2020-03-15 13:45:46 +00:00
|
|
|
index_manual
|
2020-02-28 13:19:40 +00:00
|
|
|
|
2021-03-15 07:38:00 +00:00
|
|
|
Windows
|
|
|
|
|
~~~~~~~
|
2020-02-28 13:19:40 +00:00
|
|
|
|
2023-01-21 16:32:59 +00:00
|
|
|
For Windows installations, consult this document:
|
2021-03-15 07:38:00 +00:00
|
|
|
`Windows installation guide`_.
|
2020-02-28 13:19:40 +00:00
|
|
|
|
2021-03-15 07:38:00 +00:00
|
|
|
.. _Windows installation guide: ./windows-install
|
