[Bug] plain_acl.yml is missing from the official binary release distribution

[SummCoder]

Before Creating the Bug Report

• I found a bug, not just asking a question, which should be created in GitHub Discussions.

• I have searched the GitHub Issues and GitHub Discussions of this repository and believe that this is not a duplicate.

• I have confirmed that this bug belongs to the current repository, not other repositories of RocketMQ.

Runtime platform environment

Ubuntu 24.04.4 LTS

RocketMQ version

develop|5.5.0

JDK Version

openjdk version "11.0.31" 2026-04-21

Describe the Bug

Describe the bug

When enabling ACL on RocketMQ 5.5.0 for the first time, I followed the
official docs (docs/en/acl/Operations_ACL.md). The doc references
"distribution/conf/plain_acl.yml" in multiple places as the configuration
template, but this file does not exist in the official binary release.
Users have to guess the ACL config format from scratch.

Investigation

Verified from two independent sources, same result:

1. Official binary release: downloaded rocketmq-all-5.5.0-bin-release.zip
   from https://dist.apache.org/repos/dist/release/rocketmq/5.5.0/
   → conf/ directory does NOT contain plain_acl.yml

2. Self-compiled from source: built the develop branch (5.5.0) using
   "mvn -Prelease-all -DskipTests clean install -U", extracted the
   resulting distribution/target/rocketmq-5.5.0.tar.gz
   → conf/ directory does NOT contain plain_acl.yml

3. Source tree check: distribution/conf/ under the source root also
   has no plain_acl.yml. The only copies exist under test resources:

   • client/src/test/resources/acl_hook/plain_acl.yml
   • client/src/test/resources/conf/plain_acl_incomplete.yml

4. Duplicate search: searched both open and closed issues on
   apache/rocketmq for "plain_acl.yml" — no existing report found
   about the missing template in distribution.

Steps to Reproduce

1. Download the official 5.5.0 binary release from
   https://dist.apache.org/repos/dist/release/rocketmq/5.5.0/rocketmq-all-5.5.0-bin-release.zip
2. Extract the zip file
3. Open the conf/ directory
4. Look for plain_acl.yml — it is not there

What Did You Expect to See?

Expected behavior

A sample plain_acl.yml should be included in the distribution's conf/
directory so users have a working template to customize when enabling
ACL, consistent with what the documentation tells them to do.

What Did You See Instead?

The conf/ directory contains no plain_acl.yml. The only configuration files present are broker.conf and tools.yml. Users enabling ACL have no template to work from, despite the official documentation telling them to reference this file.

Additional Context

No response

[SummCoder]

Additionally, tools.yml ships with a hardcoded default:
accessKey: rocketmq2

When ACL is enabled, mqadmin commands fail with "User:rocketmq2
is not found" because no corresponding ACL account exists. Including
a matching rocketmq2 account in the sample plain_acl.yml would
prevent this.