rhemsjapan/prepull-wait

prepull (Kubernetes集成)

镜像概述和主要用途

prepull是一个用于减少Kubernetes环境中Pod镜像拉取次数的工具，通过两个核心组件prepull-daemon和prepull-wait协同工作，优化镜像拉取流程，加快Pod启动速度并降低网络资源消耗。

核心功能和特性

• prepull-daemon：作为DaemonSet的初始化容器运行，负责在节点上预拉取指定镜像
• prepull-wait：作为Deployment或Pod的初始化容器运行，等待目标镜像完成预拉取后再继续执行后续流程
• 支持通过docker-compose.yml配置需要预拉取的镜像列表
• 集成AWS ECR认证，支持从私有镜像仓库拉取镜像

使用场景和适用范围

• Kubernetes集群中需要频繁部署或更新Pod的场景
• 镜像体积较大，拉取耗时较长的环境
• 需要降低镜像仓库访问压力和网络带宽消耗的场景
• 对Pod启动速度有较高要求的生产环境

使用方法和配置说明

prepull-daemon

配置说明

prepull-daemon作为DaemonSet的初始化容器运行，需要满足以下配置要求：

• 挂载主机的/var/run目录
• 挂载包含预拉取镜像列表的docker-compose.yml文件至/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-config
initContainers:
  - name: prepull-daemon
    image: docker.xuanyuan.run/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凭证配置 (aws-credentials secret)

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

镜像列表配置 (docker-compose.yml)

yaml
version: '3'

services:
  a:
    image: docker.xuanyuan.run/<<需要预拉取的镜像地址>>

环境变量

prepull-wait

配置说明

prepull-wait作为Deployment或Pod的初始化容器运行，用于等待prepull-daemon完成镜像预拉取。

部署示例 (Deployment/Pod配置)

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

环境变量