pilichoumao opened a new pull request, #112:
URL: https://github.com/apache/rocketmq-apis/pull/112
## Summary
This draft PR proposes the public protobuf contract for RocketMQ RIP-2 Proxy
Admin M1 online client query.
It adds a standalone `ProxyAdminService` to `apache/rocketmq/v2/admin.proto`
with four RPCs:
- `ListClients`
- `DescribeClient`
- `ListClientsByGroup`
- `ListClientsByTopic`
The API is intentionally separate from `MessagingService` so admin query
traffic can stay isolated from the data plane. M1 request fields cover client
id, client id prefix, group, topic, client language, connect time range, page
number, page size, local proxy scope, and reserved future multi-proxy selectors.
## Notes
- `PROXY_SCOPE_LOCAL_PROXY` is the intended public M1 scope.
- `PROXY_SCOPE_ALL_PROXIES` and `PROXY_SCOPE_PROXY_ID` are included for
design discussion but should remain gated until peer discovery, timeout,
authorization, and pagination ownership semantics are accepted.
- The matching RocketMQ implementation branch is
`pilichoumao/rocketmq:rip2-proxy-admin-m1`.
## Verification
- `rg` confirmed `ProxyAdminService`, all four RPCs, `ProxyScope`, and
`ProxyClient` are present in `apache/rocketmq/v2/admin.proto`.
- Local generated artifact installed as
`org.apache.rocketmq:rocketmq-proto:2.2.0-rip2-SNAPSHOT` contains:
- `apache/rocketmq/v2/ProxyAdminServiceGrpc.class`
- `apache/rocketmq/v2/ListClientsRequest.class`
- `apache/rocketmq/v2/ProxyClient.class`
- The downstream RocketMQ proxy branch compiles and passes its generated
public endpoint tests against this generated artifact.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
