fahadhussain/jnlp-python3.7

JNLP从节点镜像文档

镜像概述

本镜像基于jenkins/jnlp-slave:3.35-5构建，作为Jenkins的JNLP从节点，预装了多种开发工具和依赖，旨在提供一站式的CI/CD构建环境，支持Python、Node.js项目开发及Docker镜像构建等任务。

核心功能与特性

系统依赖

• 基础系统工具：build-essential、ca-certificates、wget、sudo、vim等
• 图形及显示支持：xvfb、libgtk-3-0、libxss1、libxtst6等
• 开发库：libssl-dev、libffi-dev、zlib1g-dev、libnss3-dev等

开发环境

• Python：Python 3.7.3（通过源码编译安装，含pip3.7）
• Docker：Docker CE（通过Docker官方源安装）
• Node.js：Node.js 11.x（含npm）及yarn包管理器
• Python依赖：通过slave-requirements.txt安装的Python包（含pip、setuptools、wheel等基础工具）

使用场景

• Jenkins构建环境中需要Python 3.7的项目构建与测试
• 需在CI/CD流程中执行Docker镜像构建、推送的任务
• Node.js应用（如前端项目）的依赖安装、打包与测试
• 多语言混合开发项目的集成构建与持续集成

使用方法

基础使用

作为Jenkins JNLP从节点运行，需提供Jenkins主节点URL和从节点密钥：

bash
docker run -d \
  --name jenkins-jnlp-slave \
  -e JENKINS_URL=http://jenkins-master:8080 \
  -e JENKINS_SECRET=your-slave-secret \
  -e JENKINS_AGENT_NAME=my-jnlp-slave \
  [镜像名称]

环境变量说明

持久化配置

如需持久化工作目录或共享Docker引擎，可挂载卷：

bash
docker run -d \
  --name jenkins-jnlp-slave \
  -e JENKINS_URL=http://jenkins-master:8080 \
  -e JENKINS_SECRET=your-slave-secret \
  -v /var/run/docker.sock:/var/run/docker.sock \  # 共享主机Docker引擎
  -v /path/to/workspace:/home \  # 持久化工作目录
  [镜像名称]

docker-compose配置示例

yaml
version: '3'
services:
  jnlp-slave:
    image: docker.xuanyuan.run/[镜像名称]
    container_name: jenkins-jnlp-slave
    environment:
      - JENKINS_URL=http://jenkins-master:8080
      - JENKINS_SECRET=your-slave-secret
      - JENKINS_AGENT_NAME=my-jnlp-slave
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - slave-workspace:/home
    restart: unless-stopped

volumes:
  slave-workspace:

注意事项

• 运行时需确保Jenkins主节点可访问，且从节点密钥有效
• 共享Docker引擎时（挂载/var/run/docker.sock），需注意权限配置，避免安全风险
• 如需自定义Python依赖，可通过挂载自定义slave-requirements.txt至/home/目录实现