如何使用Jenkins声明性管道在远程Docker服务器上构建？

Question

我在詹金斯内部写了一个声明性管道。此管道应在远程Docker服务器上的Docker容器中运行。

我阅读了自定义执行环境：

自定义执行环境

Pipeline的设计可以轻松地将Docker映像用作单个阶段或整个管道的执行环境。这意味着用户可以定义其管道所需的工具，而无需手动配置代理。实际上，任何可以打包在Docker容器中的工具。只需对Jenkins文件进行少量编辑即可轻松使用。

pipeline {
    agent {
        docker { image 'node:7-alpine' }
    }
    stages {
        stage('Test') {
            steps {
                sh 'node --version'
            }
        }
    }
}

它工作，但它使用詹金斯服务器作为Docker服务器。

我使用远程Docker服务器阅读：

使用远程Docker服务器

默认情况下，Docker管道插件将与本地Docker守护进程通信，通常通过/var/run/Docker访问。短袜

要选择非默认Docker服务器，例如使用Docker Swarm，应使用withServer（）方法。

通过将URI和在Jenkins中预先配置的Docker服务器证书身份验证的凭据ID（可选）传递给具有以下内容的方法：

node {
    checkout scm

    docker.withServer('tcp://swarm.example.com:2376', 'swarm-certs') {
        docker.image('mysql:5').withRun('-p 3306:3306') {
            /* do things */
        }
    }
}

这是可行的，但它使用脚本化管道。

我还阅读了指定Docker标签：

指定Docker标签

默认情况下，管道假定任何配置的代理都能够运行基于Docker的管道。对于具有macOS、Windows或其他无法运行Docker守护程序的代理的Jenkins环境，此默认设置可能有问题。管道在Manage Jenkins页面和文件夹级别提供了一个全局选项，用于指定运行基于Docker的管道所使用的代理（按标签）。

但是使用一个标签需要一个完整的Jenkins从机和一个安装了sshd的Jenkins用户，一直在线，Jenkins的主机将安装从机库。仅仅使用声明性管道而不是脚本化管道听起来有点沉重。

如何在具有声明性管道的远程Docker服务器上构建？

Answer 1

您不需要“完整的Jenkins从机”——您只需要一台运行Docker并通过TCP/TLS和x509客户端身份验证为Docker套接字提供服务的机器；不要提供未经验证和未加密的服务，否则您将在您的安全外围打开一个星球大小的漏洞（这是学习openssl的机会！）

对于声明性，您可以在代理标记内使用“节点”，并使用标签关联的docker容器（包含Jenkins需要的所有内容）配置模板。

pipeline {
    agent {
        node {
            label 'docker-agent'
        }
    }
    ...

您需要挂载docker套接字（以及您的代理工作区），否则您将无法从代理容器中执行很多操作。

Answer 2

我想你在这里混的东西很少。关于代理的文档部分，代理部分用于标识阶段应该运行的节点，以及特殊配置和信息。

Docker标记依次提供了应该从图像内部运行的信息。

这不会给您留下任何连接到外部docker服务器的空间，除非您将其设置为带有一些特殊标签的Jenkins节点，例如“docker special”。然后你可以做一些简单的事情

agent {
    docker {
        image 'maven:3-alpine'
        label 'docker-special'
    }
}

Docker标签上的文档部分

码头工人

使用给定容器执行管道或阶段，该容器将在预先配置为接受基于Docker的管道的节点上或在与可选定义的label参数匹配的节点上动态配置。

至于您的特定用例。

詹金斯留档的这一部分提到了侧车模式/高级用法，他们立即切换到脚本。

所以是的，正如我提到的，这在声明性中是不可用的。声明式的唯一出路是将外部服务器标记为带有特定标签的詹金斯节点。