Ansible管理Docker Compose中PostgreSQL容器设置et_EE locale失败求助

核心问题定位 #

你的问题集中在两个关键点：一是Dockerfile中的locale配置未在容器中生效，二是Ansible未输出构建日志，疑似跳过了镜像构建步骤。以下是针对性的排查和解决步骤：

1. 确认Ansible是否触发了镜像构建 #

• 检查Playbook中docker_image（或community.docker.docker_image）模块的配置：
  • 必须指定source: build明确触发构建逻辑
  • 添加force_source: yes强制跳过缓存，确保每次执行都重新构建（避免因镜像已存在而跳过）
  • 示例配置：

    - name: Build custom PostgreSQL image with et_EE locale
      community.docker.docker_image:
        name: postgres-et-locale
        build:
          path: ./postgres-docker  # Dockerfile所在目录路径
          dockerfile: Dockerfile
        source: build
        force_source: yes
    

• 执行Playbook时使用-vvv级别的日志，搜索Building image关键词：
  • 如果无相关日志，说明构建步骤未触发，需检查上述模块参数是否配置正确；如果有构建日志，继续排查Dockerfile配置。

2. 修正Dockerfile的locale配置（适配PostgreSQL官方镜像） #

PostgreSQL官方镜像基于Debian/Ubuntu，需正确安装locale工具并生成et_EE locale，以下是经过验证的Dockerfile：

FROM postgres:16  # 指定具体版本，避免latest镜像变动导致问题

# 安装locale生成依赖
RUN apt-get update && \
    apt-get install -y --no-install-recommends locales && \
    rm -rf /var/lib/apt/lists/*

# 启用et_EE.UTF-8 locale并生成
RUN sed -i '/et_EE.UTF-8/s/^# //g' /etc/locale.gen && \
    locale-gen

# 全局设置locale环境变量
ENV LANG et_EE.UTF-8
ENV LC_ALL et_EE.UTF-8

若使用Alpine-based的PostgreSQL镜像（如postgres:16-alpine），需替换为Alpine的locale安装命令：

FROM postgres:16-alpine
RUN apk add --no-cache musl-locales musl-locales-lang
ENV LANG et_EE.UTF-8
ENV LC_ALL et_EE.UTF-8

3. 确保容器启动时locale环境变量未被覆盖 #

在docker_container模块中，需显式传递locale环境变量，避免被默认值覆盖：

- name: Start PostgreSQL container with et_EE locale
  community.docker.docker_container:
    name: postgres-et
    image: postgres-et-locale
    state: started
    env:
      LANG: et_EE.UTF-8
      LC_ALL: et_EE.UTF-8
      POSTGRES_PASSWORD: your-secure-password
    ports:
      - "5432:5432"

4. 手动验证镜像有效性 #

先脱离Ansible，手动构建并测试镜像，确认locale配置本身无问题：

1. 执行docker build -t test-postgres-et .构建镜像
2. 运行临时容器验证：docker run -it --rm test-postgres-et locale -a
   • 若输出包含et_EE.UTF-8，说明Dockerfile配置正确，问题在Ansible的构建触发逻辑；若不包含，继续调整Dockerfile。

常见问题总结 #

• 构建步骤被跳过：Ansible默认使用镜像缓存，需添加force_source: yes强制重构，或修改Dockerfile内容触发缓存失效
• locale未生成：针对镜像基础系统（Debian/Ubuntu vs Alpine）使用对应的locale安装和生成命令
• 环境变量被覆盖：容器启动时需显式设置LANG和LC_ALL，避免被PostgreSQL容器的默认值覆盖

内容的提问来源于stack exchange，提问作者Mairold Kunimägi