码头工人

码头工人是一个用于在称为“容器”(或Docker容器)的隔离环境中运行应用程序的平台。像Jenkins这样的应用程序可以作为只读“映像”(或Docker映像)下载,每个映像都作为容器在Docker中运行。Docker容器实际上是Docker映像的“运行实例”。从这必威国际有限公司个角度来看,图像或多或少是永久存储的(即,在发布图像更新的范围内),而容器是临时存储的。在Docker文档的入门,第1部分:方向和设置页面。

Docker的基础平台和容器设计意味着一个Docker映像(对于任何给定的应用程序,如Jenkins)可以在任何支持的操作系统(macOS, Linux和Windows)或云服务(AWS和Azure)上运行Docker。必威国际有限公司

安装Docker

要在您的操作系统上安装Docker,请遵循导游页面

作为替代解决方案,您可以访问Dockerhub并选择码头工人社区版适合您的操作系统或云服务。按照其网站上的安装说明进行操作。

如果您在基于linux的操作系统上安装Docker,请确保您配置了Docker,使其可以作为非root用户进行管理。更多信息请阅读Docker 'sLinux的安装后步骤他们的文件页。这个页面还包含了关于如何配置Docker在引导时启动的信息。

先决条件

最低硬件要求:

  • 256mb内存

  • 1 GB的驱动器空间(如果将Jenkins作为Docker容器运行,建议最小容量为10 GB)必威国际有限公司

小型团队的推荐硬件配置:

  • 4gb +内存

  • 50gb以上的驱动器空间

全面的硬件建议:

软件要求:

下载并运行Docker中的Jenkins必威国际有限公司

有几张Jenkins的Docker图像可用。必威国际有限公司

推荐使用的Docker镜像是官方的必威国际有限公司詹金斯/詹金斯图像(来自Docker中心存储库).此图像包含当前Jenkins的长期支持(LTS)版本必威国际有限公司(已经)。但是这个图片里面没有docker CLI,也没有和常用的Blue Ocean插件和特性绑定。这意味着,如果你想使用Jenkins和Docker的全部功能,你可能需要通过下面描述的安装过程。必威国际有限公司

一个新的必威国际有限公司詹金斯/詹金斯每次Jenkins Docker的新版本发布时,都会发布图片。必威国际有限公司可以看到以前发布的版本的列表必威国际有限公司詹金斯/詹金斯图片上的标签页面。

在macOS和Linux上

  1. 打开终端窗口。

  2. 创建一个桥接网络在Docker中使用以下命令码头工人网络创建命令:

    docker网络创建jenkins必威国际有限公司
  3. 要在Jenkins节点内执行Docker命令,请下载并运行必威国际有限公司码头工人:dindDocker映像使用如下码头工人运行命令:

    Docker run \——name j必威国际有限公司enkins-docker \(1)——rm \(2)--分离\(3)——特权\(4)——网络詹金斯\必威国际有限公司(5)——network-alias码头工人\(6)- - - env DOCKER_TLS_CERTDIR = /组\(7)——体积jenki必威国际有限公司ns-docker-certs: /证书/客户端\(8)——体积jenki必威国际有限公司ns-data: / var / jenkins_home \(9)——发布2376:2376 \(10)码头工人:丁\(11)——存储驱动overlay2(12)
    1 可选)指定运行镜像时使用的Docker容器名。默认情况下,Docker将为容器生成一个唯一的名称。
    2 可选当Docker容器被关闭时,自动删除Docker容器(Docker映像的实例)。
    3. 可选)在后台运行Docker容器。这个实例可以稍后通过运行来停止docker停下jenk必威国际有限公司ins docker
    4 目前在Docker中运行Docker需要特权访问才能正常运行。新的Linux内核版本可能会放宽这一要求。
    5 这与前面步骤中创建的网络相对应。
    6 使Docker容器中的Docker可用作主机名码头工人必威国际有限公司网络。
    7 启用在Docker服务器中使用TLS。由于使用了特权容器,建议这样做,尽管它需要使用下面描述的共享卷。此环境变量控制管理Docker TLS证书的根目录。
    8 地图的确实的事情/客户端目录存放到一个Docker卷中必威国际有限公司jenkins-docker-certs正如上面创建的。
    9 地图的/var/必威国际有限公司詹金斯之家酒店命名为Docker的卷必威国际有限公司jenkins-data.这将允许由该Docker容器的Docker守护进程控制的其他Docker容器装入来自Jenkins的数据。必威国际有限公司
    10 可选)在主机上公开Docker守护进程端口。这对执行很有用码头工人用于控制Docker内部守护进程的命令。
    11 码头工人:dind图像本身。该映像可以在运行之前使用命令下载:Docker镜像pull Docker:dind
    12 Docker卷的存储驱动程序。看到“码头工人存储驱动程序”获取支持的选项。

    注意:如果复制和粘贴上面的命令片段不起作用,请在这里尝试复制和粘贴这个没有注释的版本:

    docker run--名称jenk必威国际有限公司ins docker--rm--分离\--特权--网络jenkins--网络别名docker \--环境docker_TLS_CERTDIR=/certs \--卷jenkins docker certs:/certs/client \--卷jenkins data:/var/jenkins_home \--发布2376:2376 docker:dind--存储驱动程序覆盖2
  4. 定制官方Jenkins Docker图必威国际有限公司像,执行以下两个步骤:

    1. 创建Dockerfile,内容如下:

      从詹金斯/必威国际有限公司 jenkins: 2.303.1-jdk11用户root运行apt-get更新& & apt-get安装- y apt-transport-https \ ca证书curl gnupg2 \ software-properties-common运行curl https://download.docker.com/linux/debian/gpg -fsSL | apt-key添加- apt-key指纹0 ebfcd88跑add-apt-repository \“deb[拱= amd64]https://download.docker.com/linux/debian \ $(lsb_release -cs) stable"运行apt-get update && apt-get install -y docker-ce-cli USER jen必威国际有限公司kins运行jenkins-plugin-cli——plugins "blueocean:1.24.7 docker-workflow:1.26"
    2. 从这个Dockerfile构建一个新的docker映像,并为映像指定一个有意义的名称,例如:“my必威国际有限公司jenkins-blueocean: 1.1”:

      Docker build -t my必威国际有限公司jenkins-blueocean:1.1。

      请记住,如果之前没有这样做过,上面描述的过程将自动下载官方Jenkins Docker图像。必威国际有限公司

  5. 经营自己的my必威国际有限公司jenkins-blueocean: 1.1使用以下命令在Docker中将图像作为容器码头工人运行命令:

    Docker run \——名字jenk必威国际有限公司ins-blueocean \(1)——rm \(2)--分离\(3)——网络詹金斯\必威国际有限公司(4)--环境DOCKER_主机=tcp://docker:2376 \(5)——env DOCKER_CERT_PATH=/certs/client \——env DOCKER_TLS_VERIFY=1 \——publish 8080:8080 \(6)——发布50000:50000 \(7)——体积jenki必威国际有限公司ns-data: / var / jenkins_home \(8)——体积jenki必威国际有限公司ns-docker-certs: /证书/客户:ro \(9)my必威国际有限公司jenkins-blueocean: 1.1(10)
    1 可选指定Docker映像实例的Docker容器名。
    2 可选当Docker容器关闭时,会自动删除它。
    3. 可选)在后台运行当前容器(例如:"detached"模式)并输出容器ID。如果不指定此选项,则在终端窗口中输出该容器的运行Docker日志。
    4 将此容器连接到必威国际有限公司在前面步骤中定义的网络。这使得上一步中的Docker守护进程可以通过主机名访问Jenkins容器必威国际有限公司码头工人
    5 指定所使用的环境变量码头工人docker compose,以及其他Docker工具连接到Docker守护进程。
    6 (即地图。"发布")当前容器的8080端口到主机上的8080端口。第一个数字表示主机上的端口,最后一个数字表示容器的端口。因此,如果您指定- p 49000:8080对于这个选项,您将通过端口49000访问主机上的Jenkins。必威国际有限公司
    7 可选将当前容器的50000端口映射到主机的50000端口。只有当您在其他机器上设置了一个或多个入站Jenkins代理,这些代理又与您的服务器交互时,才有必要这样做必威国际有限公司必威国际有限公司詹金斯蓝海酒店容器(Jenkins“控制器”必威国际有限公司)。缺省情况下,入站必威国际有限公司Jenkins代理通过TCP端口50000与Jenkins控制器通信。你可以在Jenkins控制器上修改这个端口号必威国际有限公司配置全局安全性页面。如果你要改变入站Jenkins代理的TCP端口必威国际有限公司例如,你需要重新必威国际有限公司运行Jenkins控制器码头工人跑……命令)并指定这个“发布”选项——发布52000:51000,其中最后一个值与Jenkins控制器上的更改值相匹配,第一个值是托管Jenkins控制器的机器上的端口号。必威国际有限公司入站Jenkin必威国际有限公司s代理与该端口上的Jenkins控制器通信(本例中为52000)。请注意,WebSocket代理不需要此配置。
    8 地图的/var/必威国际有限公司詹金斯之家酒店目录到Docker体积用这个名字必威国际有限公司jenkins-data.而不是映射/var/必威国际有限公司詹金斯之家酒店目录到Docker卷,您也可以将此目录映射到您机器的本地文件系统上的一个目录。例如,指定选项
    ——卷$ HOME / jen必威国际有限公司kins: / var / jenkins_home会映射出集装箱的位置吗/var/必威国际有限公司詹金斯之家酒店目录的必威国际有限公司目录中的子目录$ HOME目录,它通常是/用户/ <用户名> / jenkins必威国际有限公司/home//必威国际有限公司jenkins.请注意,如果为此更改源卷或目录,则码头工人:dind上面的容器需要更新以匹配此。
    9 地图的确实的事情/客户端目录到先前创建的目录必威国际有限公司jenkins-docker-certs音量。这使得连接到Docker守护程序所需的客户端TLS证书可以在DOCKER_CERT_PATH环境变量。
    10 在上一步中构建的Docker映像的名称。

    注意:如果复制和粘贴上面的命令片段不起作用,请在这里尝试复制和粘贴这个没有注释的版本:

    码头工人运行——名字jenkins-必威国际有限公司blueocean——rm——分离\——网络詹金斯env DOCKER_HOST = tcp: / /码头工人:2376 \ - env DOCKER_CERT_PATH = /证书/客户——env DOCKER_TLS_VERIFY = 1 \发布8080:8080——发布50000:50000 \卷jenkins-data: / var / jenkins_home \——卷jenkins-docker-certs: /证书/客户:ro \ myjenkins-blueocean: 1.1
  6. 前往安装后的设置向导

在Windows上

Jenk必威国际有限公司ins项目提供了一个Linux容器映像,而不是Windows容器映像。请确保Docker for Windows安装配置为运行Linux容器而不是Windows的容器.请参阅Docker文档,了解如何执行切换到Linux容器.一旦配置为运行Linux容器,步骤如下:

  1. 打开命令提示符窗口,类似于macOS和Linux以上说明可以做到以下几点:

  2. 在Docker中创建网桥网络

    docker网络创建jenkins必威国际有限公司
  3. 运行docker:dind docker映像

    执行命令——name jenkins必威国际有限公司-docker——rm——detach ^——privileged——network jenkins——network-alias docker ^——env DOCKER_TLS_CERTDIR=/certs ^——volume jenkins-docker-certs:/certs/client ^——volume jenkins-data:/var/jenkins_home ^ docker:dind
  4. 定制官方Jenkins Docker图必威国际有限公司像,执行以下两个步骤:

    1. 创建Dockerfile,内容如下:

      从詹金斯/必威国际有限公司 jenkins: 2.303.1-jdk11用户root运行apt-get更新& & apt-get安装- y apt-transport-https \ ca证书curl gnupg2 \ software-properties-common运行curl https://download.docker.com/linux/debian/gpg -fsSL | apt-key添加- apt-key指纹0 ebfcd88跑add-apt-repository \“deb[拱= amd64]https://download.docker.com/linux/debian \ $(lsb_release -cs) stable"运行apt-get update && apt-get install -y docker-ce-cli USER jen必威国际有限公司kins运行jenkins-plugin-cli——plugins "blueocean:1.24.7 docker-workflow:1.26"
    2. 从这个Dockerfile构建一个新的docker映像,并为映像指定一个有意义的名称,例如:“my必威国际有限公司jenkins-blueocean: 1.1”:

      Docker build -t my必威国际有限公司jenkins-blueocean:1.1。

      请记住,如果之前没有这样做过,上面描述的过程将自动下载官方Jenkins Docker图像。必威国际有限公司

  5. 经营自己的my必威国际有限公司jenkins-blueocean: 1.1使用以下命令在Docker中将图像作为容器码头工人运行命令:

    码头工人运行——名字jenkins-必威国际有限公司blueocean——rm——分离^——网络詹金斯env DOCKER_HOST = tcp: / /码头工人:2376 ^ - env DOCKER_CERT_PATH = /证书/客户端- env DOCKER_TLS_VERIFY = 1 ^ -卷jenkins-data: / var / jenkins_home ^——卷jenkins-docker-certs: /证书/客户:ro ^——发布8080:8080发布50000:50000 myjenkins-blueocean: 1.1
  6. 前往安装向导

访问Docker容器

如果您有使用Docker的一些经验,并且希望或需要通过终端/命令提示符使用码头工人执行命令,您可以添加类似的选项——名字jen必威国际有限公司kins-tutorial码头工人执行指挥部。这将访问名为“Jenkins教程”的Jenkins 必威国际有限公司Docker容器。

这意味着你可以通过一个单独的终端/命令提示符窗口访问docker容器码头工人执行命令:

Docker执行- jenkin必威国际有限公司s-blueocean bash

访问Docker日志

您可能需要访问Jenkins控制台日志,例如,当必威国际有限公司解锁詹金斯必威国际有限公司作为安装后的设置向导

通过终端必威国际有限公司/命令提示符窗口可以很容易地访问Jenkins控制台日志码头工人跑……命令。如果需要,您还可以通过必威国际有限公司码头工人日志使用下面的命令查看容器:

码头工人日志< docker-container-name >

你的可以使用码头工人ps命令。

正在访问Jenkins主目录必威国际有限公司

例如,您可能需要访问Jenkins主目录,以便在中检查Jenkins构建的详细信息必威国际有限公司工作空间子目录。

如果您映射Jenkins主目录(必威国际有限公司/var/必威国际有限公司詹金斯之家酒店)到计算机本地文件系统上的一个(即码头工人跑……命令以上),然后可以通过计算机常用的终端/命令提示符访问该目录的内容。

否则,如果指定——体积jenki必威国际有限公司ns-data: / var / jenkins_home选项码头工人跑……命令,则可以通过容器的终端/命令提示符使用必威国际有限公司docker容器执行器命令:

< Docker -container-name> bash

正如前面提到的以上,你的可以使用码头工人容器ls命令。如果您指定
--名字叫詹金必威国际有限公司斯蓝海选项Docker容器运行…上面的命令(也请参阅进入Jenkins/Blue必威国际有限公司 Ocean Docker容器),您可以简单地使用docker容器执行器命令:

Docker容器执行- jenkins-blueoc必威国际有限公司ean bash

安装后的设置向导

下载、安装和运行Jenkins后,使用上面的一个过程,安装后安装向导就开始了。必威国际有限公司

此安装向导将引导您完成几个快速的“一次性”步骤,以解锁Jenkins,使用插件对其进行自定义,并创建第一个管理员用户,您可以通过该用户继续访问Jen必威国际有限公司kins。

解锁詹金斯必威国际有限公司

当您第一次访问一个新的Jenkins实例时,系统会要求您必威国际有限公司使用一个自动生成的密码来解锁它。

  1. 浏览到http://localhost:8080(或安装时为Jenkins配置的任何端口)并等待必威国际有限公司解锁詹金斯必威国际有限公司页面出现。

    解锁詹金斯页面必威国际有限公司

  2. 从Jenkins控必威国际有限公司制台日志输出中,复制自动生成的字母数字密码(在两组星号之间)。

    复制初始管理员密码
    注意:

    • 命令:sudo cat/var/lib/j必威国际有限公司enkins/secrets/initialAdminPassword将在控制台打印密码。

    • 如果你在Docker用官方的必威国际有限公司必威国际有限公司詹金斯/詹金斯您可以使用的图像sudo docker exec${CONTAINER\u ID或CONTAINER\u NAME}cat/var/je必威国际有限公司nkins\u home/secrets/initialAdminPassword在控制台中打印密码,而不必执行到容器中。

  3. 解锁詹金斯必威国际有限公司页,将此密码粘贴到管理员密码字段并单击继续
    注:

    • 你可以从Docker日志(必威国际有限公司以上).

    • Jenk必威国际有限公司ins控制台日志指示了这个密码也可以获得的位置(在Jenkins主目录中)。必须在新安装Jenkins的安装向导中输入此密码,才能访问Jenkins的主UI。必威国际有限公司如果您在设置向导中跳过后续的用户创建步骤,这个密码也可以作为默认管理员帐户的密码(用户名为“admin”)。

使用插件定制Jenkin必威国际有限公司s

解锁詹金斯必威国际有限公司,定制詹金斯必威国际有限公司页面出现。在这里,您可以安装任意数量的有用插件,作为初始设置的一部分。

点击下面两个选项中的一个:

  • 建议安装插件-安装推荐的插件集,这些插件基于最常见的用例。

  • 选择要安装的插件-选择最初安装哪一组插件。当您第一次访问插件选择页面时,默认情况下会选择建议的插件。

如果你不确定你需要什么插件,选择建议安装插件.您可以安装(或删除)额外的Jenkins插件在以后的时间点通过必威国际有限公司管理詹金斯必威国际有限公司>管理插件詹金斯。必威国际有限公司

安装向导显示Jenkins正在配置的进程和您选择的Jenkins插件正在安装。必威国际有限公司这个过程可能需要几分钟。

创建第一个管理员用户

最后,经过使用插件定制Jenkin必威国际有限公司s, 必威国际有限公司Jenkins要求您创建您的第一个管理员用户。

  1. 创建第一个管理员用户页面,在相应字段中指定管理员用户的详细信息,然后单击保存并完成

  2. 必威国际有限公司詹金斯已经准备好了页面出现时,单击开始使用詹金斯必威国际有限公司
    注:

    • 本页可能显示必威国际有限公司詹金斯快准备好了!如果是,请单击重新启动

    • 如果一分钟后页面没有自动刷新,请使用浏览器手动刷新页面。

  3. 如果需要,用您刚刚创建的用户的凭据登录到Jen必威国际有限公司kins,您就可以开始使用Jenkins了!



这个页面有用吗?

请通过此网站提交您对此页面的反馈快速表格

或者,如果您不希望完成快速表单,您可以简单地指出,如果您觉得这个页面有帮助?


查看现有反馈在这里