在应用迁移上云或实例备份等场景下,如果需要一次性创建多个 SASL 用户,可以通过控制台上传配置文件的方式批量创建 SASL 用户。本文档介绍批量导入 SASL 用户的操作步骤。
背景信息
在应用迁移上云或实例备份等场景下,需要在新实例中快速创建一批 SASL 用户,其配置和源端 Kafka 实例相同,例如相同的用户名、密码类型等配置。消息队列 Kafka版支持通过控制台上传配置文件的方式批量创建 SASL 用户。您可以根据指定格式的模板文件准备好 SASL 用户的配置文件,并将其上传到消息队列 Kafka版控制台中,系统后端服务会自动为您创建指定配置的 SASL 用户。
注意事项
- 仅支持上传 csv 格式的配置文件。且文件长度最大为 10MB。
- 每次最多批量导入 200 条 SASL 用户配置,即每次最多批量创建 200 个 SASL 用户。
- 对于2023年8月23日之前创建的实例,不支持导入 PLAIN 用户。
前提条件
在控制台批量导入 SASL 用户之前,需要根据控制台提供的配置模板准备配置文件,配置文件中应包含用户名等配置信息。
您可以在用户管理页面单击上传,并根据页面提示下载配置模板,在配置模板中填写待导入的 SASL 用户信息即可。
说明
- 配置文件中,每一列配置均为必选,否则上传时模板解析失败。但 All Permitted 可设置为空,表示 All Permitted 设置为 false,即此用户不具备所有 Topic 的读写权限;描述也可以设置为空,表示没有描述信息。
- 参数配置应符合填写要求,详细的规则说明请参考模板标题行。
操作步骤
- 登录消息队列 Kafka版控制台。
- 在顶部菜单栏中选择地域,并在左侧导航栏中单击实例列表。
- 找到目标实例,单击实例名称。
- 在页签栏中单击用户管理。
- 单击上传。
- 根据页面提示上传配置文件。
- 如果页面提示文件配置校验通过,说明配置文件可被正确解析。继续执行后续操作。
- 如果页面提示文件数据校验失败,请根据提示修改,说明配置文件填写有误,请根据页面提示修改部分参数配置,并再次上传配置文件。
- 单击创建导入任务。
后端服务会根据上传的配置文件批量创建 SASL 用户,并同时创建一个后台任务以供查看任务执行的相关信息。
- 如果用户列表中出现新的 SASL 用户,表示 SASL 用户创建成功,可以开始使用。
- 如果后台任务管理页签中,此后台任务长期处于运行中状态或出现其他异常情况,可以在任务详情一列中查看任务执行的详细信息。