将Keycloak Docker镜像部署到Azure App Service无法创建管理员用户

解决方案 #

Azure App Service部署容器完全支持等效于docker run -e参数的环境变量配置，操作步骤如下：

1. 打开你部署的Keycloak对应的App Service资源详情页
2. 在左侧导航栏的「设置」分类下找到环境变量（部分旧版Azure门户该选项名为「配置」），点击进入
3. 切换到「应用程序设置」标签页，点击「添加」按钮，新增两组键值对：
   • 键：KEYCLOAK_ADMIN，值：自定义管理员用户名
   • 键：KEYCLOAK_ADMIN_PASSWORD，值：自定义管理员密码（需满足8位以上、包含大小写/数字/特殊字符的复杂度要求，否则Keycloak启动会失败）

   如果你使用的是Quarkus架构之前的旧版JBoss版Keycloak镜像，对应变量名为KEYCLOAK_USER和KEYCLOAK_PASSWORD

4. 点击页面顶部的「保存」按钮，等待1-2分钟待Azure自动重启容器加载配置后，即可使用设置好的管理员账号直接登录Keycloak管理后台，无需进入容器执行用户创建脚本。

关于SSH连接失败的说明 #

你遇到的SSH无法连接属于正常情况，官方Keycloak基础镜像默认没有预装Azure App Service要求的SSH服务端组件，因此无法通过门户内置SSH控制台连接，无需额外排查该问题，通过上述环境变量配置即可满足初始化需求。

内容的提问来源于stack exchange，提问作者user11066039