kanisterio · kale-amruta · May 26, 2023 · May 30, 2023 · May 31, 2023 · May 31, 2023
diff --git a/docs/_static/repositoryserverworkflow.png b/docs/_static/repositoryserverworkflow.png
diff --git a/docs/architecture.rst b/docs/architecture.rst
diff --git a/docs/index.rst b/docs/index.rst
@@ -21,7 +21,7 @@ and easy to install, operate and scale.
 
    overview
    install
-   tutorial
+   kanister_tutorial
    architecture
    tasks
    tooling

diff --git a/docs/install.rst b/docs/install.rst
@@ -103,6 +103,22 @@ like below:
     --set bpValidatingWebhook.tls.caBundle=$(cat /path/to/ca.pem | base64 -w 0) \
     --set bpValidatingWebhook.tls.secretName=tls-secret
 
+.. _deploying_repo_server_controller:
+
+Deploying Kopia Repository Server Controller
+============================================
+
+To enable the Kopia Repository server controller, set the `repositoryServerController`
+value as shown below during the deployment
+
+.. substitution-code-block:: bash
+
+  helm upgrade --install kanister kanister/kanister-operator --namespace kanister --create-namespace \
+  --set repositoryServerController.enabled=true
+
+Executing this command will add an additional container to the Kanister pod for the
+Kopia repository server controller.
+
 
 Building and Deploying from Source
 ==================================

diff --git a/docs/kanister_tutorial.rst b/docs/kanister_tutorial.rst
@@ -0,0 +1,9 @@
+.. _tutorials:
+
+Tutorials
+*********
+.. toctree::
+   :maxdepth: 1
+
+   tutorials/tutorial.rst
+   tutorials/tutorial_with_repositoryserver.rst
diff --git a/docs/overview.rst b/docs/overview.rst
@@ -35,7 +35,7 @@ Getting Started
 
 Follow the instructions in the :ref:`install` section to get Kanister up and
 running on your Kubernetes cluster. Then see Kanister in action by going through
-the walkthrough under :ref:`tutorial`.
+the walkthrough under :ref:`tutorials`.
 
 The :ref:`architecture` section provides architectural insights into how things
 work. We recommend that you take a look at it.
diff --git a/docs/templates.rst b/docs/templates.rst
@@ -22,6 +22,7 @@ The TemplateParam struct is defined as:
     Secrets          map[string]v1.Secret
     Time             string
     Profile          *Profile
+    RepositoryServer *RepositoryServer
     Options          map[string]string
     Object           map[string]interface{}
     Phases           map[string]*Phase
@@ -489,7 +490,7 @@ Unlike Secrets and ConfigMaps, only a single profile can optionally be
 referenced by an ActionSet. As a result, there it is not necessary to
 name the Profiles in the Blueprint.
 
-The following examples should be helpful.
+The following examples should be helpful:
 
 .. code-block:: yaml
 
@@ -546,6 +547,54 @@ The currently supported Profile template is based on the following definitions
     Secret      ObjectReference
   }
 
+RepositoryServers
+-----------------
+
+RepositoryServers are Kanister CustomResource that store information about storage,
+repository, and server details. These details are required to run a Kopia repository
+server instance, which can then be further used for data operation artifacts.
+
+In contrast to Secrets and ConfigMaps, an ActionSet can optionally reference only a
+single repository server, eliminating the need to name the RepositoryServer in the
+Blueprint.
+
+The following examples should be helpful.
+
+.. code-block:: yaml
+
+  # Access the RepositoryServer name
+  "{{ .RepositoryServer.Name }}"
+
+  # Access the RepositoryServer service name
+  "{{ .RepositoryServer.ServerInfo.ServiceName }}"
+
+The currently supported RepositoryServer template is based on the following definitions:
+
+.. code-block:: go
+  :linenos:
+
+  // RepositoryServer contains fields from Repository server CR that will be used to resolve go templates for repository server in blueprint
+  type RepositoryServer struct {
+    Name            string
+    Namespace       string
+    ServerInfo      crv1alpha1.ServerInfo
+    Username        string
+    Credentials     RepositoryServerCredentials
+    Address         string
+    ContentCacheMB  int
+    MetadataCacheMB int
+  }
+
+  type RepositoryServerCredentials struct {
+    ServerTLS        v1.Secret
+    ServerUserAccess v1.Secret
+  }
+
+  type ServerInfo struct {
+    PodName     string `json:"podName,omitempty"`
+    ServiceName string `json:"serviceName,omitempty"`
+  }
+
 Options
 -------
 

diff --git a/docs/tutorial.rst → docs/tutorials/tutorial.rst b/docs/tutorial.rst → docs/tutorials/tutorial.rst
@@ -1,5 +1,3 @@
-.. _tutorial:
-
 Tutorial
 ********