K8s中的环境变量与应用程序的对应关系与操作

2022/6/16 k8sSpring Boot

# 前言

需求:需要在k8s的部署文件(Kind:Deployment)中定义变量,在应用程序中要能够接收变量值。

最终通过设置环境变量(ENV)来给应用程序传递参数。下面来简单分析一下。

# SpringBoot中如何接收运行参数的

首先我们先了解SpringBoot中如何接收运行参数。

通常我们以一个jar的方式运行程序,比如我们的命令为java -jar -DDATE=20220616 /opt/app/app.jar ycyin 20220617

在程序中我们尝试读取值:

@SpringBootApplication
public class SpringbootApplication implements CommandLineRunner {
    protected static final Logger log = LoggerFactory.getLogger(SpringbootApplication.class);


    public static void main(String[] args) {
        SpringApplication.run(SpringbootApplication.class, args);
    }

    @Override
    public void run(String... args) {
        String date = System.getProperty("DATE");
        log.info("Logs date: {}", date);
        String dateE = System.getenv("DATE");
        log.info("Logs dateE: {}", dateE);
        for (String arg : args) {
            log.info("Logs arg: {}",arg);
        }
    }
}

输出:

Logs date: 20220616
Logs dateE: null
Logs arg: ycyin
Logs arg: 20220617

从结果中和查阅资料我们不难分析出:

  • System.getProperty()获取到的是我们指定的-DDATE=20220616参数,其实这是一个JVM参数
  • System.getenv()获取到的是我们系统的环境变量(可以设置系统环境变量试一下)
  • main函数的args获取到的是我们指定的ycyin 20220617这两个参数,我称它为命令行参数

# 在Docker和K8s中传递参数给应用程序

根据上面SpringBoot中如何接收运行参数的分析,我们可以知道:

  • 在程序中使用System.getProperty()获取参数就需要给其传递JVM参数
  • 在程序中使用System.getenv()获取参数就需要设置系统环境变量
  • 在SpringBootmain函数的args获取参数就需要给命令行参数

在Docker的Dockerfile和K8s的yaml文件中,我们可以设置ENV环境变量,并且yaml中设置的环境变量可以覆盖Dockerfile的环境变量。

如此,我们就可以通过以下Dockerfile和yaml来传递参数

# 省略其它,也可以不用定义ENV,会由k8s启动容器时给传递
ENV TYPE=${TYPE}
ENV DATE=${DATE}

CMD ["sh", "-c", "exec java $JAVA_OPTS -jar /opt/app/app.jar $TYPE $DATE"]
      containers:
        - name: c-release-name
          image: test
          imagePullPolicy: IfNotPresent
          securityContext:
            readOnlyRootFilesystem: true
            privileged: false
            runAsNonRoot: true
          env:
            - name: "JAVA_OPTS"
              value: "-Xmx1303m -Xms1303m -XX:MetaspaceSize=100m -XX:MaxMetaspaceSize=512m -Duser.language=zh -Duser.region=CN"
            - name: "MANAGEMENT_SERVER_PORT"
              value: "8081"
            - name: "SERVER_PORT"
              value: "8080"
            - name: "SPRING_PROFILES_ACTIVE"
              value: "prod"
            - name: "TYPE"
              value: "output"
            - name: "DATE"
              value: "20220614"

可以发现在Dockerfile CMD指定的命令中,$JAVA_OPTS是JVM参数、$TYPE$DATE是命令行参数,但是他们都是通过ENV环境变量传递的。

所以应用程序就可以 通过使用System.getProperty()获取到user.languageuser.regionJVM参数 通过使用System.getenv()获取到JAVA_OPTSMANAGEMENT_SERVER_PORTSERVER_PORTSPRING_PROFILES_ACTIVETYPEDATE环境变量 通过SpringBootmain函数的args获取到TYPEDATE这两个命令行参数

# 总结

我们可以通过在k8s的yaml中使用env环境变量的方式将参数传给Dockerfile(准确地说应该是传给容器运行时),Dockerfile再根据获取到的env环境变量分别视情况以JVM或命令行参数的形式(java -jar命令)传递给应用程序。