入门：在 Azure Linux VM 上安装 Jenkins

2025-10-10

本文介绍如何在 Ubuntu Linux VM 上安装 Jenkins，并配置工具和插件以与 Azure 配合使用。

您将在本文中学习如何：

创建下载并安装 Jenkins 的安装文件

创建资源组

使用安装文件创建虚拟机

打开端口 8080 以访问虚拟机上的 Jenkins

通过 SSH 连接到虚拟机

在 GitHub 中基于一个示例 Java 应用程序配置示例 Jenkins 作业

生成示例 Jenkins 作业

1.配置环境

Azure 订阅：如果没有 Azure 订阅，请在开始之前创建一个免费帐户。

2. 打开 Cloud Shell

如果已打开 Cloud Shell 会话，可以跳到下一部分。
浏览到 Azure 门户
如有必要，请登录到 Azure 订阅并更改 Azure 目录。
打开 Cloud Shell。
如果以前未使用 Cloud Shell，请配置环境和存储设置。
选择命令行环境。

3. 创建虚拟机

创建名为 jenkins-get-started 的测试目录。
切换到测试目录。
创建名为 cloud-init-jenkins.txt 的文件。

将以下代码粘贴到新文件中：

#cloud-config
package_upgrade: true
runcmd:
  - sudo apt install openjdk-17-jre -y
  - curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null
  -  echo 'deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/' | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null
  - sudo apt-get update && sudo apt-get install jenkins -y
  - sudo service jenkins restart

运行 az group create 创建资源组。

az group create --name jenkins-get-started-rg --location eastus

运行 az vm create 以创建虚拟机。

az vm create \
--resource-group jenkins-get-started-rg \
--name jenkins-get-started-vm \
--image UbuntuLTS \
--admin-username "azureuser" \
--generate-ssh-keys \
--public-ip-sku Standard \
--custom-data cloud-init-jenkins.txt

运行 az vm list 以验证新虚拟机的创建（和状态）。

az vm list -d -o table --query "[?name=='jenkins-get-started-vm']"

当 Jenkins 在端口 8080 上运行时，请运行 az vm open ，在新虚拟机上打开端口 8080。

az vm open-port \
--resource-group jenkins-get-started-rg \
--name jenkins-get-started-vm  \
--port 8080 --priority 1010

4. 配置 Jenkins

运行 az vm show 以获取示例虚拟机的公共 IP 地址。
```
az vm show \
--resource-group jenkins-get-started-rg \
--name jenkins-get-started-vm -d \
--query [publicIps] \
--output tsv
```
要点：
- 该 --query 参数将输出限制为虚拟机的公共 IP 地址。
使用上一步中检索的 IP 地址，通过 SSH 连接到虚拟机。需要确认连接请求。
```
ssh azureuser@<ip_address>
```
要点：
- 成功连接后，Cloud Shell 提示符包括用户名和虚拟机名称： azureuser@jenkins-get-started-vm
通过获取 Jenkins 服务的状态来验证 Jenkins 是否正在运行。
```
service jenkins status
```
要点：
- 如果收到有关服务不存在的错误，可能需要等待几分钟才能安装和初始化所有内容。

获取自动生成的 Jenkins 密码。

sudo cat /var/lib/jenkins/secrets/initialAdminPassword

使用 IP 地址，在浏览器中打开以下 URL： http://<ip_address>:8080
输入之前检索的密码，然后选择“ 继续”。
选择要安装的插件。
在页面顶部的筛选器框中，输入 github。选择 GitHub 插件，然后选择“ 安装”。
输入第一个管理员用户的信息，然后选择“ 保存并继续”。
在 “实例配置 ”页上，选择“ 保存并完成”。
选择“ 开始使用 Jenkins”。

5.创建第一个作业

在 Jenkins 主页上，选择“ 创建作业”。
输入作业名称 mySampleApp，选择 Freestyle 项目，然后选择“ 确定”。
选择“源代码管理”选项卡。启用 Git 并输入存储库 URL 值的以下 URL： https://github.com/spring-guides/gs-spring-boot.git 然后将 分支说明符 更改为 */main。
选择“ 生成 ”选项卡，然后选择“ 添加生成”步骤
从下拉菜单中选择 “调用 Gradle 脚本”。
选择使用 Gradle 包装器，然后在包装器位置和任务中输入completebuild。
选择“高级”，然后在complete字段中输入。
滚动到页面底部，然后选择“ 保存”。