leandelivery/filesubst

镜像概述

leandelivery/filesubst镜像包含sev工具，这是一个用Golang编写的CLI工具，旨在解决Docker化应用中通过环境变量动态配置文件内容的问题。它支持将文件中的占位符替换为环境变量值，让应用在不同环境下无需重新编译即可调整配置，降低维护复杂度。

核心功能

sev工具提供两种工作模式：

1. 简单模式：通过VAR_NAMES_STORAGE指定需处理的变量列表，递归替换目标文件/目录中_{变量名}_格式的占位符为对应环境变量的值。
2. 管道模式：通过VAR_VALUES_SETS_STORAGE提供JSON格式的多套配置集，结合VAR_VALUES_SETS_CHOSEN_ID选择特定配置集，同时支持环境变量值覆盖JSON中的配置。

使用场景

• 静态应用（如ReactJS单页应用）在开发、测试、生产环境中需调整Analytics URL、API地址等配置。
• Docker容器中需通过环境变量动态修改配置文件，避免每次环境变化重新构建镜像。

配置说明

关键环境变量

• VAR_NAMES_STORAGE：逗号分隔的变量名列表，指定需要处理的环境变量。
• VAR_VALUES_SETS_STORAGE（管道模式）：JSON格式的配置集，键为配置集ID，值为变量-值对。
• VAR_VALUES_SETS_CHOSEN_ID（管道模式）：选择要使用的配置集ID。

部署示例

Dockerfile示例

dockerfile
FROM nginx:alpine
COPY nginx/default.conf /etc/nginx/conf.d/
COPY dist/ /html
# 定义需处理的变量
ENV VAR_NAMES_STORAGE ADOBE_ANALYTICS_URL,GOOGLE_ANALYTICS_URL
# 执行sev替换配置后启动nginx
CMD ["/bin/sh", "-c", "sev /html && nginx -g 'daemon off;'"]

简单模式使用示例

1. 设置环境变量：

bash
export ADOBE_ANALYTICS_URL="//assets.adobedtm.com/staging.min.js"
export GOOGLE_ANALYTICS_URL="//test.url.com/analytics.js"
export VAR_NAMES_STORAGE="ADOBE_ANALYTICS_URL,GOOGLE_ANALYTICS_URL"

2. 执行替换：

bash
sev /html/index.html

管道模式使用示例

1. 设置环境变量：

bash
export VAR_NAMES_STORAGE="check,cntf_space"
export VAR_VALUES_SETS_STORAGE='{"prod":{"check":"in-prod","cntf_space":"prod-space"},"dev":{"check":"in-dev","cntf_space":"dev-space"}}'
export VAR_VALUES_SETS_CHOSEN_ID="prod"

2. 执行替换：

bash
sev /html