Merge branch 'update-clickhouse-setup-docs' into 'master'

Add verbose docs to dev ClickHouse setup

See merge request https://gitlab.com/gitlab-org/gitlab/-/merge_requests/146218



Merged-by: Gabriel Mazetto <gabriel@gitlab.com>
Approved-by: Gabriel Mazetto <gabriel@gitlab.com>
Reviewed-by: Gabriel Mazetto <gabriel@gitlab.com>
Reviewed-by: Pavel Shutsin <pshutsin@gitlab.com>
Co-authored-by: Pavel Shutsin <pshutsin@gitlab.com>

config/click_house.yml.example

+development:
+  main:
+    database: gitlab_clickhouse_development
+    url: 'http://localhost:8123'
+    username: default
+    password:
 test:
   main:
     database: gitlab_clickhouse_test

doc/development/database/clickhouse/clickhouse_within_gitlab.md

@@ -13,7 +13,25 @@ Most of the tooling and APIs are considered unstable.
 
 ## GDK setup
 
-For instructions on how to set up a ClickHouse server locally, see the [ClickHouse installation documentation](https://clickhouse.com/docs/en/install).
+### Setup ClickHouse server
+
+1. Install ClickHouse locally as described in [ClickHouse installation documentation](https://clickhouse.com/docs/en/install). If you use QuickInstall it will be installed in current directory, if you use homebrew it will be installed to `/opt/homebrew/bin/clickhouse`
+1. Enable experimental services with `gdk config set gdk.experimental.ruby_services true`
+1. Add clickhouse section to your `gdk.yml`. See [`gdk.example.yml`](https://gitlab.com/gitlab-org/gitlab-development-kit/-/blob/main/gdk.example.yml)
+1. Adjust `gdk.yml` clickhouse config to point to your local clickhouse installation and local data storage. E.g.
+
+   ```yaml
+   clickhouse:
+     bin: "/opt/homebrew/bin/clickhouse"
+     enabled: true
+     # these are optional if we have more then one GDK:
+     # http_port: 8123
+     # interserver_http_port: 9009
+     # tcp_port: 9001
+   ```
+
+1. Run `gdk reconfigure`
+1. Start clickhouse with `gdk start clickhouse`
 
 ### Configure your Rails application
 
@@ -27,7 +45,7 @@ For instructions on how to set up a ClickHouse server locally, see the [ClickHou
 1. Create the database using the `clickhouse-client` CLI tool:
 
    ```shell
-   clickhouse-client --password
+   clickhouse client --port 9001
    ```
 
    ```sql