Ubuntu Jenkins如何远程操作 - 问答

Ubuntu Jenkins远程操作配置指南

一、远程访问Jenkins管理界面

要远程访问Ubuntu服务器上的Jenkins，需完成以下基础配置：

安装Jenkins
在Ubuntu上通过包管理器安装Jenkins及依赖：

sudo apt update && sudo apt install -y openjdk-11-jdk
wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo apt-key add -
sudo sh -c 'echo deb http://pkg.jenkins.io/debian-stable binary/ /etc/apt/sources.list.d/jenkins.list'
sudo apt update && sudo apt install -y jenkins

启动Jenkins服务
设置Jenkins开机自启并立即启动：

sudo systemctl enable jenkins
sudo systemctl start jenkins
sudo systemctl status jenkins  # 验证服务状态

开放防火墙端口
使用ufw开放Jenkins管理界面（8080）和Agent通信（50000）端口：
```
sudo ufw allow 8080/tcp
sudo ufw allow 50000/tcp
sudo ufw reload
```
初始化Jenkins
获取初始管理员密码并完成解锁：
```
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
```
浏览器访问http://<Ubuntu服务器IP>:8080，输入初始密码完成解锁。后续建议创建专用管理员账户（而非使用默认admin）。
安全强化配置
- 启用全局安全：进入Manage Jenkins > Configure Global Security，勾选“Enable security”。
- 选择认证方式：推荐使用“Jenkins’ own user database”（内置用户管理）或“LDAP”（企业级认证）。
- 授权策略：选择“Role-Based Strategy”（基于角色的访问控制），精细化分配用户权限（如管理员、开发者、观察者）。
- 配置SSL（可选但推荐）：通过Let’s Encrypt申请免费证书，将Jenkins访问协议升级至HTTPS（避免密码明文传输）。

二、远程命令行操作Jenkins

Jenkins提供两种主流远程命令行方式：SSH接口和CLI jar工具。

1. 通过SSH执行命令

启用SSH Server：
进入Manage Jenkins > Configure Global Security，找到“SSH Server” section，设置监听端口（如8090，默认随机），保存配置。
添加用户SSH密钥：
将远程用户的公钥（~/.ssh/id_rsa.pub）添加到Jenkins对应用户的“Public Keys”列表（Manage Jenkins > Manage Users > 选择用户 > Configure）。

执行远程命令：
使用SSH命令连接Jenkins，格式为ssh -l <用户名> -p <端口> <Jenkins服务器IP> <Jenkins命令>。例如：

ssh -l jack -p 8090 192.168.1.100 who-am-i  # 验证身份
ssh -l jack -p 8090 192.168.1.100 build test -f -v  # 触发名为test的job

2. 使用jenkins-cli.jar工具

下载CLI jar：
从Jenkins服务器下载官方CLI工具：

wget http://<Jenkins服务器IP>:8080/jnlpJars/jenkins-cli.jar

认证方式：

用户名+密码（不推荐）：直接在命令中输入账号密码（易泄露）。

java -jar jenkins-cli.jar -s http://<Jenkins服务器IP>:8080 -auth jack:123456 build test

API Token（推荐）：

进入Manage Jenkins > Manage Users > 选择用户 > Configure > API Token，生成新token。

使用token认证：

java -jar jenkins-cli.jar -s http://<Jenkins服务器IP>:8080 -auth jack:11d5ca0f9ee2dac8c47492b3e6b71c82cd build test

安全存储token：将token保存到本地文件（如~/.jenkins-token），通过@引用：

echo jack:11d5ca0f9ee2dac8c47492b3e6b71c82cd > ~/.jenkins-token
java -jar jenkins-cli.jar -s http://<Jenkins服务器IP>:8080 -auth @~/.jenkins-token build test

环境变量认证：将用户名和token存入环境变量，简化命令：

export JENKINS_USER_ID=jack
export JENKINS_API_TOKEN=11d5ca0f9ee2dac8c47492b3e6b71c82cd
java -jar jenkins-cli.jar -s http://<Jenkins服务器IP>:8080 -auth $JENKINS_USER_ID:$JENKINS_API_TOKEN build test

三、远程控制主机执行脚本（Publish Over SSH插件）

若需远程执行Shell脚本或传输文件到其他主机（如部署构建产物），可通过Publish Over SSH插件实现：

安装插件：
进入Manage Jenkins > Manage Plugins > Available，搜索“Publish Over SSH”，点击“Install without restart”。
配置SSH远程主机：
进入Manage Jenkins > Configure System > Publish over SSH，点击“Add”添加远程主机：
- Name：自定义标识（如RemoteServer）。
- Hostname：远程主机IP或域名。
- Username：远程主机登录用户名（如ubuntu）。
- Remote Directory：远程主机上的目标目录（如/var/www/html，需提前创建）。
- Credentials：选择或添加SSH私钥（需提前在Jenkins“Credentials”中配置，类型为“SSH Username with private key”）。

在项目中使用插件：

Freestyle Project：进入项目配置，找到“Post-build Actions”，添加“Send build artifacts over SSH”，选择配置好的SSH主机，设置源文件（如dist/**/*，匹配构建产物）和目标目录（如/var/www/html），还可添加执行命令（如systemctl restart nginx）。

Pipeline：在Jenkinsfile中使用sshPublisher步骤：

pipeline {
    agent any
    stages {
        stage('Deploy') {
            steps {
                sshPublisher(
                    publishers: [
                        sshPublisherDesc(
                            configName: 'RemoteServer',  // 对应配置的SSH主机名称
                            transfers: [
                                sshTransfer(
                                    sourceFile: 'dist/**/*',
                                    removePrefix: 'dist',
                                    remoteDirectory: '/var/www/html'
                                )
                            ],
                            execCommand: 'systemctl restart nginx'  // 部署后重启服务
                        )
                    ]
                )
            }
        }
    }
}

四、分布式构建（远程Slave节点）

若需将构建任务分发到远程Ubuntu服务器（Slave节点），可通过SSH连接实现：

准备Slave节点：
在远程Ubuntu服务器上安装Jenkins Agent和Java：

sudo apt update && sudo apt install -y openjdk-11-jdk
wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo apt-key add -
sudo sh -c 'echo deb http://pkg.jenkins.io/debian-stable binary/ /etc/apt/sources.list.d/jenkins.list'
sudo apt update && sudo apt install -y jenkins

配置Master节点：
进入Manage Jenkins > Manage Nodes and Clouds > New Node，输入节点名称（如RemoteSlave），选择“Permanent Agent”，点击“OK”。
- Remote root directory：设置Slave节点的工作目录（如/home/ubuntu/jenkins）。
- Launch method：选择“Launch agents via SSH”，填写Slave节点的Hostname/IP，选择之前配置的SSH Credentials（私钥）。
- Host Key Verification Strategy：选择“Non verifying Verification Strategy”（测试环境）或手动验证主机密钥（生产环境）。
启动Slave节点：
保存配置后，Jenkins会自动通过SSH连接到Slave节点，启动Agent进程。节点状态显示为“Online”即表示连接成功。
分配任务到Slave：
在项目配置中，勾选“Restrict where this project can be run”，输入Slave节点的标签（如RemoteSlave），任务将自动分发到该节点执行。

0 赞

0 踩