mirror of
https://github.com/ceph/ceph
synced 2026-08-01 22:45:39 +00:00
3fe15c1f71
Use ref instead of external link definitions for intra-docs links. Add labels if necessary in files within the install/ directory. Use existing labels for links outside the install/ directory but do not add new labels outside of the install/ directory. Signed-off-by: Ville Ojamo <git2233+ceph@ojamo.eu>
57 lines
1.7 KiB
ReStructuredText
57 lines
1.7 KiB
ReStructuredText
.. _install-overview:
|
|
|
|
===============
|
|
Installing Ceph
|
|
===============
|
|
|
|
There are multiple ways to install Ceph.
|
|
|
|
Recommended methods
|
|
~~~~~~~~~~~~~~~~~~~
|
|
|
|
:ref:`Cephadm <cephadm_deploying_new_cluster>` is a tool that can be used to
|
|
install and manage a Ceph cluster.
|
|
|
|
* 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
|
|
Python 3.
|
|
* cephadm requires systemd.
|
|
|
|
`Rook <https://rook.io/>`_ deploys and manages Ceph clusters running
|
|
in Kubernetes, while also enabling management of storage resources and
|
|
provisioning via Kubernetes APIs. We recommend Rook as the way to run Ceph in
|
|
Kubernetes or to connect an existing Ceph storage cluster to Kubernetes.
|
|
|
|
* Rook is the preferred method for running Ceph on Kubernetes, or for
|
|
connecting a Kubernetes cluster to an existing (external) Ceph
|
|
cluster.
|
|
* Rook supports the orchestrator API. Management features in the CLI and
|
|
dashboard are fully supported.
|
|
|
|
Other methods
|
|
~~~~~~~~~~~~~
|
|
|
|
`ceph-salt <https://github.com/ceph/ceph-salt>`_ installs Ceph using Salt and cephadm.
|
|
|
|
`jaas.ai/ceph-mon <https://jaas.ai/ceph-mon>`_ installs Ceph using Juju.
|
|
|
|
`github.com/openstack/puppet-ceph <https://github.com/openstack/puppet-ceph>`_ installs Ceph via Puppet.
|
|
|
|
`OpenNebula HCI clusters <https://docs.opennebula.io/stable/provision_clusters/hci_clusters/overview.html>`_ deploys Ceph on various cloud platforms.
|
|
|
|
Ceph can also be :ref:`installed manually <install-manual>`.
|
|
|
|
|
|
.. toctree::
|
|
:hidden:
|
|
|
|
index_manual
|
|
|
|
Windows
|
|
~~~~~~~
|
|
|
|
For Windows installations, consult this document:
|
|
:ref:`install-windows`.
|
