Keycloak镜像包管理器查询及容器健康检查配置问题

一、搞定ping、curl安装：包管理工具消失的原因及修复 #

你碰到的yum/dnf/microdnf全找不到的情况，基本是用了UBI Micro版的Keycloak镜像——这是Red Hat的超精简容器镜像，默认砍掉了包管理工具。给你两个可行方案：

方案1：换用带包管理的基础镜像 #

官方Keycloak有基于UBI Minimal的镜像，自带microdnf工具。直接改Dockerfile的基础镜像：

FROM quay.io/keycloak/keycloak:latest-ubi-minimal  # 也可以指定具体版本，比如24.0.3-ubi-minimal

然后就能用microdnf装工具了，记得切root权限安装，之后再切回默认用户：

USER root
RUN microdnf install -y curl iputils && microdnf clean all  # clean all避免镜像变大
USER keycloak

方案2：直接从其他镜像复制二进制文件（不想换基础镜像时用） #

要是必须用当前的超精简镜像，就从UBI Minimal镜像里把curl、ping的二进制和依赖库拷过来：

FROM quay.io/keycloak/keycloak:latest AS keycloak-base

# 从UBI Minimal镜像里装好需要的工具
FROM registry.access.redhat.com/ubi9/ubi-minimal:latest AS tool-builder
RUN microdnf install -y curl iputils && microdnf clean all

# 把工具和依赖复制到Keycloak镜像里
FROM keycloak-base
COPY --from=tool-builder /usr/bin/curl /usr/bin/curl
COPY --from=tool-builder /usr/bin/ping /usr/bin/ping
# 用ldd /usr/bin/curl可以查看curl的依赖库，把缺失的都拷过来，比如：
COPY --from=tool-builder /usr/lib64/libcurl.so.4 /usr/lib64/libcurl.so.4
COPY --from=tool-builder /usr/lib64/libnghttp2.so.14 /usr/lib64/libnghttp2.so.14

二、解决book-service依赖的Keycloak健康检查问题 #

如果不想装curl，也有替代方式做健康检查：

方案1：用Keycloak自带的kcadm.sh #

Keycloak镜像里自带kcadm.sh工具，用它来验证服务可用性：

HEALTHCHECK --interval=30s --timeout=10s \
  CMD /opt/keycloak/bin/kcadm.sh config credentials --server http://localhost:8080 --realm master --user ${KEYCLOAK_ADMIN} --password ${KEYCLOAK_ADMIN_PASSWORD} || exit 1

这里用环境变量读取管理员账号密码，避免硬编码，更灵活。

方案2：检测端口是否监听 #

用nc（netcat）检查8080端口是否开放（如果镜像里没有nc，用上面的方法装就行）：

HEALTHCHECK --interval=30s --timeout=10s \
  CMD nc -z localhost 8080 || exit 1

方案3：用wget替代curl #

如果能装wget的话，也可以用它访问Keycloak的健康端点：

HEALTHCHECK --interval=30s --timeout=10s \
  CMD wget --spider http://localhost:8080/health/live || exit 1

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