APISIX doc update (#1130)

* APISIX doc update

Signed-off-by: Andy Tael <[email protected]>

* APISIX update and Docusaurus new version

Signed-off-by: Andy Tael <[email protected]>

---------

Signed-off-by: Andy Tael <[email protected]>

Author: andytael

docs-source/site/docs/platform/apisix.md

@@ -24,12 +24,36 @@ kubectl port-forward -n obaas-dev svc/apisix-admin 9180
 
 To access the APISIX APIs, you need the admin key. Retrieve it with the following command (replace the example namespace `obaas-dev` with the namespace where APISIX is deployed):
 
-```shell
-export admin_key=$(kubectl -n obaas-dev get configmap apisix -o yaml | yq '.data."config.yaml"' | yq '.deployment.admin.admin_key[] | select(.name == "admin") | .key')
+**Option 1 - Using yq:**
+
+```bash
+kubectl -n obaas-dev get configmap apisix -o yaml | yq '.data."config.yaml"' | yq '.deployment.admin.admin_key[] | select(.name == "admin") | .key'
 ```
 
+**Option 2 - Manual retrieval:**
+
+If the command above doesn't work:
+
+1. Run: `kubectl get configmap apisix -n obaas-dev -o yaml`
+1. Look for the `config.yaml` section
+1. Find `deployment.admin.admin_key` and copy the key value
+
 Test the admin key by running a simple curl command; it should return the list of configured routes.
 
 ```shell
 curl http://127.0.0.1:9180/apisix/admin/routes -H "X-API-key: $admin_key" -X GET
 ```
+
+### Accessing APISIX Dashboard
+
+:::note
+ Note that all functionality is not available in the dashboard. You might need to use the REST APIs
+:::
+
+APISIX has an embedded dashboard that can be accessed after a tunnel is established to the `apisix-admin` service. The dashboard is available on this [URL](http://localhost:8190/ui). **NOTE:** you need the Admin key to be able to access the dashboard.
+
+![APISIX Dashboard](images/apisix-dashboard.png)
+
+### Configuring APISIX using REST APIs
+
+You can configure and update the APISIX gateway using the provided APIs. [API Documentation](https://apisix.apache.org/docs/apisix/getting-started/README/)