steerben/rootless-jenkins-slave

rootless-jnlp-slave 镜像文档

镜像概述和主要用途

rootless-jnlp-slave是一个基于https://hub.docker.com/r/jenkins/jnlp-slave/%E7%9A%84Docker%E9%95%9C%E5%83%8F%EF%BC%8C%E5%85%B6%E6%A0%B8%E5%BF%83%E7%89%B9%E6%80%A7%E6%98%AF%E4%BD%BF%E7%94%A8%E9%9D%9Eroot%E7%94%A8%E6%88%B7ID%E8%BF%90%E8%A1%8C%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E8%A7%A3%E5%86%B3%E4%BA%86%E5%9C%A8%E5%AE%89%E5%85%A8%E5%8F%97%E9%99%90%E7%8E%AF%E5%A2%83%E4%B8%AD%E9%83%A8%E7%BD%B2Jenkins JNLP代理的问题，确保容器能够符合严格的安全策略要求。

核心功能和特性

• 非root用户运行：容器内进程以非root用户身份执行，降低权限提升安全风险
• 官方镜像兼容性：完全继承jenkins/jnlp-slave的所有功能和行为，确保与Jenkins生态系统的兼容性
• 安全策略适配：支持在启用PodSecurityPolicies的Kubernetes环境中运行，满足https://kubernetes.io/docs/concepts/policy/pod-security-policy/#users-and-groups%E7%AD%96%E7%95%A5%E8%A6%81%E6%B1%82

使用场景和适用范围

• Kubernetes集群环境：特别适用于已配置PodSecurityPolicies且限制容器必须以非root用户运行的Kubernetes集群
• 安全敏感环境：任何对容器运行用户有严格权限限制的安全合规场景
• Jenkins分布式构建：作为Jenkins主节点的JNLP代理，参与分布式构建、测试和部署任务

使用方法和配置说明

基本运行命令

使用以下命令启动容器，连接到Jenkins主节点：

bash
docker run -d --name rootless-jnlp-agent \
  -e JENKINS_URL=<Jenkins主节点URL> \
  -e JENKINS_SECRET=<代理密钥> \
  -e JENKINS_AGENT_NAME=<代理名称> \
  docker.xuanyuan.run/rootless-jnlp-slave

Kubernetes部署示例

在Kubernetes中部署时，无需额外配置用户，镜像默认以非root用户运行，可直接满足MustRunAsNonRoot策略：

yaml
apiVersion: v1
kind: Pod
metadata:
  name: jenkins-jnlp-agent
spec:
  containers:
  - name: jnlp
    image: docker.xuanyuan.run/rootless-jnlp-slave
    env:
    - name: JENKINS_URL
      value: "https://jenkins.example.com"  # 替换为实际Jenkins主节点URL
    - name: JENKINS_SECRET
      valueFrom:
        secretKeyRef:
          name: jenkins-agent-secret
          key: secret  # 从Secret获取代理密钥
    - name: JENKINS_AGENT_NAME
      value: "rootless-agent-01"  # 代理节点名称
  securityContext:
    runAsNonRoot: true  # 显式指定非root运行，与镜像特性匹配

环境变量配置