Add tt rs bootstrap and rebootstrap (#4482)

Resolves: #4376, #4362

Author: p7nov

doc/tooling/tt_cli/replicaset.rst

@@ -18,7 +18,8 @@ Managing replica sets
 *   :ref:`demote <tt-replicaset-demote>`
 *   :ref:`expel <tt-replicaset-expel>`
 *   :ref:`vshard <tt-replicaset-vshard>`
-
+*   :ref:`bootstrap <tt-replicaset-bootstrap>`
+*   :ref:`rebootstrap <tt-replicaset-rebootstrap>`
 
 .. _tt-replicaset-status:
 
@@ -29,11 +30,10 @@ status
 
     $ tt replicaset status {APPLICATION[:APP_INSTANCE] | URI} [OPTIONS ...]
     # or
-    $ tt rs status  {APPLICATION[:APP_INSTANCE] | URI} [OPTIONS ...]
+    $ tt rs status {APPLICATION[:APP_INSTANCE] | URI} [OPTIONS ...]
 
 ``tt replicaset status`` (``tt rs status``) shows the current status of a replica set.
 
-
 .. _tt-replicaset-status-application:
 
 Displaying status of all replica sets
@@ -66,7 +66,6 @@ For a replica outside the current ``tt`` environment, specify its URI and access
 
 Learn about other ways to provide user credentials in :ref:`tt-replicaset-authentication`.
 
-
 .. _tt-replicaset-promote:
 
 promote
@@ -305,6 +304,93 @@ To bootstrap ``vshard`` in a Cartridge cluster:
 
     $ tt replicaset vshard bootstrap my-cartridge-app --cartridge
 
+.. _tt-replicaset-bootstrap:
+
+bootstrap
+---------
+
+..  include:: _includes/cartridge_deprecation_note.rst
+
+..  code-block:: console
+
+    $ tt replicaset bootstrap APPLICATION[:APP_INSTANCE] [OPTIONS ...]
+    # or
+    $ tt rs bootstrap APPLICATION[:APP_INSTANCE] [OPTIONS ...]
+
+``tt replicaset bootstrap`` (``tt rs bootstrap``) bootstraps a Cartridge cluster or
+an instance. The command works within the current ``tt`` environment and uses
+application and instance names.
+
+.. note::
+
+    ``tt replicasets bootstrap`` effectively duplicates two other commands:
+
+    -   When called with an application name: :ref:`tt cartridge replicasets setup <tt_cartridge_replicasets_setup>`
+    -   When called with an instance name: :ref:`tt cartridge replicasets join <tt_cartridge_replicasets_join>`
+
+.. _tt-replicaset-bootstrap-cluster:
+
+Bootstrapping a Cartridge cluster
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To bootstrap the ``cartridge_app`` application using its default replica sets file
+``replicasets.yml``:
+
+..  code-block:: console
+
+    $ tt replicaset bootstrap cartridge_app
+
+To use another file with replica set configuration, provide a path to it in the ``--file`` option:
+
+..  code-block:: console
+
+    $ tt replicaset bootstrap cartridge_app --file replicasets1.yml
+
+To additionally bootstrap vshard after the cluster bootstrap, add ``--bootstrap-vshard``:
+
+..  code-block:: console
+
+    $ tt replicaset bootstrap --bootstrap-vshard cartridge_app
+
+
+.. _tt-replicaset-bootstrap-instance:
+
+Bootstrapping an instance
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When called with the instance name, ``tt replicaset bootstrap`` joins the
+instance to the replica set specified in the ``--replicaset`` option:
+
+..  code-block:: console
+
+    $ tt replicaset bootstrap --replicaset replicaset cartridge_app:instance1
+
+.. _tt-replicaset-rebootstrap:
+
+rebootstrap
+-----------
+
+..  code-block:: console
+
+    $ tt replicaset rebootstrap APPLICATION:APP_INSTANCE [-y | --yes]
+    # or
+    $ tt rs rebootstrap APPLICATION:APP_INSTANCE [-y | --yes]
+
+``tt replicaset rebootstrap`` (``tt rs rebootstrap``) rebootstraps an instance:
+stops it, removes instance artifacts, starts it again.
+
+To rebootstrap the ``storage-001`` instance of the ``myapp`` application:
+
+..  code-block:: console
+
+    $ tt replicaset rebootstrap myapp:storage-001
+
+To automatically confirm reboostrap, add the ``-y``/``--yes`` option:
+
+..  code-block:: console
+
+    $ tt replicaset rebootstrap myapp:storage-001 -y
+
 .. _tt-replicaset-orchestrator:
 
 Selecting the application orchestrator manually
@@ -358,6 +444,12 @@ connecting to the instance by its URI:
 Options
 -------
 
+..  option:: --bootstrap-vshard
+
+    **Applicable to:** ``bootstrap``
+
+    Additionally bootstrap vshard when bootstrapping a Cartridge application.
+
 ..  option:: --cartridge
 
     Force the Cartridge orchestrator for Tarantool 2.x clusters.
@@ -370,12 +462,29 @@ Options
 
     Force a custom orchestrator for Tarantool 2.x clusters.
 
+..  option:: --file FILE
+
+    **Applicable to:** ``bootstrap``
+
+    A file with Cartridge replica sets configuration. Default: ``instances.yml``
+    in the application directory.
+
+    See also: :ref:`tt-replicaset-bootstrap-cluster`
+
 ..  option:: -f, --force
 
     **Applicable to:** ``promote``, ``demote``
 
     Skip promotion or demotion if the specified instance is not running in the same environment.
 
+..  option:: --replicaset REPLICASET
+
+    **Applicable to:** ``bootstrap``
+
+    A replica set name for instance bootstrapping.
+
+    See also: :ref:`tt-replicaset-bootstrap-instance`
+
 ..  option:: -u USERNAME, --username USERNAME
 
     A Tarantool user for connecting to the instance using a URI.
@@ -402,9 +511,15 @@ Options
 
 ..  option:: --timeout
 
-    **Applicable to:** ``promote``, ``demote``, ``expel``, ``vshard``
+    **Applicable to:** ``promote``, ``demote``, ``expel``, ``vshard``, ``bootstrap``
 
     The timeout for completing the operation, in seconds. Default:
 
     -   ``3`` for ``promote``, ``demote``, ``expel``
-    -   ``10`` for ``vshard``
+    -   ``10`` for ``vshard`` and ``bootstrap``
+
+..  option:: -y, --yes
+
+    **Applicable to:** ``rebootstrap``
+
+    Automatically confirm rebootstrap.