cookielab/container-image-tools

cookielab/container-image-tools

Repo: https://github.com/cookielab/container-image-tools

镜像概述和主要用途

该容器镜像包含用于构建和管理容器镜像的工具集合。基于scratch构建，同时集成了busybox提供的最小化shell工具。主要用于简化容器镜像的构建、推送流程，支持多架构镜像管理，并通过凭证助手实现与各类容器 registry 的无缝认证。

核心功能和特性

包含的工具

• https://hub.docker.com/_/busybox?tab=description%EF%BC%9A%E6%8F%90%E4%BE%9B%E5%9F%BA%E7%A1%80shell%E5%B7%A5%E5%85%B7
• https://github.com/googleContainerTools/kaniko/%EF%BC%9A%E6%97%A0%E9%9C%80Docker%E5%AE%88%E6%8A%A4%E8%BF%9B%E7%A8%8B%E7%9A%84%E5%AE%B9%E5%99%A8%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%E5%B7%A5%E5%85%B7
• https://github.com/estesp/manifest-tool%EF%BC%9A%E7%94%A8%E4%BA%8E%E7%AE%A1%E7%90%86%E5%AE%B9%E5%99%A8%E9%95%9C%E5%83%8Fmanifest%E7%9A%84%E5%B7%A5%E5%85%B7
• https://github.com/containers/skopeo%EF%BC%9A%E7%94%A8%E4%BA%8E%E6%A3%80%E6%9F%A5%E3%80%81%E5%A4%8D%E5%88%B6%E5%AE%B9%E5%99%A8%E9%95%9C%E5%83%8F%E7%9A%84%E5%B7%A5%E5%85%B7
• 凭证助手
  • https://github.com/isometry/docker-credential-env%EF%BC%9A%E9%80%82%E7%94%A8%E4%BA%8EDocker Hub、GitLab容器 registry等
  • https://github.com/awslabs/amazon-ecr-credential-helper%EF%BC%9A%E9%80%82%E7%94%A8%E4%BA%8EAWS ECR
  • https://github.com/GoogleCloudPlatform/docker-credential-gcr%EF%BC%9A%E9%80%82%E7%94%A8%E4%BA%8EGoogle Cloud GCR

使用场景和适用范围

• 容器镜像的构建与推送（支持Docker Hub、GitLab容器 registry、AWS ECR、Google Cloud GCR等）
• 多架构容器镜像的构建与合并
• CI/CD环境中容器镜像的自动化构建流程（如GitLab CI）

使用方法和配置说明

单架构镜像构建与推送（GitLab Registry示例）

通过Kaniko构建镜像并推送到GitLab容器 registry，利用ENV凭证助手进行认证，无需手动创建docker config.json文件。

shell
export DOCKER_registry_gitlab_com_USR="${CI_REGISTRY_USER}"
export DOCKER_registry_gitlab_com_PSW="${CI_REGISTRY_PASSWORD}"
kaniko --destination "${CI_REGISTRY_IMAGE}:${CI_COMMIT_SHA}"

环境变量说明：

• DOCKER_registry_gitlab_com_USR：GitLab容器 registry用户名（通常使用CI环境变量CI_REGISTRY_USER）
• DOCKER_registry_gitlab_com_PSW：GitLab容器 registry密码（通常使用CI环境变量CI_REGISTRY_PASSWORD）
• CI_REGISTRY_IMAGE：GitLab项目容器镜像地址（CI环境变量）
• CI_COMMIT_SHA：提交SHA值，用作镜像标签（CI环境变量）

多架构镜像构建（GitLab CI配置示例）

多架构镜像需在对应架构的硬件上分别构建，然后通过manifest合并。可使用预定义的GitLab CI配置实现。

yaml
include:
  - remote: https://raw.githubusercontent.com/cookielab/container-image-tools/main/.gitlab/multi-arch.yml

variables:
  DOCKER_registry_gitlab_com_USR: "${CI_REGISTRY_USER}"
  DOCKER_registry_gitlab_com_PSW: "${CI_REGISTRY_PASSWORD}"
  REGISTRY_IMAGE: "${CI_REGISTRY_IMAGE}:${CI_COMMIT_SHA}"

build:
  extends: .multiarch
  script:
    - kaniko --build-arg TARGETARCH="${TARGETARCH}" --destination "${REGISTRY_IMAGE}-${TARGETARCH}"

build-multiarch:
  extends: .manifest
  needs:
    - build

配置说明：

• include：引入多架构构建的预定义CI配置
• variables：定义认证信息和镜像地址
• build作业：继承.multiarch配置，在不同架构环境构建对应镜像（TARGETARCH为架构变量，如amd64、arm64）
• build-multiarch作业：继承.manifest配置，合并各架构镜像为多架构manifest