]> git-server-git.apps.pok.os.sepia.ceph.com Git - ceph.git/commit
doc: update the cephadm download instructions 51886/head
authorJohn Mulligan <jmulligan@redhat.com>
Mon, 19 Sep 2022 17:46:48 +0000 (13:46 -0400)
committerZac Dover <zac.dover@proton.me>
Fri, 2 Jun 2023 13:59:13 +0000 (23:59 +1000)
commita6447efbd74a37a3c9ee8ba1cd057169231fcfa6
tree121b08f327691779c556527f304fd4f19e6e9ab7
parent8e24bcf462a1d94c2e12aa4e26419634883a1e88
doc: update the cephadm download instructions

Starting with reef, cephadm is a compiled (zipapp) python application.
The cephadm script has been renamed and thus the old curl-based
download instructions will no loner work. While cephadm still has
no dependencies outside the Python stdlib, this will be changed in
future versions so it is no longer appropriate to just download the
source file of cephadm and run it either.

This change updates the `Install cephadm` section of the doc to explain
how to acquire a "compiled" version of cephadm as well as:
* moving and tweaking the note that the two installation methods are
  distinct
* adding a new note linking to instructions on building cephadm
* moving the distribution-specific installations before the curl-based
  installation to subtly hint that we prefer you to get it using
  packages if you can
* Noting cephadm's minimal required python verision and how to run it
  with a particular python version.

Note from Zac Dover, June 1, 2023: Note: This commit is a cherry-pick of
d11cf0e, which was introduced by John Mulligan in #48180. This is one of
three commits introduced in that PR, and this cherry-pick cleans up
omissions I (Zac Dover) inadvertently introduced while attempting to
rectify the merge conflicts in #51843. This should be the final
main-branch-targeting commit that cleans up PR#51483.

Signed-off-by: John Mulligan <jmulligan@redhat.com>
(cherry picked from commit d11cf0e82aab8d4cef9d423e5d463a373eaf383a)
(cherry picked from commit 7c6a2cad96405616719b85c740aabd98558c93ac)
doc/cephadm/install.rst