Added dedicated page for Ibexa Cloud CLI (#3198)

* Added dedicated page for Ibexa Cloud CLI

* Selfreview

* Wording

* Review feedback

* Selfreview

* Apply suggestions from code review

Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com>

* Fixed redirect

---------

Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com>

Author: mnocon

docs/ibexa_cloud/ddev_and_ibexa_cloud.md

@@ -13,6 +13,7 @@ Two ways are available to run an [[= product_name_cloud =]] project locally with
 !!! note
 
     The following examples use [[[= product_name_cloud =]] CLI (`ibexa_cloud`)](https://cli.ibexa.co/).
+    For more information and examples, see [[[= product_name_cloud =]] CLI](ibexa_cloud_cli.md).
 
 ## With Ibexa Cloud add-ons
 

docs/ibexa_cloud/ibexa_cloud.md

@@ -11,6 +11,7 @@ month_change: false
 [[= cards([
     "ibexa_cloud/ibexa_cloud_guide",
     "ibexa_cloud/install_on_ibexa_cloud",
+    "ibexa_cloud/ibexa_cloud_cli",
     "ibexa_cloud/environment_variables",
     "ibexa_cloud/ddev_and_ibexa_cloud",
 ], columns=3) =]]

docs/ibexa_cloud/ibexa_cloud_cli.md

@@ -0,0 +1,78 @@
+---
+description: Use the [[= product_name_cloud =]] CLI to manage your I[[= product_name_cloud =]] projects from the command line.
+month_change: true
+---
+
+# [[= product_name_cloud =]] CLI
+
+The [[= product_name_cloud =]] CLI (`ibexa_cloud`) is a command-line tool for managing your [[= product_name_cloud =]] projects.
+It's based on the [Upsun CLI](https://developer.upsun.com/cli) and shares the same commands.
+
+## Installation
+
+Follow the installation instructions at [cli.ibexa.cloud](https://cli.ibexa.cloud/).
+
+After installation, authenticate with your [[= product_name_cloud =]] account:
+
+```bash
+ibexa_cloud auth:browser-login
+```
+
+## Command reference
+
+To get started, try the following commands:
+
+- `ibexa_cloud list` lists all available commands
+- `ibexa_cloud ssh` opens an SSH session to the current environment, or executes a command remotely
+- `ibexa_cloud log` reads an environment's logs
+- `ibexa_cloud rel` shows an environment's service relationships
+- `ibexa_cloud var` lists environment variables
+
+To get help and see usage examples for any command, run:
+
+```bash
+ibexa_cloud <command> --help
+```
+
+For the full list of available commands, run `ibexa_cloud list` or see the [Upsun CLI reference](https://developer.upsun.com/cli/reference).
+In all examples, replace `upsun` with `ibexa_cloud`.
+
+## Examples
+
+### Run a SQL script
+
+To execute a SQL upgrade script on a [[= product_name_cloud =]] environment, pass it to `ibexa_cloud sql`:
+
+=== "MySQL"
+
+    ```bash
+    ibexa_cloud sql < vendor/ibexa/installer/upgrade/db/mysql/ibexa-x.x.x-to-x.x.y.sql
+    ```
+
+=== "PostgreSQL"
+
+    ```bash
+    ibexa_cloud sql < vendor/ibexa/installer/upgrade/db/postgresql/ibexa-x.x.x-to-x.x.y.sql
+    ```
+
+### Connect with a SQL client
+
+To connect to the database using any SQL client, start SSH tunnels to all services (database, Redis, Solr, and others except Varnish) by running the following command in the project directory:
+
+```bash
+ibexa_cloud tunnel:open
+```
+
+The command outputs connection details for each service, for example:
+
+``` shell-session
+SSH tunnel opened to database at: mysql://user:<PASSWORD>@127.0.0.1:30000/main
+```
+
+Use the displayed host, port, database name, username, and password to configure your SQL client.
+
+When you're done, close the tunnels:
+
+```bash
+ibexa_cloud tunnel:close
+```

docs/ibexa_cloud/install_on_ibexa_cloud.md

@@ -1,5 +1,5 @@
 ---
-description: Install and configure Ibexa DXP to run in cloud using Ibexa Cloud.
+description: Install and configure Ibexa DXP to run in cloud using [[= product_name_cloud =]].
 month_change: false
 ---
 
@@ -82,6 +82,8 @@ In **Settings** (top right gear icon) -> **Project Settings** -> **Variables** -
 
 ### Composer authentication using the CLI command
 
+Use [[[= product_name_cloud =]] CLI](ibexa_cloud_cli.md) to create the variable:
+
 ```bash
 ibexa_cloud variable:create --level project --name env:COMPOSER_AUTH \
   --json true --visible-runtime false --sensitive true --visible-build true \
@@ -111,11 +113,6 @@ Modify this password after the installation, for example, by using [data migrati
 
 !!! caution
 
-    Don't use Upsun CLI (`upsun`), instead, use the [[[= product_name_cloud =]] CLI (`ibexa_cloud`)](https://cli.ibexa.cloud/).
-
-    To install [[= product_name_cloud =]] CLI, follow https://cli.ibexa.cloud/ "Installation instructions".
-
-    [[= product_name_cloud =]] CLI and Upsun CLI share the same commands and the [same documentation](https://fixed.docs.upsun.com/administration/cli.html#3-use), but you have to replace `upsun` with `ibexa_cloud`.
+    Don't use Upsun CLI (`upsun`), instead, use the [[[= product_name_cloud =]] CLI (`ibexa_cloud`)](https://cli.ibexa.cloud/) instead.
 
-    If you have previously set up an alias to use Upsun CLI with [[= product_name_cloud =]], it's outdated.
-    Remove the alias and install [[= product_name_cloud =]] CLI instead.
+    For more information, see [[[= product_name_cloud =]] CLI](ibexa_cloud_cli.md).

mkdocs.yml

@@ -863,6 +863,7 @@ nav:
         - Ibexa Cloud: ibexa_cloud/ibexa_cloud.md
         - Ibexa Cloud guide: ibexa_cloud/ibexa_cloud_guide.md
         - Install on Ibexa Cloud: ibexa_cloud/install_on_ibexa_cloud.md
+        - Ibexa Cloud CLI: ibexa_cloud/ibexa_cloud_cli.md
         - Environment variables: ibexa_cloud/environment_variables.md
         - DDEV and Ibexa Cloud: ibexa_cloud/ddev_and_ibexa_cloud.md
     - Infrastructure and maintenance: