akubrinsky/envsubst

镜像概述

本镜像基于Alpine Linux构建，通过安装libintl和gettext包提供envsubst工具。envsubst是一个用于替换文本中环境变量的实用程序，能够将配置文件模板中的环境变量占位符替换为实际值，适用于动态生成配置文件的场景。

核心功能和特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 内置envsubst工具：已预安装envsubst，可直接用于环境变量替换
• 简化构建：通过apk包管理器安装依赖，构建过程简洁

使用场景

• 容器化应用中动态生成配置文件（如Nginx、Apache等服务的配置模板）
• CI/CD流程中根据环境变量生成环境特定的配置文件
• 需要将环境变量注入到静态配置文件的场景

使用方法

基本使用

运行容器并执行envsubst命令：

bash
docker run --rm -e "APP_PORT=8080" -v $(pwd):/workdir [镜像名称] envsubst < /workdir/template.conf > /workdir/config.conf

参数说明：

• -e "APP_PORT=8080": 设置环境变量，可根据需要添加多个
• -v $(pwd):/workdir: 将当前目录挂载到容器内的/workdir，用于访问模板文件和输出结果
• envsubst < template.conf > config.conf: 从template.conf读取模板，替换环境变量后输出到config.conf

示例：处理Nginx配置模板

1. 创建模板文件nginx.template.conf：

nginx
server {
    listen ${APP_PORT};
    server_name ${APP_DOMAIN};
}

2. 运行容器生成实际配置：

bash
docker run --rm -e "APP_PORT=80" -e "APP_DOMAIN=example.com" -v $(pwd):/workdir [镜像名称] envsubst < /workdir/nginx.template.conf > /workdir/nginx.conf

生成的nginx.conf将包含：

nginx
server {
    listen 80;
    server_name example.com;
}