apache
[Bug] Starting Docker Compose and running Pulsar 4.0.5 will result in an error
Search before reporting
- [x] I searched in the issues and found nothing similar.
Read release policy
- [x] I understand that unsupported versions don't get bug fixes. I will attempt to reproduce the issue on a supported version of Pulsar client and Pulsar broker.
User environment
version：4.0.5
document:：https://pulsar.apache.org/docs/4.0.x/getting-started-docker-compose
Issue Description
An error occurred while executing Docker Compose. I hope Pulsar can run normally
Error messages
2025-05-26 09:56:27 picocli.CommandLine$MissingParameterException: Missing required options: '--cluster=<cluster>', '--web-service-url=<clusterWebServiceUrl>'
2025-05-26 09:56:27 Exception in thread "main" picocli.CommandLine$MissingParameterException: Missing required options: '--cluster=<cluster>', '--web-service-url=<clusterWebServiceUrl>'
2025-05-26 09:56:27 at picocli.CommandLine$MissingParameterException.create(CommandLine.java:18661)
2025-05-26 09:56:27 at picocli.CommandLine$MissingParameterException.access$21200(CommandLine.java:18649)
2025-05-26 09:56:27 at picocli.CommandLine$Interpreter.validateConstraints(CommandLine.java:13651)
2025-05-26 09:56:27 at picocli.CommandLine$Interpreter.parse(CommandLine.java:13614)
2025-05-26 09:56:27 at picocli.CommandLine$Interpreter.parse(CommandLine.java:13559)
2025-05-26 09:56:27 at picocli.CommandLine$Interpreter.parse(CommandLine.java:13454)
2025-05-26 09:56:27 at picocli.CommandLine.parseArgs(CommandLine.java:1552)
2025-05-26 09:56:27 at org.apache.pulsar.PulsarClusterMetadataSetup.main(PulsarClusterMetadataSetup.java:227)
2025-05-26 09:56:28 bash: line 2: --cluster: command not found
2025-05-26 09:56:28 bash: line 3: --zookeeper: command not found
2025-05-26 09:56:28 bash: line 4: --configuration-store: command not found
2025-05-26 09:56:28 bash: line 5: --web-service-url: command not found
2025-05-26 09:56:28 bash: line 6: --broker-service-url: command not found
Reproducing the issue
Executing the command 'docker compose up - d' resulted in an error
Additional information
No response
Are you willing to submit a PR?
- [x] I'm willing to submit a PR!
You may try this, it works for me.
bash -c "bin/pulsar initialize-cluster-metadata --cluster cluster-a --zookeeper zookeeper:2181 --configuration-store zookeeper:2181 --web-service-url http://broker:8080 --broker-service-url pulsar://broker:6650"
there's #24040 and https://github.com/apache/pulsar-site/commit/0df29a62 which were intended to address this, will check again.
Update: yes, I can reproduce this issue with the version in docs.
Fixed the issue in https://github.com/apache/pulsar-site/commit/a751dea2, will get updated to the site in about 10 minutes