Apache Pulsar 提供了丰富的命令行工具(CLI),用于管理和操作 Pulsar 集群、命名空间、租户、主题等资源。以下是一些常用的 Pulsar CLI 操作和指令,包括 命名空间、租户、主题管理、JWT Token 生成等。
1.租户(Tenant)操作
1.1 创建租户
pulsar-admin tenants create --admin-access --producer-access --consumer-access
:要创建的租户名称。 - --admin-access:租户管理员的角色。
- --producer-access:租户生产者的角色。
- --consumer-access:租户消费者的角色。
示例:
pulsar-admin tenants create my-tenant --admin-access admin-role --producer-access producer-role --consumer-access consumer-role
1.2 查看租户列表
pulsar-admin tenants list
1.3 删除租户
pulsar-admin tenants delete
:要删除的租户名称。
示例:
pulsar-admin tenants delete my-tenant
2.命名空间(Namespace)操作
命名空间用于将多个主题组织到一起,支持多租户管理。
2.1 创建命名空间
pulsar-admin namespaces create /
:租户名称。 :命名空间名称。
示例:
pulsar-admin namespaces create my-tenant/my-namespace
2.2 查看命名空间详情
pulsar-admin namespaces stats /
2.3 列出租户下的所有命名空间
pulsar-admin namespaces list
2.4 删除命名空间
pulsar-admin namespaces delete /
3.主题(Topic)操作
3.1 创建主题
pulsar-admin topics create
:要创建的主题名称。
示例:
pulsar-admin topics create persistent://my-tenant/my-namespace/my-topic
3.2 查看主题统计信息
pulsar-admin topics stats
3.3 删除主题
pulsar-admin topics delete
示例:
pulsar-admin topics delete persistent://my-tenant/my-namespace/my-topic
3.4 列出命名空间下的所有主题
pulsar-admin topics list /
4.消费者和生产者操作
4.1 查看订阅列表
pulsar-admin topics subscriptions
4.2 删除订阅
pulsar-admin topics unsubscribe --subscription
:主题名称。 :订阅名称。
示例:
pulsar-admin topics unsubscribe persistent://my-tenant/my-namespace/my-topic --subscription my-subscription
5.访问控制(ACL)操作
5.1 设置租户或命名空间的 ACL
pulsar-admin namespaces set-acc / --role --actions
- --role:角色名称(如 producer、consumer)。
- --actions:指定允许的操作(如 produce、consume)。
示例:
pulsar-admin namespaces set-acc my-tenant/my-namespace --role my-role --actions produce,consume
5.2 查看租户或命名空间的 ACL
pulsar-admin namespaces get-acc /
6.JWT Token 操作
6.1 生成 JWT Token
生成 JWT Token 主要用于与 Pulsar 集群交互时进行身份验证。通常,JWT Token 是通过 pulsar 管理命令生成。
示例:
pulsar token create --auth-params 'pulsar-admin' --role --secret-key
- --auth-params:身份验证的参数(如 Pulsar 管理员的凭据)。
- --role:生成的 token 关联的角色。
- --secret-key:生成 JWT 时的秘密密钥。
示例:
pulsar token create --auth-params 'pulsar-admin' --role producer-role --secret-key my-secret-key
6.2 查看现有的 JWT Token
pulsar token info
:JWT Token 的 ID。
6.3 删除 JWT Token
pulsar token revoke
7.Broker 操作
7.1 查看 Pulsar 集群状态
pulsar-admin clusters stats
7.2 查看集群配置
pulsar-admin clusters get
7.3 配置集群的访问控制列表(ACL)
pulsar-admin clusters set-acc --role --actions
8.集群配置和健康检查
8.1 查看集群健康状况
pulsar-admin clusters health
8.2 查看集群的配置
pulsar-admin clusters get-config
总结
以上是一些常用的 Pulsar CLI 操作,包括租户、命名空间、主题、订阅、ACL、JWT Token 的生成与管理等。通过这些命令,你可以方便地管理 Pulsar 集群中的资源。如果你还需要其他操作或命令,可以通过运行 pulsar-admin help 查看详细的帮助信息。
这些 CLI 命令使得在命令行中管理 Pulsar 集群变得非常方便和高效,适用于各种集群管理、监控、调试和操作场景。