jenkins文档用户操作手册（中文版）2019(下).pdf资源-CSDN下载

需积分: 50 105 浏览量 2019-07-11 10:22:38 上传评论 1 收藏 4.55MB PDF 举报

资源推荐

资源详情

资源评论

用户手册概述   
本页提供Jenkins用户手册文档概述
如果您是初次使用Jenkins，请参阅 安装Jenkins 以了解如何在支持的平台上安装Jenkins
如果您已经是Jenkins用户 (任何技能水平) 想要进一步了解Jenkins的使用, 请参阅 使用 Jenkins. 或者参阅Pipeline
和 Blue Ocean 独立章节以获取关于Jenkins核心特性的更多信息
如果您是Jenkins管理员，想要了解有关管理Jenkins节点和实例的更多信息，请参阅 管理 Jenkins.
如果您是系统管理员，想要了解如何备份、恢复和维护Jenkins服务器和节点，请参阅 Jenkins 系统管理.
安装Jenkins   
Table of Contents
系统要求
安装平台
Docker
安装Docker
在Docker中下载并运行Jenkins
在macOS和Linux上
在Windows上
访问Jenkins / Blue Ocean Docker容器
通过Docker日志访问Jenkins控制台日志
访问Jenkins主目录
WAR文件
苹果系统
Linux
Debian/Ubuntu
Windows
其他操作系统
OpenIndiana Hipster
Solaris, OmniOS, SmartOS, and other siblings
安装后设置向导
解锁 Jenkins
自定义jenkins插件
创建第一个管理员用户
本节的步骤适用于单个/本地机器上的Jenkins新安装。
Jenkins通常作为一个独立的应用程序在其自己的流程中运行， 内置Java servlet 容器/应用程序服务器（Jetty）。

Jenkins也可以运行在不同的Java servlet容器(（如Apache Tomcat 或 GlassFish）)中作为servlet运行.但是设置这
些类型的安装的说明超出了本页的范围
注
意
:尽管此页面重点关注Jenkins的本地安装，但此内容也可用于帮助在生产环境中设置Jenkins。
系统要求  
最低推荐配置:
256MB可用内存
1GB可用磁盘空间(作为一个Docker容器运行jenkins的话推荐10GB)
为小团队推荐的硬件配置:
1GB+可用内存
50 GB+ 可用磁盘空间
软件配置:
Java 8—无论是Java运行时环境（JRE）还是Java开发工具包（JDK）都可以。
注意: 如果将Jenkins作为Docker 容器运行，这不是必需的
安装平台  
本节介绍如何在不同的平台和操作系统上安装/运行Jenkins。
Docker  
Docker是一个在称为“容器”（或Docker容器）的孤立环境中可运行应用程序的平台。 像Jenkins这样的应用程序可
以作为只读的“镜像”（或Docker镜像）下载， 每个镜像都作为容器在Docker中运行。Docker容器实际上是Docker
镜像的“运行实例”。 从这个角度来看，镜像永久存储（只要镜像更新发布），而容器暂时存储。 在Docker文档的
入门指南，Getting Started, Part 1: Orientation and setup页面中阅读有关这些概念的更多信息 。
Docker的基础平台和容器设计意味着可以在任何支持的操作系统（macOS，Linux和Windows） 或云服务（AWS
和Azure）上运行单个Docker镜像（对于任何给定的应用程序，如Jenkins）。
安装Docker  
要在您的操作系统上安装Docker，请访问 Docker store网站并单击适用于您的操作系统或云服务的Docker
Community Edition框。 按照其网站上的安装说明进行操作。
Jenkins也可以在Docker企业版上运行，您可以通过 Docker商店网站上的Docker EE访问它。
[ CAUTION]
如果您要在基于Linux的操作系统上安装Docker，请确保配置Docker，以便它可以作为非root用户进行管理。 在
Docker的Post-installation steps for Linux网页中了解更多关于它 的文档。 如何将Docker配置为默认启动的方式
也可在此文档中查找。
在Docker中下载并运行Jenkins  
几个可用的Jenkins Docker镜像.

（可选） jenkinsci/blueocean 关闭时自动删除Docker容器（下图为实例）。如果您需要退出

Jenkins，这可以保持整洁。

（可选） jenkinsci/blueocean 在后台运行容器（即“分离”模式）并输出容器ID。如果您不指定

此选项，则在终端窗口中输出正在运行的此容器的Docker日志。

映射（例如“发布”） jenkinsci/blueocean 容器的端口8080到主机上的端口8080。第一个数字

代表主机上的端口，而最后一个代表容器的端口。因此，如果您为此选项指定 -p 49000:8080

，您将通过端口49000访问主机上的Jenkins。

（可选）将 jenkinsci/blueocean 容器的端口50000 映射到主机上的端口50000。如果您在其

他机器上设置了一个或多个基于JNLP的Jenkins代理程序，而这些代理程序又与

jenkinsci/blueocean 容器交互（充当“主”Jenkins服务器，或者简称为“Jenkins主”），则这是

必需的。默认情况下，基于JNLP的Jenkins代理通过TCP端口50000与Jenkins主站进行通信。您

可以通过“ 配置全局安全性” 页面更改Jenkins主服务器上的端口号。如果您要将您的Jenkins主机

的JNLP代理端口的TCP端口值更改为51000（例如），那么您需要重新运行Jenkins（通过此

docker run …命令）并指定此“发布”选项 -p 52000:51000，其中最后一个值与Jenkins master上

的这个更改值相匹配，第一个值是Jenkins主机的主机上的端口号，通过它，基于JNLP的Jenkins

代理与Jenkins主机进行通信 - 例如52000。

（可选，但强烈建议）映射在容器中的 /var/jenkins_home 目录到具有名字 jenkins-data 的

volume。如果这个卷不存在，那么这个 docker run 命令会自动为你创建卷。如果您希望每次

重新启动Jenkins（通过此 docker run ... 命令）时保持Jenkins状态，则此选项是必需的。如

果你没有指定这个选项，那么在每次重新启动后，Jenkins将有效地重置为新的实例。注意: 所述

的 jenkins-data 卷也可以 docker volume create 命令创建： docker volume create

jenkins-data 代替映射 /var/jenkins_home 目录转换为Docker卷，还可以将此目录映射到计

算机本地文件系统上的目录。例如，指定该选项 -v $HOME/jenkins:/var/jenkins_home 会将容

器的 /var/jenkins_home 目录映射到本地计算机上目录中的 jenkins 子目录，该$HOME目

录通常是 /Users/<your-username>/jenkins 或 /home/<your-username>/jenkins 。

（可选 /var/run/docker.sock 表示Docker守护程序通过其监听的基于Unix的套接字。该映射

允许 jenkinsci/blueocean 容器与Docker守护进程通信，如果 jenkinsci/blueocean 容器需

要实例化其他Docker容器，则该守护进程是必需的。如果运行声明式管道，其语法包含 agent

部分用 docker 例如， agent { docker { ... } } 此选项是必需的。在Pipeline Syntax 页面

上阅读更多关于这个的信息。

jenkinsci/blueocean Docker镜像本身。如果此镜像尚未下载，则此 docker run 命令将自动

为您下载镜像。此外，如果自上次运行此命令后发布了此镜像的任何更新，则再次运行此命令将

自动为您下载这些已发布的镜像更新。注意：这个Docker镜像也可以使用以下 docker pull 命

令独立下载（或更新）： docker pull jenkinsci/blueocean 注意: 如果复制并粘贴上面的命令

片段不起作用，请尝试在此处复制并粘贴此无注释版本： docker run \ -u root \ --rm \

-d \ -p 8080:8080 \ -p 50000:50000 \ -v jenkins-data:/var/jenkins_home \ -v

/var/run/docker.sock:/var/run/docker.sock \ jenkinsci/blueocean

3. 继续按照Post-installation setup wizard安装。

在Windows上

1. 打开命令提示符窗口。

2. 下载  jenkinsci/blueocean  镜像并使用以下  docker run  命令将其作为Docker中的容器运行 ：
 
有关这些选项的解释，请参阅上面的在macOS和Linux上。
3. 继续按照Post-installation setup wizard安装。
访问Jenkins / Blue Ocean Docker容器  
如果您对Docker有一些经验，并且您希望或需要  jenkinsci/blueocean  通过 命令提示符通过终端/命令提示符访
问 docker exec  ，则可以添加一个选项  --name jenkins-blueocean （如  docker run  所述）,这会为
jenkinsci/blueocean  容器命名为 "jenkins-blueocean" 。
这意味着你可以使用如下命令访问容器（通过单独的终端/命令提示符窗口） ：
docker exec -it jenkins-blueocean bash
通过Docker日志访问Jenkins控制台日志  
您可能需要访问Jenkins控制台日志。例如，在解锁 Jenkins 作为安装后设置向导的一部分时。
如果没有指定分离模式选项  -d  与  docker run ...  命令以上， 那么Jenkins控制台日志是通过终端方便/命令从中
运行此Docker命令提示符窗口。
否则，您可以通过访问Jenkins控制台日志 Docker logs中 的  jenkinsci/blueocean  ，使用以下命令：
docker logs <docker-container-name>
Your  <docker-container-name>  can be obtained using the  docker ps  command. If you speciﬁed the  --name
jenkins-blueocean  option in the  docker run ...  command above (see also Accessing the Jenkins/Blue
Ocean Docker container), you can simply use the  docker logs  command:
您的  <docker-container-name>  可以使用 docker ps  命令获得 。如果您在上述  docker run ... 命令中指定了  --
name jenkins-blueocean  参数(请参阅访问Jenkins/Blue Ocean Docker容器) ，则只需使用以下  docker logs  命
令：
docker logs jenkins-blueocean
访问Jenkins主目录  
例如，您可能需要访问Jenkins主目录，以查看  workspace  子目录中Jenkins版本的详细信息。
如果您将Jenkins主目录（  /var/jenkins_home  ）映射到您计算机 本地文件系统上的一个目录（如上面的  docker
run ...  命令 ）， 那么您可以通过计算机常用的终端/命令提示符访问此目录的内容。
否则，如果您在  docker run ...  命令里指定了  -v jenkins-data:/var/jenkins_home  选项， 则可以
jenkinsci/blueocean  使用以下  docker exec  命令通过容器的终端/命令提示符访问Jenkins主目录的内容：
docker run ^
  -u root ^
  --rm ^
  -d ^
  -p 8080:8080 ^
  -p 50000:50000 ^
  -v jenkins-data:/var/jenkins_home ^
  -v /var/run/docker.sock:/var/run/docker.sock ^
  jenkinsci/blueocean