开门见山,本文分享前后端别离,容器化前端项目时动态刺进后端API基地址,这是一个很赞的实践,处理了前端项目容器化过程中受制后端调用的为难。
为难从何而来
常见的web前后端别离:前后端分隔布置,前端项目由nginx承载打包文件,反向署理请求。
应用的某些部分必须是可装备的,比方API调用基地址
,
前端打包的时候需求统一刺进该地址构成完好chunk files。
# ------------------------------------------------------
# generate chunk file
# ------------------------------------------------------
FROM node:10-alpine as builder
# install and cache app dependencies
COPY package.json package-lock.json ./
RUN npm install && mkdir /react-frontend && mv ./node_modules ./react-frontend
WORKDIR /react-frontend
COPY . .
RUN npm run build
# ------------------------------------------------------
# Production Build
# ------------------------------------------------------
FROM nginx:latest
COPY nginx.conf /etc/nginx/nginx.conf
COPY --from=builder /react-frontend/build /usr/share/nginx/html
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]
在Docker中打包前端,或许会尝试用镜像构建参数Arg/Env
来传递后端API调用基地址,但这样是很不理想的:
打包时参数被统一刺进,打包成果chunk files作为终究镜像的一部分,导致终究的前端镜像会与后端API地址强关联。
或许你会针对不用的后端环境(canary、staging、production)构建不同的前端镜像,但这是一次又一次的工作量,并不是最佳实践。
下面分享一个容器履行阶段动态刺进后端API基地址的实践
前端以容器方式独立布置,动态刺进后端API基地址(in Docker)
我希望将API基地址延迟到生成容器
阶段(与构建镜像的过程解耦), 这样我就可以运用一个镜像,针对不同的环境传参构成不同的前端容器。
在前端装备中写入后端APi基地址API_BASE_URL
占位符,
// FILE: set-env.ts
...
export const environment = {
production: ${isProd},
apiBaseUrl: 'API_BASE_URL',
version: 'v${require('../package.json').version}'
};
...
按照既定流程前端打包;
Dockerfile CMD指令指示容器怎么运转:
- 用实在值替换前端chunk files华夏刺进的
API_BASE_URL
占位符 - 运用nginx承载替换后的chunk files
# FILE: Dockerfile
...
EXPOSE 80
COPY --from=builder /react-frontend/replace_api_url.sh /
CMD ["sh", "replace_api_url.sh"]
下面是replace_api_url.sh的内容:
#!/usr/bin/env sh
find '/usr/share/nginx/html' -name '*.js' -exec sed -i -e 's,API_BASE_URL,'"$API_BASE_URL"',g' {} \;
nginx -g "daemon off;"
为什么要加nginx -g “daemon off”; 由于要让容器能继续运转, 必须要有前台进程,常规的nginx是后台守护进程,我们在 CMD 履行的以上 [“sh”, “replace_api_url.sh”], 实际现已开端在履行进程,脚本履行完,进程退出, 容器也会退出; 这里要将nginx转为 前台进程。
sed -i ‘s/bj.name.vip.before.com/bj.name.last.com’ /app/config.toml 将文件华夏字符串 修改为 后者字符串 sed -i ‘s/bj.name.vip.before.com/bj.name.last.com’ /app/config.toml
表明全文替换
我们在运用常规的nginx时, 为啥不需求这样写 : docker run -it -d nginx
呢?
由于 nginx官方dockerfile 内部现已指明运用前台进程。 github.com/nginxinc/do…
正常构建镜像之后;现在生成容器时,可通过环境变量传参替换原前端chunk files的API_BASE_URL字符串
docker build -t front .
docker run -p 80:80 -e API_BASE_URL=http://somebackend.com/api front
总结输出
这是一个巧妙的设计,让我们在前端独立容器化布置时,能解耦后端API基地址,避免了一次又一次的构建镜像工作量。
Dockerfile CMD指令包装的容器发动脚本:让我们在nginx承载前端打包文件之前,做一次字符串替换,成功将后端API基地址“延迟”到容器运转阶段。