From: Michael Wodniok <wodniok@wor.net>
Date: Tue, 22 Dec 2020 09:46:54 +0000 (+0100)
Subject: doc: added section about retival of Service Spec.
X-Git-Tag: v16.2.0~230^2~45
X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=d485b50551bf695b8ebf0663199d8c9735e21ee1;p=ceph.git

doc: added section about retival of Service Spec.

Signed-off-by: Michael Wodniok <wodniok@wor.net>
(cherry picked from commit 84bdafe0e36e11fb8b57065625a5ecb49fd3c248)
---

diff --git a/doc/mgr/orchestrator.rst b/doc/mgr/orchestrator.rst
index f22a4a684b0..266e83aa59e 100644
--- a/doc/mgr/orchestrator.rst
+++ b/doc/mgr/orchestrator.rst
@@ -743,6 +743,18 @@ Many service specifications can be applied at once using
       all: true
     EOF
 
+Retrieving the running Service Specification
+--------------------------------------------
+
+If started via ``ceph orch apply <rgw|mds|...>`` changing the Service
+Specification directly is normally a bit more complicated. It is easier to
+export the running Service Specification like so::
+    
+    ceph orch ls rgw rgw.<id> --export yaml >rgw.<id>.yaml
+    ceph orch ls mgr mgr --export yaml >mgr.yaml
+
+The Specification can then be changed and re-applied as above.
+
 .. _orchestrator-cli-placement-spec:
 
 Placement Specification