New command for provisioning DB namespaces

docs/administer/manage_namespaces.md

@@ -0,0 +1,89 @@
+# Namespaces management
+
+The management of namespaces plays a vital role in efficiently organizing and allocating resources within Percona Everest.
+
+## Add new namespaces
+
+You can run the following command for provisioning a new DB namespace:
+
+```sh
+everestctl namespaces add [NAMESPACE]
+```
+
+The command supports the following flags:
+
+`--operator.mongodb=<bool>`
+
+`--operator.postgresql=<bool>`
+
+`--operator.xtradb-cluster=<bool>`
+
+`--take-ownership` - If the namespace exists, it will be part of Percona Everest. If it is set to false, Percona Everest will throw an error.
+
+??? example "Example"    
+    ```sh
+    everestctl namespaces add production --kubeconfig /Users/rasikachivate/Downloads/Kubeconfig 
+
+    ? Which operators do you want to install? MongoDB    
+    ✓ Installing namespace 'production'
+    ```
+
+    ```sh
+    everestctl namespaces add development --operator.postgresql=false --kubeconfig /Users/rasikachivate/Downloads/Kubeconfig
+    ✓ Installing namespace 'development'
+    ```
+    In the command above, we did not specify the MongoDB and MySQL  operators. Therefore, by default, Percona Everest assumes these operators are true and will add them.
+
+## Update namespaces
+
+You can run the following command to add more operators to the DB namespace.
+
+
+```sh
+everestctl namespaces update [NAMESPACE] 
+```
+
+!!! note
+    The `everestctl install` command can provision a DB namespace. However, if you run this command again, an error will be thrown: `Everest is already installed.`
+
+
+- To provision a DB namespace after installation, use the command `everestctl namespaces add`. 
+
+- You may choose to skip the DB namespace installation in the `everestctl install` command.
+
+??? example "Example"    
+    ```sh
+    everestctl namespaces update development --kubeconfig /Users/rasikachivate/Downloads/Kubeconfig
+
+    ? Which operators do you want to install? MongoDB
+    ✓ Updating namespace 'development'
+    ```
+
+
+## Delete namespaces
+
+You can run the following command for deleting namespaces:
+
+```sh
+everestctl namespaces delete [NAMESPACE]
+```
+
+- This command deletes only the specified namespace, as long as it is managed by Percona Everest.
+
+- Setting the `--keep-namespace` option will delete all operators in the namespace but will not remove the namespace itself. It will only remove the Percona Everest label.
+
+
+??? example "Example"
+    ```sh
+    everestctl namespaces remove development  --kubeconfig /Users/rasikachivate/Downloads/Kubeconfig
+
+    ✓ Deleting database clusters in namespace 'development'
+    ✓ Deleting backup storages in namespace 'development'
+    ✓ Deleting monitoring instances in namespace 'development'
+    ✓ Deleting namespace 'development'
+    ```
+
+
+
+
+

docs/administer/rbac.md

@@ -1,4 +1,4 @@
-# Role Based Access Control
+# Role-based access control (RBAC)
 
 !!! warning "Disclaimer"
     RBAC is currently in **Technical Preview**. Early adopters are advised to use this feature only for testing purposes and not in production environments.

docs/use/multi-namespaces.md

@@ -3,7 +3,7 @@
 In Kubernetes, the concept of namespaces enables you to create isolated groups of resources within a single cluster. These namespaces provide a way to organize and manage resources without interfering with other resources within the same cluster.
 
 
-!!! warning "Important"
+!!! info "Important"
     Resource names must be unique within a specific namespace but not across different namespaces.
 
 
@@ -15,7 +15,7 @@ For example, you can deploy different environments like production, development,
 
 ## Default namespaces in Percona Everest
 
-!!! warning "Important"
+!!! info "Important"
     The following namespaces are restricted and cannot be used for deploying databases.
 
 Percona Everest will create the following namespaces by default. You can see these default namespaces while Percona Everest is being installed.
@@ -30,41 +30,35 @@ To set up the namespaces that Percona Everest will manage and where you can depl
 
 The following holds true for multiple namespaces:
 
-- You can configure multiple namespaces in Percona Everest. 
+- You can [configure multiple namespaces](../administer/manage_namespaces.md#add-new-namespaces) in Percona Everest using the `everestctl namespaces add [NAMESPACE]` command.
 
-- You can install different operators in various namespaces by running the install command multiple times.
+- You can [install different operators](../administer/manage_namespaces.md#update-namespaces) in various namespaces using the `everestctl namespaces update [NAMESPACE]` command.
 
-    See the following example for more details:
-
-    ??? info "Example: Installing various operators in different namespaces"
-
-        To install various operators in different namespaces, such as MySQL and MongoDB operator in namespaces dev and testing, and PostgreSQL operator in namespaces production and staging, run the following commands:
-            {.power-number}
 
-        1. `everestctl install`
+??? example "Example: Configuring multiple namesapces and installing various operators within those namespaces"            
+    To install various operators in different namespaces, such as MongoDB and MySQL operator in namespace production, and PostgreSQL operator in namespace development, run the following commands:
+    {.power-number}
 
+    1. `everestctl namespaces add development`
 
-            ??? example "Expected output"
+        ??? example "Expected output"
+            ```sh
+            ? Which operators do you want to install? PostgreSQL
+            ✓ Installing namespace 'development'
+            ```
 
-                ```sh
-                ? Namespaces managed by Everest [comma separated] dev,testing
-                ? What operators do you want to install? MySQL, MongoDB
-                ```
+    2. `everestctl namespaces add production`.
 
-        2. Rerun the `everestctl install` command to install the PostgreSQL operator in the production and staging namespaces.
+        ??? example "Expected output"
+            ```sh
+            ? Which operators do you want to install? MySQL, MongoDB
+            ✓ Installing namespace 'production'
+            ```
 
 
-            ??? example "Expected output"
+Go to Percona Everest UI and navigate to <i class="uil uil-cog"></i> **Settings > Namespaces**. A list of all the namespaces that you have created will appear here.
 
-                ```sh
-                ? Namespaces managed by Everest [comma separated] production,staging
-                ? What operators do you want to install? PostgreSQL
-                ```
-
-
-    Go to Percona Everest UI and navigate to <i class="uil uil-cog"></i> **Settings > Namespaces**. A list of all the namespaces that you have created will appear here.
-
-    ![!image](../images/everest_multinamespaces.png)
+![!image](../images/everest_multinamespaces.png)
 
 ## Deploy the database in your namespace
 

mkdocs-base.yml

@@ -181,8 +181,9 @@ nav:
   - Administer:
       - User management: administer/manage_users.md
       - Single sign-on (SSO): administer/Idp_integration.md
-      - Access Control: 
-        - RBAC: administer/rbac.md
+      - Role-based access control: administer/rbac.md
+      - Namespaces management: administer/manage_namespaces.md
+
   - Use:
       - Database view: use/database_view.md
       - Provision a database: use/db_provision.md