在Google Cloud Run部署Keycloak失败：容器未在指定端口启动

问题描述 #

本地通过Docker Compose运行Keycloak+PostgreSQL服务正常，但部署到Google Cloud Run时失败，提示“用户提供的容器未能启动并监听PORT=8080环境变量定义的端口”。查看日志发现核心错误：

terminated: Application failed to start: failed to load /opt/keycloak/bin/kc.sh: exec format error

错误原因 #

本地开发环境为ARM64架构（如M系列Mac），Docker Compose中指定了platform: linux/arm64/v8，构建并推送的镜像为ARM64架构。而Google Cloud Run默认使用AMD64架构的虚拟机，架构不兼容导致无法执行容器内的脚本文件，进而引发启动失败。

解决方案 #

方案1：切换Cloud Run实例架构为ARM64 #

在Cloud Run控制台部署服务时，进入容器、虚拟机和构建设置，找到架构选项，选择ARM64，重新部署服务即可直接使用本地构建的ARM64镜像。

方案2：构建多架构兼容镜像 #

若需同时支持AMD64和ARM64架构，使用Docker Buildx构建跨架构镜像：

1. 启用并使用Buildx构建器：

   docker buildx create --use
   

2. 编写自定义Dockerfile（基于官方Keycloak镜像）：

   FROM quay.io/keycloak/keycloak:latest
   CMD ["start-dev"]
   

3. 构建并推送多架构镜像到Google Container Registry：

   docker buildx build --platform linux/amd64,linux/arm64/v8 -t gcr.io/key-api-prod/keycloak:multi-arch --push .
   

4. 在Cloud Run中使用该多架构镜像部署，无需指定架构，Cloud Run会自动匹配实例架构。

额外注意事项 #

• 若使用方案1，PostgreSQL服务也需对应部署为ARM64架构，或改用Google Cloud SQL托管的PostgreSQL服务（更适合云端生产环境）。
• 确保Cloud Run服务配置的环境变量与本地一致，尤其是数据库连接相关的KC_DB_*参数。

验证步骤 #

1. 部署完成后查看Cloud Run日志，确认无exec format error错误。
2. 访问Cloud Run服务提供的URL，验证Keycloak控制台可正常打开并登录。

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