Jenkins K8s插件配置疑问：JNLP容器相关问题咨询

疑问1：为何Pod模板配置中包含JNLP？它的作用是什么？能否仅使用自定义镜像的Pod和容器？ #

• JNLP（Java Network Launch Protocol）容器是Jenkins Kubernetes插件默认生成的代理通信容器，核心作用是搭建Jenkins主节点与代理Pod之间的双向通信链路：主节点通过它下发任务指令，代理Pod通过它上报任务状态、传递日志。
• 默认情况下插件会自动创建这个容器，因为它是主从节点通信的基础组件。但可以仅使用自定义镜像的单容器Pod，前提是你的自定义镜像中包含Jenkins代理客户端（jnlp-agent相关依赖包），并且配置正确的启动命令来完成与主节点的连接。

疑问2：如何使用自定义镜像替换JNLP的默认inbound镜像？ #

有两种适配你的Jenkins配置即代码（CasC）+ Helm Chart场景的实现方式：

方式1：全局替换所有代理的JNLP镜像 #

直接修改Helm Values中agent段的镜像参数，覆盖默认JNLP容器镜像：

agent:
  # 此处的image/tag对应默认JNLP容器的镜像，直接替换为你的自定义镜像
  image: "805787217936.dkr.ecr.us-west-2.amazonaws.com/aba-jenkins-slave"
  tag: "ecs-global-node_master_57"
  # 保留原有args，JNLP容器需要这两个参数完成主节点连接
  args: "${computer.jnlpmac} ${computer.name}"

方式2：为单个PodTemplate指定JNLP容器 #

如果仅需给特定Pod模板替换JNLP镜像，在podTemplates中显式定义JNLP容器并指定自定义镜像：

agent:
  podTemplates:
    jenkins-slave-pod: |
      - name: jenkins-slave-pod
        label: jenkins-slave-pod
        containers:
          - name: main
            image: '805787217936.dkr.ecr.us-west-2.amazonaws.com/aba-jenkins-slave:ecs-global-node_master_57'
            command: "sleep"
            args: "30d"
            privileged: true
          # 显式声明JNLP容器，使用自定义镜像
          - name: jnlp
            image: '你的自定义JNLP镜像地址'
            args: "${computer.jnlpmac} ${computer.name}"
            workingDir: "/home/jenkins/agent"

疑问3：如何让任务运行在名为'main'的容器而非JNLP容器中？ #

方法1：在Pipeline中显式指定容器 #

在Jenkinsfile里用container('main')块包裹任务步骤，强制指定任务运行容器：

pipeline {
  agent {
    label 'jenkins-slave-pod'
  }
  stages {
    stage('Build') {
      steps {
        container('main') {
          sh 'echo "任务运行在main容器中"'
          // 此处添加你的构建、测试等任务命令
        }
      }
    }
  }
}

方法2：修改PodTemplate设置默认执行容器 #

在PodTemplate配置中添加defaultContainer: 'main'参数，让该模板的所有任务默认使用main容器：

agent:
  podTemplates:
    jenkins-slave-pod: |
      - name: jenkins-slave-pod
        label: jenkins-slave-pod
        defaultContainer: 'main' # 指定默认执行容器为main
        containers:
          - name: main
            image: '805787217936.dkr.ecr.us-west-2.amazonaws.com/aba-jenkins-slave:ecs-global-node_master_57'
            command: "sleep"
            args: "30d"
            privileged: true

进阶：完全移除JNLP容器 #

如果想彻底去掉JNLP容器，需要确保你的main容器镜像中包含Jenkins代理客户端，同时修改启动命令为JNLP连接指令，删除默认的JNLP相关配置：

agent:
  podTemplates:
    jenkins-slave-pod: |
      - name: jenkins-slave-pod
        label: jenkins-slave-pod
        containers:
          - name: main
            image: '805787217936.dkr.ecr.us-west-2.amazonaws.com/aba-jenkins-slave:ecs-global-node_master_57'
            # 替换sleep命令为JNLP连接指令
            args: "${computer.jnlpmac} ${computer.name}"
            workingDir: "/home/jenkins/agent"
            privileged: true

这种配置下，main容器同时承担主从通信和任务执行的功能。

内容的提问来源于stack exchange，提问作者EilonA