jenkins用户手册-7-开始使用jenkins

开始使用jenkins

 

这一章（用户手册）是为不熟悉jenkins的人和没有使用最新jenkins版本经验的人准备的。

这一章将引导你通过在系统上安装一个jenkins实例来学习和理解jenkins的概念。这章将会提供一个例子来一步一步指导你如何完成一系列通用任务。每个部分都要按顺序完成，每一节都要根据前一节的知识进行。当你照着做完了，你将会获得核心jenkins足够的经验，继而自己探索。

 

如果你已经熟悉jenkins基础，想探究如何更深地使用高级特性，请查看《使用jenkins》章节。

如果你是jenkins的管理员，想知道关于管理jenkins节点和实例的更多的知识，请查看《管理jenkins》章节。

如果你是系统管理员，想学习如何备份，恢复，维护jenkins服务器和节点，请查看《操作jenkins》章节。

从这一章节我们开始使用jenkins。这一节提供了jenkins在一些平台上的基本配置的指导。这没有覆盖所有考虑到的情形，也没有覆盖安装jenkins的所有选项。查看《安装jenkins高级》

 

安装jenkins

概述

 

预安装

 

系统要求

这些都是基本要求，想要充分讨论这些因素，请参考硬件建议的讨论。

 

最低的推荐配置：

Java8（jre或者jdk）

256m空闲内存

1G+ 空闲硬盘空间

 

小型团队的推荐配置

Java8

1G + 空闲内存

50G+ 空闲硬盘空间

 

 

实验，演示还是成品？

怎么配置jenkins会根据不同用例的目的有显著不同。这一章节特别针对首次使用和实验。其他场景，请看《jenkins高级安装》

 

独立还是servlet?

Jenkins可以独立运行在自己的程序上，使用自己构建的web服务器（jetty）.它可也可以运行在已经存在的框架的servlet中，例如tomcat或glassfish应用服务器。这一部分主要针对独立安装和运行。其他场景，请查看《kenkins高级安装》

 

安装

这些是针对非生产环境的干净的安装指导。如果你有一个非生产环境，kenkins服务器已经运行在其上，并且想要升级，参考《升级jenkins》。如果你正在安装或者升级一个jenkins服务器的生产环境，参考《jenkins高级安装》

Unix、Linux、debian/Ubuntu

在基于debian的分布式操作系统，例如ununtu，你可以通过apt命令安装jenkins。

最新的版本可以从apt库中获取.老的稳定LTS版本可以从这个库中获取-https://pkg.jenkins.io/debian-stable/。

 

wget -q -O - https://pkg.jenkins.io/debian/jenkins.io.key| sudo apt-key add -

sudo sh -c 'echo deb http://pkg.jenkins.io/debian-stablebinary/ > /etc/apt/sources.list.d/jenkins.list'

sudo apt-get update

sudo apt-get install Jenkins

 

这个安装包将会：

设置Jenkins作为启动的守护进程。参考 /etc/init.d/Jenkins获取更多详细信息。

创建一个jenkins用户来运行这个服务。

管理控制台日志输出到/var/long/jenkins/jenkins.log文件中。如果你启动jenkins遇到麻烦，可以查看这个文件。

用植入到/etc/default/Jenkins里的配置参数来启动。例如：JENKINS_HOME.

设置jenkins监听端口号为8080.用浏览器访问这个端口号来启动配置。

 

   //**TODO**

如果你的/etc/init.d/jenkins文件启动jenkins失败，编辑/etc/default/jenkins用----HTTP_PORT=8081来替代这行–

----HTTP_PORT=8080---- 这里的“8081”是可选的，但是你必须设置另外一个可用的端口号。

**TODO**//

 

OpenIndianaHipster

在系统上运行OpenIndianaHipster jenkins可以安装在本地或者使用系统镜像包（IPS）的全局区域。

//**TODO**

免责声明：这个平台不被jenkins团队官方支持，使用它自己承担风险。本部分描述的包装和集成由OpenIndiana Hipster团队维护。捆绑通用的jenkins.war来在那个系统环境中工作。

 

独立的(Jetty)服务器每周运行最新的打包构建的普通情况，只需执行:

        pkg installjenkins

svcadm enable Jenkins

 

独立服务器的常见的包装集成将：

。创建一个jenkins用户来运行服务并拥有/var/lib/jenkins目录结构下的目录。

。拉取open jdk8和其他运行jenkins需要的包，包括jenkins-core-weekly包，包括最新的jenkins.war

     最近发布的长周期支持（LTS）的jenkins版本不支持基于OpenZFS的系统，所以这次不支持打包。

。设置jenkins作为一个SMF服务实例（svc:/network/http:jenkins）然后可以使用上面演示的svcadm命令启用它。

。设置jenkins监听8080端口

。将被SMF管理的日志输出配置在/var/svc/log/network-http:jenkins.log

一旦jenkins开始运行，查阅日志（(/var/svc/log/network-http:jenkins.log）来检索生成的jenkins初始设置的管理员密码，通常这个密码存放在\var\lib\jenkins\home\secrets\initialAdminPassword文件中。然后导航到localhost:8080，以完成jenkins实例的配置。

 

改变服务参数，比如JENKINS_HOME等环境变量或者jenkins用到的jetty的端口号，使用svccfg工具

svccfg –s svc:/network/http:Jenkins editprop

svcadm refresh svc:/network/http:Jenkins

 

你也可以参考/lib/svc/manifest/network/Jenkins-standalone.xml获取更多细节和关于smf服务的可调项的最新支持。注意，包创建的kenkins用户账号拥有允许绑定小于1024的端口号的特殊权限。

给定的Openindiana版本中可用的与Jenkins相关联的包的状态，可以这么查询：

pkg info –r ‘*Jenkins*’

可以通过使用pkdupdate更新整个操作环境以执行包更新。或者使用下面的命令更新特定的jenkins核心软件：

pkg update Jenkins-core-weekly

 

!! 更新包程序将重启整在运行的jenkins。如果需要的话，应该在更新前确保jenkins工作（jobs）已经结束,并且 jenkins已经做好关闭前的准备。

 

Solaris, OmniOS, SmartOS,and 等同系的操作系统

一般说来，安装java8，下载kenkins.jar，并将其作为一个独立的进程运行在诸如apach，Tomcat等应用服务器中就足够了。

一些应用说明：

无头JVM和字体：对于在最小封装的系统上构建的OpenJDK，运行无头JVM可能存在问题，因为jenkins需要一些字体来渲染特定页面。

ZFS相关的JVM崩溃：当jenkins运行的操作系统被检测为是SunOS的时候，就会使用绑定的libzfs.jar尝试加载高级ZFS（一种文件系统）特性。映射从java的调用到本地主操作系统提供的libzfs.so的路由。然而，这个库是为构建二进制程序并绑定到操作系统而制作的，而不是为了向客户提供稳定的接口。作为Solaris一个分支的后续，包括ZFS和后来改进后的OpenZFS，不同的主操作系统提供了很多不同的二进制程序签名-当jenkins的libzfs.jar调用了错误的签名，整个JVM就会崩溃。从weekly release2.55版本（到目前为止LTS的都不行）之后，jenkins.war集合了一个建议的解决方案。这个解决方案允许管理员配置哪些功能签名应该用于每个已知的函数的变体，将其应用到它们的应用程序服务器初始化选项，然后运行并更新生成的jenkins.jar，没有进一步的解决方案。查看libzfs4J的git仓库（https://github.com/kohsuke/libzfs4j）获得更多细节，包括一个脚本，用于尝试和“锁定”您的特定发行版所需的配置（尤其当你的核心更新导致与libzfs.so的不兼容）。

 

也要注意，OpenZFS的分支可以提供在各种BSD,LINUX和macOS的发行版上的ZFS。一旦jenkins支持检测ZFS的功能，而不是依赖sunos的检测，上面的关于集成ZFS的应用说明就应该被考虑进去。

 

MacOS

 

从网站上下载安装，使用安装包：

下载最新版本的安装包：（https://mirrors.tuna.tsinghua.edu.cn/jenkins/osx/jenkins-2.75.pkg）

打开安装包并跟着安装提示做

Jenkins也可以使用brew：安装最新版本  brew install jenkins

 

                                                        安装LTS版本： brewinstall Jenkins-lts

 

 

             Windos

 

          从网站安装，使用安装器：

下载最新版本的安装包：（https://mirrors.tuna.tsinghua.edu.cn/jenkins/windows/jenkins-2.75.zip）

 

打开安装包并跟着安装提示做

 

Docker

您必须在机器上正确安装Docker.参考Docker安装向导获取细节。

首先，拉取Docker仓库的 官方镜像。

docker pull jenkins/Jenkins

然后，运行一个使用这个镜像的容器，映射数据目录到主机的容器。例如下面的例子 容器的/var/Jenkins_home被映射到主机当前路径的jenkins/目录。jenkins8080端口也暴露为主机的49001端口。

docker run –d –p 49001:8080 –v $PWD/jenkins：/var/jenkins_home–t Jenkins/jenkins

 

其他

查看《jenkins高级安装》

 

安装之后（安装向导）

为jenkins创建管理员用户账户和密码

Jenkins第一次启动的初始配置是安全的。没有用户名密码Jenkins不能够再被访问，并且打开端口也将被限制。jenkins第一次启动过程中，一个安全令牌会被创建并打印到控制台日志中。

Jenkins initial setup is required. A security token isrequired to proceed.

Please use the following security token to proceed toinstallation:

 

41d2b60b0e4cb5bf2025d33b21cb

*********************************************************************

 

上面所有的平台的安装指导的默认安装目录都可以从这个日志输出文件中找到。

这个令牌必须在第一次打开jenkins界面的时候再“setup wizard”里面输入。如果你在“setup wizard”时跳过了创建用户这一步，这个令牌也可以作为默认的用户名和密码使用。

 

最初的插件安装

安装向导也将会安装jenkins服务器的初始插件。可用的推荐插件集合是基于最常见的用例。您可以在安装向导中添加更多的内容，或者在需要的时候安装它们。