Dockerfile 说明

目的

部署在K8S上每个业务最终都要编译成Docker, 才能发布到K8S+TARS上.

每个业务制作成docker, 都有确定的规范, 必须遵循这个规范构建docker, 因为:

• tars服务制作成docker后, 跑在k8s上pod内部都有两个进程, 一个业务进程, 一个tarsnode进程;

• tarsnode进程是pod启动时框架注入进去的, 制作docker时候并不具备

• 业务进程目录结构有一定的规范, 必须在: /usr/local/server/bin 下

• 业务进程都有类型: cpp/nodejs/java-war/java-jar/go/php, 并通过环境变量来设定

• 业务进程其实是tarsnode进程拉起的, 根据环境变量的不同启动方式也不同

• tars服务的镜像制作时, 有一个基础镜像, 这个基础镜像包含了服务的运行环境, 比如jdk, node等, 官方针对不同语言的服务会提供对应的基础镜像, 当然你可以制作自己的基础镜像

• 基础镜像和编译镜像是保持一致的, 这样保证编译的服务能在基础镜像中运行

注意Dockerfile通常不需要你自己实现, 统一制作了一个docker容器, 里面存在了各种语言制作的Dockerfile, 从容器中copy出来即可

格式示例

Dockerfile格式大致介绍下, 以cpp语言的为例

cpp格式如下, 其他格式, 更换ServerType即可, 具体可以参考Dockerfile目录:

ARG BaseImage
ARG ServerType
ARG BIN

FROM ${BaseImage}

ENV ServerType=${ServerType}

RUN mkdir -p /usr/local/server/bin/
COPY $BIN /usr/local/server/bin/

说明:

• BaseImage: 基础镜像(tarscloud/tars.cppbase, tarscloud/tars.javabase, tarscloud/tars.nodejsbase, tarscloud/tars.php74base), 注意go的服务也使用tarscloud/tars.cppbase

• ServerType: 服务的类型(cpp/go/java-war/java-jar/nodejs/php)

• BIN: 哪些文件/文件夹, 需要copy到镜像中

• 如果你是自己编译的源码, 其中tarscloud/tars.cppbase等镜像可以使用你自己的编译出来镜像

• 制作docker

正常情况docker的制作, 是在自动构建脚本中构建, 并推送到harbor仓库中的同时发布, 当然你也可以手工制作docker, 比如:

docker build . -t xxx/notifyproxyserver --build-arg BIN=build/bin/NotifyProxyServer --build-arg BaseImage=tarscloud/tars.cppbase --build-arg ServerType=cpp
docker push xxx/notifyproxyserver

这个语句其实被exec-build.sh中执行, 在CI/CD中自动构建业务服务的镜像, 后续会介绍.