]> git.apps.os.sepia.ceph.com Git - ceph.git/commitdiff
doc: add instructions for compiling cephadm
authorJohn Mulligan <jmulligan@redhat.com>
Mon, 22 May 2023 18:20:19 +0000 (14:20 -0400)
committerJohn Mulligan <jmulligan@redhat.com>
Tue, 30 May 2023 15:49:21 +0000 (11:49 -0400)
Now that cephadm is based on zipapp, add a short section to the
developer docs explaining how to build cephadm yourself.

Signed-off-by: John Mulligan <jmulligan@redhat.com>
doc/dev/cephadm/developing-cephadm.rst

index 8df292330ec31575d8115e46830f9d153e0290ca..d71c87b6a37a1635c36ab1f9e147483ec8139723 100644 (file)
@@ -388,3 +388,15 @@ Note regarding different variables used in the code
 * a ``daemon_id`` is typically ``<service_id>.<hostname>.<random-string>``.
   (Not the case for e.g. OSDs. OSDs are always called OSD.N)
 * a ``daemon_name`` is ``<daemon_type>.<daemon_id>``
+
+
+Compiling cephadm
+=================
+
+Recent versions of cephadm are based on `Python Zip Application`_ support, and
+is "compiled" from Python source code files in the ceph tree. To create your
+own copy of the cephadm "binary" use the script located at
+``src/cephadm/build.py`` in the Ceph tree.  The command should take the form
+``./src/cephadm/build.py [output]``.
+
+.. _Python Zip Application: https://peps.python.org/pep-0441/