Docker 安装Jenkins全过程及踩坑指南

下面是“Docker 安装Jenkins全过程及踩坑指南”的完整攻略。

安装 Docker

首先我们需要安装 Docker，这里我以 Ubuntu 18.04 为例：

$ sudo apt update
$ sudo apt install docker.io

安装完成后，我们可以通过运行 docker -v 命令来检查它是否已成功安装。

启动 Jenkins 容器

接下来，我们可以使用 Docker 来启动 Jenkins 的容器。首先，我们需要在本地创建一个数据卷，它将负责将 Jenkins 的数据存储在本地主机上。

$ docker volume create jenkins_home

然后，我们可以通过运行以下命令来启动 Jenkins 的容器：

$ docker run -d \
  -p 8080:8080 \
  -p 50000:50000 \
  -v jenkins_home:/var/jenkins_home \
  --name jenkins \
  jenkins/jenkins:lts

这将下载并启动一个名为 jenkins 的 Docker 容器，容器映射了两个端口：8080 端口用于在浏览器中访问 Jenkins UI，50000 端口用于构建代理。容器还将使用之前创建的数据卷 jenkins_home 来存储 Jenkins 数据。

运行上述命令后，您应该能够通过浏览器访问 http://localhost:8080 来访问 Jenkins UI，您将看到一个初始设置向导。

Jenkins 初始设置向导

在首次访问 Jenkins UI 时，系统将提示您完成一个初始设置向导。

第一步：解锁 Jenkins

首先需要输入初始管理员密码以解锁 Jenkins。此管理员密码存储在容器日志中，您可以使用以下命令来访问它：

$ docker logs jenkins

搜索输出以 Jenkins initial setup is required. 开头的行。下一行将包含您需要的密码。

然后，将密码复制到 UI 上输入框中，然后单击“继续”。

第二步：自定义 Jenkins

从这里开始，您可以根据自己的首选项自定义 Jenkins。您可以选择安装建议的插件或选择自己需要的插件。

第三步：创建管理员用户

在这一步中，您需要创建一个管理员用户来管理 Jenkins 实例。输入您的姓名、邮箱和密码，然后点击“保存并继续”。

第四步：Jenkins URL

最后一步是设置 Jenkins URL。这通常是 Jenkins 实例的根 URL，可以使用默认值，然后单击“保存并完成”按钮。

问题排除

如果您在使用 Jenkins 过程中遇到问题，以下是一些可能的排查步骤：

检查 Docker 容器状态

使用以下命令检查 Jenkins 容器的状态：

$ docker ps -a

如果状态不是“Up”状态，请使用以下命令启动 Jenkins 容器：

$ docker start jenkins

检查容器日志

使用以下命令来查看 Jenkins 容器日志：

$ docker logs jenkins

这可能有助于确定问题所在。

检查是否使用正确端口

请确保使用正确的端口来访问 Jenkins UI，这可能包括检查您的防火墙是否配置正确。

示例说明

示例1：自定义 Jenkins 镜像

构建自定义 Jenkins 镜像的过程非常简单。只需创建一个 Dockerfile 文件并构建该镜像即可。

创建一个名为 Dockerfile 的文件。

$ vi Dockerfile

向该文件添加以下内容以基于 Jenkins 官方镜像并添加常见插件：

FROM jenkins/jenkins:lts

# This will skip the initial setup wizard
ENV JAVA_OPTS -Djenkins.install.runSetupWizard=false

# Install plugins
RUN jenkins-plugin-cli --plugins "blueocean:1.24.1 credentials-binding:1.24 git:4.5.0"

保存该文件并使用以下命令构建该镜像：

$ docker build -t my-jenkins:v1 .

启动基于该镜像的 Jenkins 容器：

$ docker run -d \
  -p 8080:8080 \
  -p 50000:50000 \
  -v jenkins_home:/var/jenkins_home \
  --name my-jenkins \
  my-jenkins:v1

示例2：使用 GitLab 等外部代码库

如果您的 Jenkins 实例需要与外部代码库（如 GitLab）集成，请遵循以下步骤：

安装 GitLab 插件，并重启 Jenkins 实例。
在 Jenkins 实例中，导航到“系统管理”、“全局安全配置”、“GitLab 徽章”。
勾选“启用 GitLab 徽章”复选框。
在 GitLab 的项目中添加 Jenkinsfile。
在 Jenkins 中创建一个名为 my-pipeline 的“流水线”工程。
在 “流水线” 工程中配置 GitLab 仓库地址和 Jenkinsfile 文件路径等信息。
触发并查看此流水线的构建情况和输出结果。

本站文章如无特殊说明，均为本站原创，如若转载，请注明出处：Docker 安装Jenkins全过程及踩坑指南 - Python技术站