Add storage parameters

Author: p7nov

doc/reference/tooling/tcm/tcm_configuration.rst

@@ -36,8 +36,8 @@ For example:
 
 .. _tcm_configuration_ways:
 
-Ways to pass |tcm| configuration parameters
--------------------------------------------
+Ways to pass configuration parameters
+-------------------------------------
 
 There are three ways to pass |tcm| configuration parameters:
 
@@ -47,8 +47,8 @@ There are three ways to pass |tcm| configuration parameters:
 
 .. _tcm_configuration_ways_yaml:
 
-YAML configuration file
-~~~~~~~~~~~~~~~~~~~~~~~
+YAML file
+~~~~~~~~~
 
 |tcm| configuration can be stored in a YAML file. Its structure must reflect the
 configuration parameters hierarchy.
@@ -144,9 +144,10 @@ You can combine different ways of |tcm| configuration for efficient management o
 multiple |tcm| installations:
 
 -   A single YAML file for all installations can contain the common configuration parts.
-    For example, the security parameters that fulfill your organization's requirements.
+    For example, the |tcm| configuration storage used for all installations or
+    TLS settings.
 -   Environment variables that set specific parameters for each server, such as
-    ?? any good example??
+    local directories and paths.
 -   Command-line options for parameters that must be unique for different |tcm| instances
     running on a single server. For example, ``http.port``.
 
@@ -158,64 +159,59 @@ types. Note that this is different from the :ref:`Tarantool configuration parame
 which have Lua types.
 
 Most options have the Go's basic types: `bool`, `string`, `int`, and other numeric types.
+Their values are passed as strings:
+
+.. code-block:: yaml
+
+    http:
+        basic-auth:
+            enabled: false # bool
+        network: tcp # string
+        host: 127.0.0.1 #string
+        port: 8080 # int
+        request-size: 1572864 # int64
 
 Parameters that can take multiple values are arrays. In YAML, they are passed as
 YAML arrays (each item on a new line, starting with a dash). In environment variables
 and command line options, the items of such arrays are passed in a semicolon-separated string.
 
-Parameters that set timeouts, TTLs, and other duration values, have the Go's `time.Duration <https://pkg.go.dev/time#Duration>`__
-type. This enables passing the values in the time-formatted strings such as ``4h30m25s``.
-
-The table below shows how to pass parameter values of different types:
-
-..  list-table::
-    :header-rows: 1
-    :stub-columns: 1
-
-    *   -   Type
-        -   YAML
-        -   Environment variable
-        -   Command-line option
-
-    *   -   ``bool``
-        -   http:
-                tls:
-                    enabled: true
-        -   TCM_HTTP_TLS_ENABLED="true"
-        -   --http_tls_enabled="true"
+.. code-block:: yaml
 
-    *   -   ``int``, ``uint``, ``uint64``
-        -   http:
-                port: 8080
+    storage:
+    provider: etcd
+    etcd:
+        endpoints: # array
+            - https://192.168.0.1:2379 # item 1
+            - https://192.168.0.2:2379 # item 2
 
-        -   TCM_HTTP_PORT=8080
-        -   --http-port=8080
+Parameters that set timeouts, TTLs, and other duration values, have the Go's `time.Duration <https://pkg.go.dev/time#Duration>`__
+type. Their values can be passed in time-formatted strings such as ``4h30m25s``.
 
-    *   -   ``string``
-        -   http:
-                host: 127.0.0.1
+.. code-block:: yaml
 
-        -   TCM_HTTP_HOST="127.0.0.1"
-        -   --http-host=127.0.0.1
+    cluster:
+        tarantool-timeout: 10s # duration
+        tarantool-ping-timeout: 5s # duration
 
-    *   -   ``array``
-        -   http:
-                cors:
-                    allowed-methods:
-                        - POST
-                        - GET
+Finally, there are parameters whose values are constants defined in Go packages.
+For example, :ref:`http.websession-cookie.same-site <tcm_configuration_reference_http_websession-cookie_same-site> `
+values are constants from the Go's `http.SameSite <https://pkg.go.dev/net/http#SameSite>`__
+type. To find out the exact values available for such parameters, refer to `Go
+packages documentation <https://pkg.go.dev/>`__.
 
-        -   TCM_HTTP_CORS_ALLOWED_METHODS="POST;GET"
-        -   --http-cors-allowed-methods=POST;GET
+.. code-block:: yaml
 
-    *   -   ``time.Duration``
-        -   http:
-                read-timeout: 1m5s
+    http:
+        tls:
+            cipher-suites:
+                - TLS_RSA_WITH_RC4_128_SHA # Go constant
 
-        -   TCM_HTTP_READ_TIMEOUT="1m5s"
-        -   --http-read-timeout=1m5s
+Creating configuration template
+-------------------------------
 
+You can create a YAML configuration template for |tcm| by running the ``tcm``
+executable with the ``generate-config`` option:
 
+.. code-block:: console
 
-? Configuration example or template for users?
-----------------------------------------------
+    tcm generate-config