在腾讯云轻量应用服务器(Lighthouse)上搭建 Jenkins 是一个常见的需求,适合个人开发者或小团队进行持续集成/持续部署(CI/CD)。由于轻量服务器通常配置精简且网络环境相对封闭,我们需要选择Docker 方式或直接安装 Java 方式。
考虑到轻量服务器的资源限制和运维便捷性,推荐使用 Docker 容器化部署,这样不仅隔离性好,升级和维护也更方便。以下是完整的操作步骤:
方案一:使用 Docker 部署(推荐)
这种方式无需手动配置复杂的 Java 环境和依赖,一键启动。
1. 登录并安装 Docker
首先通过 SSH 登录到你的腾讯云轻量服务器,执行以下命令安装 Docker(以 Ubuntu/CentOS 为例,大多数轻量镜像已预装或支持一键安装):
# 更新软件源
sudo apt update && sudo apt upgrade -y # Ubuntu/Debian
# 或者
sudo yum update -y # CentOS/RHEL
# 安装 Docker
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
sudo systemctl enable docker
sudo systemctl start docker
2. 拉取并运行 Jenkins 镜像
Jenkins 官方镜像非常完善,我们将其挂载到宿主机的目录以便持久化数据,并开放默认端口 8080。
docker run -d
--name jenkins
-p 8080:8080
-p 50000:50000
-v /var/jenkins_home:/var/jenkins_home
-u root
jenkins/jenkins:lts
参数说明:
-p 8080:8080: 将宿主机 8080 端口映射到容器内部,用于访问 Web 界面。-p 50000:50000: 用于节点连接(如果你需要多节点构建)。-v ...: 将容器内的数据目录挂载到本地,防止重启后数据丢失。-u root: 轻量服务器有时权限受限,使用 root 启动更稳妥(生产环境建议后续调整用户权限)。
3. 获取初始管理员密码
Jenkins 首次启动后会生成一个随机密码,查看方法如下:
sudo docker logs jenkins | grep "Initial administrator password is:"
复制输出的那串字符。
4. 配置安全组(关键步骤)
这是新手最容易忽略的一步。 即使 Jenkins 启动了,如果云厂商防火墙没开,你也无法访问。
- 登录 腾讯云控制台。
- 进入 轻量应用服务器 列表,点击你的实例。
- 找到 防火墙 或 安全组 设置。
- 添加入站规则:
- 协议:TCP
- 端口范围:
8080(Web 界面) - 授权对象:
0.0.0.0/0(允许所有 IP,测试时可用,生产建议限制 IP) - 描述:Jenkins-HTTP
5. 初始化 Jenkins
- 在浏览器访问
http://<你的公网IP>:8080。 - 输入刚才获取的初始密码。
- 选择 "Suggested Plugins"(推荐插件)进行安装。
- 等待创建第一个管理员账户(建议用户名设为
admin,密码设为你自己的强密码)。 - 完成向导,即可开始使用。
方案二:直接使用系统包安装(传统方式)
如果你不想用 Docker,可以直接在 Linux 上安装 Java 和 Jenkins,但步骤较多且容易因版本问题报错。
-
安装 Java (JDK):
# Ubuntu sudo apt install openjdk-17-jdk -y # CentOS sudo yum install java-17-openjdk-devel -y验证:
java -version -
添加 Jenkins 仓库并安装:
# 导入 GPG Key curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null # 添加源 (Ubuntu 示例) 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 update sudo apt install jenkins -y -
启动服务:
sudo systemctl start jenkins sudo systemctl enable jenkins -
同样需要配置腾讯云控制台的安全组,开放 8080 端口。
进阶优化建议
搭建完成后,为了获得更好的体验,建议进行以下配置:
-
更换国内镜像源:
默认的插件下载速度可能很慢。进入Manage Jenkins->Plugins->Advanced Settings,将插件下载 URL 修改为阿里云或腾讯云的镜像地址(如https://mirrors.cloud.tencent.com/jenkins/),或者直接在插件安装页面勾选“从备份安装”来跳过在线下载。 -
配置反向X_X (Nginx):
直接暴露 8080 端口不够美观,也不利于 HTTPS。建议在服务器上安装 Nginx,配置反向X_X到localhost:8080,并申请 SSL 证书实现 HTTPS 访问。 -
Docker 权限问题:
如果在 Jenkins 中尝试运行docker build或docker run失败,提示permission denied,是因为容器内没有挂载 Docker Socket。需要在启动 Jenkins 容器时额外挂载:-v /var/run/docker.sock:/var/run/docker.sock(注意:这会让 Jenkins 拥有宿主机的 Docker 权限,生产环境需注意安全风险)
-
快照备份:
利用腾讯云轻量服务器的快照功能,在 Jenkins 配置好核心插件和环境后打一个快照。下次重装或扩容时,可以直接回滚快照,节省大量时间。
通过以上步骤,你应该能顺利在腾讯云轻量服务器上跑起 Jenkins。如果有具体的报错信息,欢迎继续提问!
云知道CLOUD