工具背景
如今,docker镜像常用于工具的分发,demo的演示,第一步就是得创建docker镜像。
一般入门都会安装docker,然后用dockerFile来创建镜像,除此以外你还想过有更高效的方式吗?
Google开发的jib不依赖docker环境也能创建docker或者OCI类型的镜像,但是可惜它只为java应用而生,其他类型的比如nodejs,.net应用都无法用,而且它是作为maven/gradle的插件形式来工作的,而不是一个纯粹独立构建镜像的工具。
介于上述原因,来介绍我开发的这款工具,名字也叫jib,只不过它是一个纯粹构建镜像工具,支持win,linux,osx三个平台
我的口号是:
Build container images for your any applications.
功能包含:
-
构建镜像推送到镜像仓库(dockerhub/aliyun/tencent共有仓库,harbor等私有仓库) -
构建镜像推送到本地docker环境 -
构建镜像生成tar格式镜像文件到本地
工具地址: https://github.com/yuzd/jib
工具使用
它是一个纯粹构建镜像命令行工具,根据不同的功能有不同的参数,如下图
windows平台
macos平台
作为一个纯粹的构建镜像工具,它不需要依赖docker环境,只需要读取一个json配置文件,根据配置生成镜像
json配置文件
命令: jib.exe -push --configfile=demo.json
推送到镜像仓库的配置示例(从阿里云镜像仓库拉取base镜像+我要加的目录=新的镜像并推送到私有仓库):
{
"BaseHttpProxy": "",
"BaseImage": "ccr.ccs.tencentyun.com/dotnet-core/aspnet:2.2",
"BaseImageCredential": {
"UserName": "aaaaaaaa",
"Password": "xxxxx"
},
"TargetHttpProxy": "",
"TargetImage": "http://127.0.0.1:5000/test1",
"TargetTags": [
"1.0.1"
],
"TargetImageCredential": {
"UserName": "aaaa",
"Password": "xxxx"
},
"ImageFormat": "Docker",
"ImageLayersFolder": "E:\\workspace\\demo\\publish",
"ImageWorkingDirectory": "/publish",
"Entrypoint": [
"dotnet"
],
"Cmd": [
"/publish/RazorTestProject.dll"
],
"ApplicationLayersCacheDirectory": "E:\\workspace\\cache",
"SkipExistingImages":true,
"IgnoreList":[
"支持正则"
]
"Env":{
"env1":"value1"
},
"Ports":[
{
"port":8080,
"protocol":"tcp"
}
],
"Volumes":[
"/var/log",
"/var/log2"
]
}
字段名 | 含义 | 备注 |
---|---|---|
BaseHttpProxy | 代理 | 拉取基础镜像的时候看你需要,格式 ip:port |
BaseImage | 基础镜像地址 | 完整地址,包含了版本,如果仓库地址没有https,请在最前面加上http:// |
BaseImageCredential | 拉取基础镜像如果要登录 | 账户名+密码 |
TargetHttpProxy | 代理 | 只有在推送到远程镜像且你有需要,才需要配置 格式ip:port |
TargetImage | 目标镜像 | 要推送的目标镜像仓库地址,不包含版本,如果仓库地址没有https,请在最前面加上http:// |
TargetTags | 镜像标签 | 可以理解为版本号 |
TargetImageCredential | 如果目标镜像仓库要登录 | 账户名+密码 |
ImageFormat | 镜像仓库构建格式 | Docker和OCI两种 |
ImageLayersFolder | 要打包进镜像仓库的目录 | 通常这就是你的项目成果物 |
ImageWorkingDirectory | 打包的目标仓库的工作目录 | 如果设置那你的文件们都会在这个目录下工作 |
Entrypoint | 镜像启动的入口 | 比如dotnet |
Cmd | 镜像启动执行的参数 | 供Entrypoint使用 |
ApplicationLayersCacheDirectory | 程序在运行时候会产生缓存目录来加快下次构建速度 | 可以不指定,会用temp目录 |
Env | 环境变量 | 可以不指定,容器启动指定也行 |
Ports | 端口 | 可以不指定,容器启动指定也行 |
Volumes | 共享目录 | 可以不指定,容器启动指定也行 |
SkipExistingImages | 如果目标仓库有一模一样的镜像就不会上传 | 比对的是镜像sha256 |
IgnoreList | 要打包的目录里面可以排除某些文件 | 正则表达式 |
tar格式镜像文件本地生成
命令: jib.exe -tar --configfile=demo.json --outfile=demo.tar
示例
{
"BaseHttpProxy": "",
"BaseImage": "ccr.ccs.tencentyun.com/dotnet-core/aspnet:2.2",
"BaseImageCredential": {
"UserName": "aaaaaaaa",
"Password": "xxxxx"
},
"ImageFormat": "Docker",
"ImageLayersFolder": "E:\\workspace\\demo\\publish",
"ImageWorkingDirectory": "/publish",
"Entrypoint": [
"dotnet"
],
"Cmd": [
"/publish/RazorTestProject.dll"
]
}
json配置参数就少了推送相关的参数
本地tar文件的镜像,可以通过docker load命令在装载到docker环境中。
推送镜像到本机的docker环境
命令: jib.exe -deamon --configfile=demo.json
json配置和tar差不多
写到最后
该工具支持多平台(linux、win、mac) 17M左右大小,不依赖docker环境,独立构建镜像速度很快,除了第一次基础镜像的拉取需要时间,有缓存的话只需要几秒搞定 适用于在CICD流水线中使用。
我也集成到了我的AntDeploy一键发布工具中, 开源地址: https://github.com/yuzd/AntDeploy .net应用可以下载AntDeploy Vs插件, 可以在vs中一键发布镜像推送到镜像仓库功能,还支持一键部署到iis,windows/linux服务 欢迎试用~
关于我
微软最有价值专家(MVP),.NET 技术专家,热爱开源,关注并喜欢研究前沿技术,热衷于技术和经验分享,长期撰写技术博客,活跃于开源社区。