Jenkins 用户文档（使用Maven构建Java应用程序）

使用Maven构建Java应用程序

本教程向你展现如何使用Jenkins编排使用Maven构建简单的Java应用程序。

若是你是使用Maven且不熟悉CI/CD概念的Java开发人员，或者你可能熟悉这些概念但不知道如何使用Jenkins实现构建应用程序，那么本教程适合你。

简单的Java应用程序（你将从GitHub上的示例存储库获取）输出字符串“Hello world！”并附带一些单元测试，以检查主应用程序是否按预期工做，这些测试的结果将保存到JUnit XML报告中。

持续时间：本教程须要20-40分钟才能完成（假设你已经知足如下的前提条件），具体的持续时间取决于你的机器的速度以及你是否已经从另外一个教程中运行了Docker中的Jenkins。

你能够随时中止本教程，并从上次中止的地方继续。

若是你已经运行了另外一个教程，则能够跳过下面的前提条件和在Docker中运行Jenkins部分，而后继续分析示例存储库（确保你在本地安装了Git），若是你须要从新启动Jenkins，只需按照中止并从新启动Jenkins中的重启说明操做，而后继续。

前提条件

对于本教程，你将须要：

• macOS、Linux或Windows机器：

  • 256MB的RAM，但推荐超过512MB。
  • Jenkins以及Docker镜像和容器的10GB驱动器空间。

• 安装了如下软件：

  • Docker — 在安装Jenkins页面的安装Docker部分中阅读有关安装Docker的更多信息，注意：若是你使用Linux，本教程假定你没有以root用户身份运行Docker命令，而是使用单个用户账户访问本教程中使用的其余工具。
  • Git和可选的GitHub Desktop。

在Docker中运行Jenkins

在本教程中，你将从jenkinsci/blueocean Docker镜像中将Jenkins做为Docker容器运行。

要在Docker中运行Jenkins，请遵循下面针对macOS和Linux或Windows的相关说明。

你能够在安装Jenkins页面的Docker和在Docker中下载并运行Jenkins部分阅读有关Docker容器和镜像概念的更多信息。

在macOS和Linux上

1. 打开一个终端窗口。

2. 使用如下docker run命令将jenkinsci/blueocean镜像做为Docker中的容器运行（请记住，若是还没有执行此操做，此命令会自动下载镜像）：

   docker run \
    --rm \
    -u root \
    -p 8080:8080 \
    -v jenkins-data:/var/jenkins_home \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v "$HOME":/home \
    jenkinsci/blueocean

   • 将容器中的/var/jenkins_home目录映射到名为jenkins-data的Docker卷，若是此卷不存在，则此docker run命令将自动为你建立卷。
   • 将主机（即本地）计算机上的$HOME目录（一般是/Users/<your-username>目录）映射到容器中的/home目录。
3. 继续进行安装向导。

在Windows上

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

2. 使用如下docker run命令将jenkinsci/blueocean镜像做为Docker中的容器运行（请记住，若是还没有执行此操做，此命令会自动下载镜像）：

   docker run ^
    --rm ^
    -u root ^
    -p 8080:8080 ^
    -v jenkins-data:/var/jenkins_home ^
    -v /var/run/docker.sock:/var/run/docker.sock ^
    -v "%HOMEPATH%":/home ^
    jenkinsci/blueocean

   有关这些选项的说明，请参阅上面的macOS和Linux说明。

3. 继续进行安装向导。

访问Jenkins/Blue Ocean Docker容器

若是你有使用Docker的经验，并但愿或须要使用docker exec命令经过终端/命令提示符访问Jenkins/Blue Ocean Docker容器，你能够添加一个选项，如--name jenkins-tutorials（上面docker run命令），这将为Jenkins/Blue Ocean Docker容器命名为“jenkins-tutorials”。

这意味着你可使用docker exec命令访问Jenkins/Blue Ocean容器（经过单独的终端/命令提示符窗口），例如：

docker exec -it jenkins-tutorials bash

安装向导

在你访问Jenkins以前，你须要执行一些快速的“一次性”步骤。

解锁Jenkins

首次访问新的Jenkins实例时，系统会要求你使用自动生成的密码将其解锁。

1. 在终端/命令提示符窗口中出现2组星号后，浏览到http://localhost:8080并等待，直到出现解锁Jenkins页面。

   

2. 从终端/命令提示符窗口复制自动生成的字母数字密码（在两组星号之间）。

   

3. 在解锁Jenkins页面上，将此密码粘贴到管理员密码字段中，而后单击继续。

使用插件自定义Jenkins

解锁Jenkins后，将出现自定义Jenkins页面。

在此页面上，单击安装推荐的插件。

安装向导显示正在配置的Jenkins的进度以及正在安装的建议插件，此过程可能须要几分钟时间。

建立第一个管理员用户

最后，Jenkins要求你建立第一个管理员用户。

1. 出现建立第一个管理员用户页面时，在相应字段中指定你的详细信息，而后单击保存并完成。

2. 当Jenkins已就绪！页面出现时，单击开始使用Jenkins。

   • 这个页面可能代表Jenkins已经准备好了！相反，若是是，请单击重启。
   • 若是页面在一分钟后没有自动刷新，请使用Web浏览器手动刷新页面。
3. 若是须要，使用你刚刚建立的用户的凭据登陆Jenkins，你就能够开始使用Jenkins！

中止和从新启动Jenkins

在本教程的其他部分中，你能够经过在上面的运行docker run ...命令的终端/命令提示符窗口中键入Ctrl-C来中止Jenkins/Blue Ocean Docker容器。

要从新启动Jenkins/Blue Ocean Docker容器：

1. 运行与上面的macOS、Linux或Windows相同的docker run ...命令。注意：若是有更新的镜像，此过程还会更新jenkinsci/blueocean Docker镜像。
2. 浏览http://localhost:8080。
3. 等到登陆页面出现并登陆。

在GitHub上Fork并clone样本存储库

从GitHub获取简单的“Hello world!”Java应用程序，经过将应用程序源代码的示例存储库fork到你本身的GitHub账户，而后克隆此fork到本地。

1. 确保你已登陆GitHub账户，若是你尚未GitHub账户，请在GitHub网站上注册免费账户。
2. 将GitHub上的simple-java-maven-app项目fork到你本地的GitHub账户，若是你须要有关此过程的帮助，请参阅GitHub网站上的Fork A Repo文档以获取更多信息。

3. 克隆你fork的simple-java-maven-app存储库（在GitHub上）本地到你的计算机上，要开始此过程，请执行如下任一操做（其中<your-username>是你的操做系统上的用户账户的名称）：

   • 若是你的计算机上安装了GitHub Desktop应用程序：

     • 在GitHub中，单击你fork的存储库上的绿色Clone or download按钮，而后单击Open in Desktop。

     • 在GitHub Desktop中，在Clone a Repository对话框中单击Clone以前，请确保本地路径为：

       • macOS是/Users/<your-username>/Documents/GitHub/simple-java-maven-app
       • Linux是/home/<your-username>/GitHub/simple-java-maven-app
       • Windows是C:\Users\<your-username>\Documents\GitHub\simple-java-maven-app

   • 不然：

     • 打开终端/命令行提示符并cd到相应的目录：

       • macOS — /Users/<your-username>/Documents/GitHub/
       • Linux — /home/<your-username>/GitHub/
       • Windows — C:\Users\<your-username>\Documents\GitHub\（即便使用Git bash命令行窗口而不是一般的Microsoft命令提示符）
     • 运行如下命令以继续/完成克隆你的fork的存储库： git clone https://github.com/YOUR-GITHUB-ACCOUNT-NAME/simple-java-maven-app其中YOUR-GITHUB-ACCOUNT-NAME是你的GitHub账户的名称。

在Jenkins中建立管道项目

1. 返回Jenkins，必要时再次登陆，而后单击新建任务！
   注意：若是你没有看到此内容，请单击左上角的新建项目。
2. 在输入一个任务名称字段中，指定新管道项目的名称（例如，simple-java-maven-app）。
3. 向下滚动并单击流水线，而后单击页面末尾的肯定。
4. （可选）在下一页，在描述字段中指定管道的简要描述（例如，演示如何使用Jenkins使用Maven构建简单的Java应用程序的入门级管道）。
5. 单击页面顶部的Pipeline选项卡以向下滚动到Pipeline部分。
6. 从Definition字段中，选择Pipeline script from SCM选项，此选项指示Jenkins从源控制管理（SCM）获取管道，该管理将是你本地克隆的Git存储库。
7. 从SCM字段中，选择Git。

8. 在Repository URL字段中，指定上面本地克隆的存储库的目录路径，该路径来自主机上的用户账户/主目录，映射到Jenkins容器的/home目录 - 即

   • 对于macOS — /home/Documents/GitHub/simple-java-maven-app
   • 对于Linux — /home/GitHub/simple-java-maven-app
   • 对于Windows — /home/Documents/GitHub/simple-java-maven-app
9. 单击保存以保存新的管道项目，你如今已准备好开始建立Jenkinsfile了，你将把它检入本地克隆的Git存储库。

---

上一篇：部署