详解Docker如何在前端项目动态插入并使用变量

来自:网络
时间:2024-06-08
阅读:

前言

根据项目需求,在实现登出功能时,需要根据测试环境和生产环境调用不同的登出URL。本文将介绍如何在Docker前端镜像中设置变量以及使用变量的方法。

解决办法

在生成前端容器的阶段,可以使用同一个镜像,根据不同的环境传入参数来创建不同的前端容器。下面将分享一个在容器执行阶段动态插入并使用变量的实例。

步骤

1.在根目录创建start.sh文件,文件内容如下:

#!/usr/bin/env sh

cat /etc/nginx/nginx.conf
nginx -g "daemon off;"

注: #!/usr/bin/env sh 并不是注释的意思,而是选择编译语言的意思。建议使用sh,因为bash可能不是每台服务器都安装的。

注: 为什么要加nginx -g "daemon off;"?

因为要让容器能持续运行,必须要有前台进程,这里将nginx转为前台进程。

2.在Dockerfile中复制start.sh,将其从容器外复制到容器内:

...
COPY start.sh /app/start.sh

3.在根目录创建nginx.conf.template文件,首先从nginx.conf复制代码,然后在文件的http -> server下添加ENV_VARS占位符,代码如下:

http {
    ...
    server {
        .....
        location /env.json {
            default_type application/json;
            return 200 '${ENV_VARS}';
        }
    }
}

4.在项目的服务器端创建一个获取变量的方法,代码如下:

type Env = {
  logoutUrl?: string;
};

export async function getEnvironmentVariables() {
  return request<Env>('/env.json', { method: 'GET' });
}

5.在项目代码中添加使用变量的方法,代码如下:

const logout = () => {
    getEnvironmentVariables()
      .then((data) => {
        const logoutUrl = data?.logoutUrl;
        if (logoutUrl) {
         ...
        }
      })
      .catch((e) => {
        ...
      });
  };

6.在正常构建镜像之后,在生成容器时,可以通过环境变量传参来替换原前端nginx.conf.template文件中的ENV_VARS字符串:

docker run -e ENV_VARS='{"logoutUrl": "xxxxxx"}' --name test -p 81:8000 -itd swr.test:v0.0.31

sh start.sh

注:如果替换的环境变量是JSON格式,需要将变量值用单引号包含,变量值内的属性值使用双引号。例如:ENV_VARS='{"logoutUrl": "xxxxxx"}'

后言

这个设计使得在前端独立容器化部署时,能够通过环境变量解耦登出地址,避免了一次又一次的构建镜像工作量。

返回顶部
顶部