Docs: Kaniko

Wed, 22 Mar 2023 11:10:14 +0800

简要概述

需要在容器里面构建镜像，一般有以下 3 中方式：

通过挂载宿主的运行时 socket；
通过 Docker-in-Docker 方式；
使用 buildkit 工具与运行时 socket；

以上方式均需要依赖后端的容器 daemon，可能还需特权模式，这样构建镜像不够便利以及可能存在安全风险。

这里通过 kaniko 在容器运行时构建镜像，而不依赖后端。

镜像地址

官方镜像

gcr.io/kaniko-project/executor:v1.9.1
gcr.io/kaniko-project/executor:v1.9.1-slim
gcr.io/kaniko-project/executor:v1.9.1-debug

默认镜像是 “FROM scratch”，也就是不带任何 “shell”，无法登录调试。其他 “-slim” 是瘦身精简的镜像，而 “-debug” 是带了 “busybox” 版本的 “shell” 镜像。

国内镜像

registry.cn-hangzhou.aliyuncs.com/kube-image-repo/kaniko:v1.9.1
registry.cn-hangzhou.aliyuncs.com/kube-image-repo/kaniko:v1.9.1-slim
registry.cn-hangzhou.aliyuncs.com/kube-image-repo/kaniko:v1.9.1-debug

国内仅同步 “linux/amd64” 架构。

命令参数

名称	默认值	描述
build-arg	-	“MY_VAR=‘value with spaces’”
cache	false	TODO;
cache-dir	/cache	需配合参数 “–cache=true” 使用
cache-repo	-	需配合参数 “–cache=true” 使用
cache-copy-layers	-	TODO;
cache-run-layers	true	TODO;
cache-ttl	336h0m0s	TODO;
cleanup	-	完成时清理文件系统内容，不做清理的话，当前容器将会是 Dockerfile 构建后的结果
compressed-caching	true	压缩缓存层，以减少编译时间，但增加内存使用
context	/workspace/	指向 Dockerfile 文件路径
context-sub-path	TODO;	TODO;
custom-platform	同宿主架构	自定义构建的架构，如：linux/adm64，类型：docker build –platform
destination	-	构建的容器镜像全名，可添加多个，上传到指定的仓库
digest-file	/dev/termination-log	用于接收构建镜像的信息
dockerfile	Dockerfile	使用哪个 Dockerfile 文件构建镜像
force	-	TODO;
force-build-metadata	-	TODO;
git	branch=,single-branch=false,recurse-submodules=false	如果编译上下问来自 git 仓库
ignore-path	-	TODO;
ignore-var-run	true	TODO;
image-fs-extract-retry	-	重试次数
image-name-tag-with-digest-file	-	TODO;
image-name-with-digest-file	-	TODO;
insecure	false	使用 HTTP 协议推送镜像至镜像中心
insecure-pull	false	使用 HTTP 协议拉取镜像
insecure-registry	-	使用 HTTP 协议的镜像中心列表，可添加多个
kaniko-dir	/kaniko	指向 kaniko 目录，优先级高于 “KANIKO_DIR” 环境变量
label	-	设置镜像标签
log-format	color	日志格式，可取：text, color, json
log-timestamp	-	日志时间戳
no-push	-	不上传至镜像中心
no-push-cache	-	不上传至镜像中心
oci-layout-path	-	存放 oci 格式的镜像路径
push-retry	-	上传镜像的重试次数
registry-certificate	-	使用 tls 认证镜像中心
registry-mirror	-	用于 pull 镜像使用的 mirror，如：docker.io
reproducible	-	TODO;
single-snapshot	-	TODO;
skip-tls-verify	-	push 镜像跳过 tls 验证
skip-tls-verify-pull	-	pull 镜像跳过 tls 验证
skip-tls-verify-registry	-	对指定镜像中心跳过 tls 验证
skip-unused-stages	-	TODO;
snapshot-mode	full	TODO;
tar-path	-	镜像以 tar 格式保存路径
target	-	TODO;
use-new-run	-	TODO;
verbosity	info	日志级别：trace, debug, info, warn, error, fatal, panic

应用场景

启动进入 shell

docker run \
 -i -t \
 --rm \
 --entrypoint /bin/sh \
 registry.cn-hangzhou.aliyuncs.com/kube-image-repo/kaniko:v1.9.1-debug

构建容器镜像

假设需要构建 “ccr.ccs.tencentyun.com/opsaid/test2:0.1.0” 镜像，则可使用以下指令：

docker run \
 -v /tmp/coding/test2:/workspace \
 -v /tmp/docker/config.json:/kaniko/.docker/config.json:ro \
 registry.cn-hangzhou.aliyuncs.com/kube-image-repo/kaniko:v1.9.1 \
 --dockerfile /workspace/Dockerfile \
 --context /workspace \
 --destination ccr.ccs.tencentyun.com/opsaid/test2:0.1.0

脚本分析：

应用代码

/workspace/Dockerfile 内容：

添加 “ccr.ccs.tencentyun.com/opsaid” 镜像中心权限

见配置：/tmp/docker/config.json

{
 "auths": {
 "ccr.ccs.tencentyun.com": {
 "auth": "base64(username:password)"
 }
 }
}

挂载至 kaniko 容器内 “/kaniko/.docker/config.json” 地址。如果您更改了 “kaniko” 镜像，导致变量 “$HOME” 非 “/kaniko"，则需要更改挂载的配置，否则 “/kaniko/executer” 会无法正确读取授权文件。

Docs: Multi Arch

Fri, 14 Apr 2023 22:46:52 +0800

简要概述

如何构建多架构镜像

Docs: Fpm

Thu, 08 Dec 2022 10:46:49 +0800

简要概述

实现各系统打包，如：rpm、deb 等

https://github.com/jordansissel/fpm

安装部署

ubuntu 20.04 示例

apt install -y ruby
gem install fpm

# 打 rpm 包需要
apt install rpm

# 打 deb 包需要
apt install binutils

root@ubuntu:~# fpm --version
1.15.0
root@ubuntu:~#

centos 7 示例

# 安装依赖的 ruby 环境
yum install -y ruby

# 查看 ruby 版本
[root@lfheaplt gitlab-runner]# ruby --version
ruby 2.0.0p648 (2015-12-16) [x86_64-linux]
[root@lfheaplt gitlab-runner]#

# 移除默认 sources
gem source --remove https://rubygems.org/

# 添加阿里云 sources
gem sources -a https://mirrors.aliyun.com/rubygems/

# 安装 rvm
curl -sSL https://get.rvm.io | bash -s stable

# 升级 ruby
/usr/local/rvm/bin/rvm install 2.7

# 通过 gem 安装 fpm
gem install fpm

OPSaid – 构建与发布

Docs: Kaniko

简要概述

镜像地址

命令参数

应用场景

启动进入 shell

构建容器镜像

Docs: Multi Arch

简要概述

Docs: Fpm

简要概述

安装部署

制作安装包

RPM包