RHEL9下Quarkus与podman-compose协同工作问题排查

一、让Testcontainers正确识别并使用Podman #

Quarkus dev模式依赖Testcontainers启动容器，需配置它优先使用Podman而非Docker：

• 安装Podman插件包（补充容器交互支持）：

  sudo dnf install podman-plugins
  

• 配置环境变量，告知Testcontainers Podman的连接信息：
  编辑你的shell配置文件（如~/.bashrc或~/.zshrc），添加以下内容：

  export TESTCONTAINERS_RYUK_DISABLED=true
  export DOCKER_HOST=unix:///run/user/$UID/podman/podman.sock
  export TESTCONTAINERS_DOCKER_SOCKET_OVERRIDE=/run/user/$UID/podman/podman.sock
  

  执行source ~/.bashrc使配置生效。
• 启动并启用Podman用户级socket服务：

  systemctl --user enable --now podman.socket
  

二、让docker compose命令关联podman-compose #

• 用软链接直接映射命令：

  sudo ln -s /usr/bin/podman-compose /usr/local/bin/docker-compose
  

  或者用系统alternatives工具规范配置：

  sudo alternatives --install /usr/bin/docker-compose docker-compose /usr/bin/podman-compose 10
  

三、解决Postgres镜像拉取超时问题 #

• 配置Podman镜像加速源：
  编辑~/.config/containers/registries.conf，添加国内镜像节点：

  [[registry]]
  prefix = "docker.io"
  location = "docker.io"
  mirrors = ["registry.docker-cn.com", "hub-mirror.c.163.com"]
  

• 手动提前拉取镜像，避免启动时超时：

  podman pull docker.io/postgres:14
  

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