galea/dependencies-plugin

Drone依赖层插件

这是[***]

概述

该插件旨在通过对项目环境构建进行多层化处理，加快Drone构建速度；同时保存包含所有必要依赖的环境，以便在出现问题时轻松回滚。

核心功能

• 拉取已存在的依赖层镜像（基于依赖文件的MD5哈希校验）
• 构建新的依赖层镜像（当依赖文件变更时）
• 支持多依赖文件生成哈希标签
• 向指定镜像仓库推送/拉取依赖层镜像

使用场景

适用于需要加速构建流程且依赖文件变更频率较低的项目，如Python（基于requirements.txt）、NodeJS（基于package.json和package-lock.json）等语言的项目。

配置说明

参数参考

• image: 依赖层镜像的仓库地址
• files: 用于生成校验和标签的依赖文件列表（数组形式）
• tag: 依赖层镜像的主标签（如latest）
• dockerfile: 构建依赖层镜像的Dockerfile路径及名称
• registry: 镜像仓库地址（默认使用公共Docker Hub）
• username: 镜像仓库的用户名
• password: 镜像仓库的密码（需与用户名配合使用）

部署示例

Python项目依赖层构建

1. 编写依赖层Dockerfile（deps.Dockerfile）：

docker
FROM docker.xuanyuan.run/python:3.6.8-slim-stretch

RUN mkdir -p /app

COPY requirements.txt /app/.

RUN pip install -U pip setuptools wheel

ENV PIP_WHEEL_DIR=/wheelhouse \
    WHEELHOUSE=/wheelhouse \
    PIP_FIND_LINKS=/wheelhouse

WORKDIR /app

RUN pip wheel numpy \
    && while read p; do pip wheel $p; done < requirements.txt

2. 主项目Dockerfile使用依赖层镜像：

docker
FROM docker.xuanyuan.run/myrepo/mypythonimage-deps:latest

WORKDIR /app

RUN while read p; do pip install --no-index -f /wheelhouse $p; done < requirements.txt \
  && rm -rf /wheelhouse
 
# 其余Dockerfile命令
[...]

3. Drone流水线配置：

yaml
steps:
- name: pull_or_build_deps
  image: docker.xuanyuan.run/galea/dependencies-plugin
  settings:
    image: docker.xuanyuan.run/galea/mypython-image-deps
    files: [ requirements.txt ]
    tag: latest
    dockerfile: ./deps.Dockerfile
  volumes: # 需保留镜像供所有流水线使用
  - name: docker_socket
    path: /var/run/docker.sock

NodeJS项目依赖层构建

1. 依赖层Dockerfile：

docker
FROM docker.xuanyuan.run/node:10.15.0

RUN mkdir -p /app

WORKDIR /app

COPY package-lock.json /app/.
COPY package.json /app/.

RUN npm ci

2. 主项目Dockerfile：

docker
FROM myrepo/mynodeimage-deps:latest

COPY . /app/.

EXPOSE 80

ENTRYPOINT ["npm", "run"]
CMD ["start"]