container-guide/DOCUMENTS/build-a-docker-image.md

build-a-docker-image.md

@version    180911:2
@author     zhangxuhong <zhangxuhong@xitu.io>

Name

build-a-docker-image - 构建Docker镜像.

Table of Contents

• Name
• Image Manifest Management 镜像依赖管理
• Minimize Docker Image 缩减 Docker 镜像大小

Image Manifest Management 镜像依赖管理

构建普通镜像

目前harbor中的镜像库包含以下几个项目

• lib, 公网上的镜像备份
• infrastructure, 私有基础镜像
• test, 测试用, 随便用, test发版用镜像
• beta, beta发版用镜像
• prod, prod发版用镜像

比如现在正在构建项目:

• harbor02.juejin.id/prod/demo-api

该项目依赖:

• harbor02.juejin.id/infrastructure/nginx-1.10.3-centos-with-lua-nginx-module:0.0.3
• harbor02.juejin.id/lib/framework:0.12.3

那么在引用依赖和发版的时候, 都应该使用latest tag的镜像, 这样可以保证每次新发布的时候, 可以获取最新的更新(需要手动把本地镜像缓存清理一下).
所以依赖应该是:

• harbor02.juejin.id/infrastructure/nginx-1.10.3-centos-with-lua-nginx-module:latest
• harbor02.juejin.id/lib/framework:latest

这样当这两个项目有bugfix的时候, 只需要重新构建你的项目, 而不必修改Dockerfile.

发布的时候, jenkins会自动执行你指定的jenkinsfile来把构建完毕的镜像推送到harbor, 镜像tag通常是git提交的hash值(这是在jenkinsfile自动生成的,不必手动修改).

• harbor02.juejin.id/prod/demo-api:xxxxx 用来让CI程序进行发版

构建基础镜像

制作基础镜像也是同样的流程, 比如 harbor02.juejin.id/infrastructure/nginx-1.10.3-centos-with-lua-nginx-module 修正了一个bug, 那么版本变为:

• harbor02.juejin.id/infrastructure/nginx-1.10.3-centos-with-lua-nginx-module:0.0.4

同时应再推送一个

• harbor02.juejin.id/infrastructure/nginx-1.10.3-centos-with-lua-nginx-module:latest

版本方便其他依赖该镜像的项目用来更新.

Minimize Docker Image 缩减 Docker 镜像大小

可以参考这篇文档:

• https://www.sandtable.com/reduce-docker-image-sizes-using-alpine/

基本思路就是用Alpine, 然后把不用的都删掉. 懒得删就用多端构建, 只把需要的bin和so拷贝过去.

有个实用的工具 dlayer, 可以分析每一行dockerfile命令带来的镜像膨胀.

• https://github.com/orisano/dlayer

已经在docker-client01v.lobj.juejin.id部署, 可以直接使用.