dylanmei/envprint

envprint https://travis-ci.org/dylanmei/envprint.svg?branch=master](https://travis-ci.org/dylanmei/envprint)

镜像概述

envprint是一款轻量级配置文件模板处理器，通过环境变量插值生成最终配置文件，功能等价于使用https://github.com/gliderlabs/sigil%E8%BF%9B%E8%A1%8CPOSIX%E9%A3%8E%E6%A0%BC%E5%8F%98%E9%87%8F%E6%89%A9%E5%B1%95%E5%A4%84%E7%90%86%E6%A8%A1%E6%9D%BF%E3%80%82

核心功能

1. 多输入输出方式：支持从标准输入/文件读取模板，输出到标准输出/指定文件
2. POSIX风格变量扩展：
   • 基础变量替换：${VAR}
   • 默认值设置：${VAR:-default_value}
   • 必填变量检查：${VAR:?error_message}
3. 版本查询：通过-version参数获取当前版本

使用场景

1. 本地开发：快速生成包含环境变量的配置文件
2. Kubernetes集群：通过initContainers预生成容器所需的动态配置文件
3. CI/CD流水线：自动化生成不同环境的配置文件

配置说明

简单示例

bash
# 查看帮助
$ envprint -help

# 基础变量替换（无环境变量时为空）
$ echo 'hello ${WORLD}' | envprint
hello 

# 设置默认值
$ echo 'hello ${WORLD:-catania}' | envprint
hello catania

# 环境变量生效
$ export WORLD=palermo
$ echo 'hello ${WORLD}' | envprint
hello palermo

# 必填变量检查（无变量时抛出错误）
$ echo 'hello ${FOOBAR:?missing variable}' | envprint
missing variable
$ echo $? # 返回非0错误码
1

Kubernetes示例

通过initContainers使用envprint生成配置文件：

yaml
---
apiVersion: v1
kind: Pod
metadata:
  name: hello-pod
spec:
  containers:
  - name: main-container
    image: hello-example
    args: ["--config=/etc/config/hello.properties"]
    volumeMounts:
    - name: config-volume
      mountPath: /etc/config
  initContainers:
  - name: envprint-init
    image: dylanmei/envprint
    args: ["-f=/templates/hello.template", "-o=/etc/config/hello.properties"]
    env:
    - name: USERNAME
      value: "admin"
    - name: PASSWORD
      valueFrom:
        secretKeyRef:
          name: hello-secrets
          key: db-password
    volumeMounts:
    - name: config-volume
      mountPath: /etc/config
    - name: template-volume
      mountPath: /templates
  volumes:
  - name: config-volume
    emptyDir: {}
  - name: template-volume
    configMap:
      name: hello-templates
---
kind: ConfigMap
apiVersion: v1
metadata:
  name: hello-templates
data:
  hello.template: |
    server.host=0.0.0.0
    server.port=8080
    db.username=${USERNAME}
    db.password=${PASSWORD}