This is an automated email from the ASF dual-hosted git repository.
tison pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/pulsar-site.git
The following commit(s) were added to refs/heads/main by this push:
new e59427be6a6 [fix][doc] fix the Helm Getting Started Guide to make
pulsar-manager work (#679)
e59427be6a6 is described below
commit e59427be6a6f457774feed5b23a697e96e8f2c65
Author: Julien Jakubowski <[email protected]>
AuthorDate: Sun Aug 27 13:12:22 2023 +0200
[fix][doc] fix the Helm Getting Started Guide to make pulsar-manager work
(#679)
Co-authored-by: tison <[email protected]>
---
docs/getting-started-helm.md | 36 ++++++++++++++++++++++++++++++++----
1 file changed, 32 insertions(+), 4 deletions(-)
diff --git a/docs/getting-started-helm.md b/docs/getting-started-helm.md
index 6ea26dcf776..3f9dafaeb33 100644
--- a/docs/getting-started-helm.md
+++ b/docs/getting-started-helm.md
@@ -94,6 +94,20 @@ We use [Minikube](https://minikube.sigs.k8s.io/docs/start/)
in this quick start
pulsar-mini apache/pulsar
```
+:::tip
+
+Make sure the `values-minikube.yaml` file contains the following lines:
+
+```yaml
+pulsar_manager:
+ configData:
+ ENV_SPRING_CONFIGURATION_FILE:
"/pulsar-manager/pulsar-manager/application.properties"
+ SPRING_CONFIGURATION_FILE:
"/pulsar-manager/pulsar-manager/application.properties"
+ PULSAR_MANAGER_OPTS: " -Dlog4j2.formatMsgNoLookups=true"
+```
+
+:::
+
5. Check the status of all pods.
```bash
@@ -340,22 +354,36 @@ Then you can proceed with the following steps:
[Pulsar Manager](administration-pulsar-manager.md) is a web-based GUI
management tool for managing and monitoring Pulsar.
-1. By default, the `Pulsar Manager` is exposed as a separate `LoadBalancer`.
You can open the Pulsar Manager UI using the following command:
+1. To create a superuser account, connect to the pulsar-manager pod and create
the account:
+
+```bash
+kubectl exec -it YOUR_PULSAR_MANAGER_POD_NAME -n pulsar -- /bin/bash
+CSRF_TOKEN=$(curl http://localhost:7750/pulsar-manager/csrf-token)
+curl \
+ -H "X-XSRF-TOKEN: $CSRF_TOKEN" \
+ -H "Cookie: XSRF-TOKEN=$CSRF_TOKEN;" \
+ -H 'Content-Type: application/json' \
+ -X PUT http://localhost:7750/pulsar-manager/users/superuser \
+ -d '{"name": "pulsar", "password": "pulsar", "description": "test",
"email": "[email protected]"}'
+```
+
+2. By default, the `Pulsar Manager` is exposed as a separate `LoadBalancer`.
You can open the Pulsar Manager UI using the following command:
```bash
minikube service -n pulsar pulsar-mini-pulsar-manager
```
-2. The Pulsar Manager UI will be open in your browser. You can use the
username `pulsar` and password `pulsar` to log into Pulsar Manager.
+3. The Pulsar Manager UI will be open in your browser. You can use the
username `pulsar` and password `pulsar` to log into Pulsar Manager.
-3. In Pulsar Manager UI, you can create an environment.
+4. In Pulsar Manager UI, you can create an environment.
- Click **New Environment** in the upper-left corner.
- Type `pulsar-mini` for the field `Environment Name` in the pop-up window.
- Type `http://pulsar-mini-broker:8080` for the field `Service URL` in the
pop-up window.
+ - Type `http://pulsar-mini-bookie:8080` for the field `Bookie URL` in the
pop-up window.
- Click **Confirm** in the pop-up window.
-4. After successfully creating an environment, you are redirected to the
`tenants` page of that environment. Then you can create `tenants`,
`namespaces`, and `topics` using the Pulsar Manager.
+5. After successfully creating an environment, you can create `tenants`,
`namespaces`, and `topics` using the Pulsar Manager.
## Step 5: Use Prometheus and Grafana to monitor cluster
