envsubst/envsubst

基础镜像文档

镜像概述

本镜像基于Alpine Linux构建，是一个轻量级基础镜像，已预先安装envsubst和bash两个核心命令。Alpine Linux的轻量级特性确保镜像体积小、资源占用低，同时集成的工具使其适用于需要环境变量处理和bash shell支持的场景。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，启动速度快，资源占用低
• 预装工具：已集成envsubst命令，支持环境变量替换操作
• bash支持：预装bash，提供比Alpine默认sh更丰富的shell功能

使用场景

• 需要对配置文件进行环境变量替换的应用部署
• 依赖bash shell特性的脚本执行环境
• 作为基础镜像构建需要envsubst或bash支持的应用镜像

使用方法

拉取镜像

bash
docker pull [镜像名称]  # 请替换为实际镜像名称

基本使用示例

1. 启动bash交互终端

bash
docker run -it --rm [镜像名称] bash

此命令将启动容器并进入bash交互终端，可直接使用bash命令。

2. 使用envsubst进行环境变量替换

假设当前目录下有配置文件config.template，内容如下：

APP_NAME=${APP_NAME}
APP_PORT=${APP_PORT}

通过以下命令将环境变量替换到配置文件中：

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

执行后，当前目录将生成config.conf文件，其中环境变量已被实际值替换。

作为基础镜像使用

在Dockerfile中可将本镜像作为基础镜像：

dockerfile
FROM [镜像名称]

# 后续构建步骤...

注意事项

• 本镜像仅包含基础Alpine系统及envsubst、bash工具，如需其他依赖需自行安装
• envsubst默认替换所有环境变量，如需指定替换特定变量，可使用envsubst '${VAR1} ${VAR2}'格式