rhemsjapan/prepull-daemon

prepull (与Kubernetes配合使用)

镜像概述和主要用途

prepull是一个用于减少Kubernetes环境中Pod镜像拉取次数的工具，通过两个组件prepull-daemon和prepull-wait协同工作，实现镜像的预拉取与等待机制，从而优化镜像拉取流程，降低网络带宽消耗并缩短Pod启动时间。

核心功能和特性

• prepull-daemon：以DaemonSet的initContainer形式运行，负责在集群节点上预拉取指定镜像
• prepull-wait：以Deployment/Pod的initContainer形式运行，用于等待目标节点上的prepull-daemon完成镜像预拉取
• 支持通过docker-compose.yml配置需要预拉取的镜像列表
• 集成AWS ECR认证，支持从私有镜像仓库拉取镜像

使用场景和适用范围

适用于Kubernetes集群环境，特别是需要频繁部署Pod且对启动速度有要求的场景，可有效减少重复的镜像拉取操作，节省网络资源并提升Pod部署效率。

详细使用方法和配置说明

prepull-daemon

配置说明

prepull-daemon作为DaemonSet的initContainer启动，需配合一个常驻容器（如pause容器）运行。配置需满足以下要求：

• 挂载主机的/var/run目录
• 挂载包含预拉取镜像列表的/home/docker-compose.yml文件
• 挂载AWS凭证到/root/.aws/config
• 设置必要的环境变量

部署示例（DaemonSet配置）

yaml
volumes:
  - name: docker
    hostPath:
      path: /var/run
  - name: aws-credentials
    secret:
      secretName: aws-credentials
  - name: docker-compose
    configMap:
      name: prepull-docker-compose  # 包含docker-compose.yml的ConfigMap
initContainers:
  - name: prepull-daemon
    image: rhemsjapan/prepull-daemon:latest
    imagePullPolicy: IfNotPresent
    volumeMounts:
      - name: docker
        mountPath: /var/run
      - name: aws-credentials
        subPath: config
        mountPath: /root/.aws/config
      - name: docker-compose
        subPath: docker-compose.yml
        mountPath: /home/docker-compose.yml
    env:
      - name: AWS_REGION
        value: "ap-northeast-1"
      - name: AWS_ACCOUNT_ID
        value: "012345678910"
containers:
  - name: pause
    image: 602401143452.dkr.ecr.us-east-2.amazonaws.com/eks/pause:3.1-eksbuild.1

相关配置文件

aws-credentials（Secret内容）

[default]
aws_access_key_id=<<此处填写访问密钥>>
aws_secret_access_key=<<此处填写密钥>>

docker-compose.yml（ConfigMap内容）

yaml
version: '3'

services:
  a:
    image: <<需要预拉取的镜像地址>>

环境变量说明

prepull-wait

配置说明

prepull-wait作为Deployment或Pod的initContainer启动，用于等待所在节点上的prepull-daemon完成指定镜像的预拉取。

部署示例（Pod/Deployment配置）

yaml
initContainers:
  - name: prepull-wait
    image: rhemsjapan/prepull-wait:latest
    imagePullPolicy: IfNotPresent
    env:
      - name: NODE_IP
        valueFrom:
          fieldRef:
            fieldPath: status.hostIP

环境变量说明