Jenkins 构建 Docker 部署到远端的完整指南
在现代软件开发中，持续集成和持续部署（CI/CD）是必不可少的实践。本篇文章将带你一步步了解如何利用 Jenkins 进行 Docker 部署到远端服务器。我们将从整体流程开始讲解，并提供必要的代码和相应的注释，帮助你更好地理解每个步骤的含义。
整体流程
下面是实现 Jenkins 构建 Docker 部署到远端的主要步骤：
| 步骤 | 说明 |
|---|---|
| 1 | 安装和配置 Jenkins |
| 2 | 安装必需的 Jenkins 插件 |
| 3 | 创建 Jenkins Pipeline 项目 |
| 4 | 编写 Dockerfile 和 Jenkinsfile |
| 5 | 配置 Jenkins Pipeline 的构建步骤 |
| 6 | 将 Docker 镜像推送到远端 Docker Registry |
| 7 | 通过 SSH 部署 Docker 容器到远端服务器 |
每一步的详细说明
1. 安装和配置 Jenkins
首先，你需要在服务器上安装 Jenkins。可以通过以下命令在 Ubuntu 上进行安装：
sudo apt update
sudo apt install openjdk-11-jdk
wget -q -O - | sudo apt-key add -
sudo sh -c 'echo deb binary/ > /etc/apt/sources.list.d/jenkins.list'
sudo apt update
sudo apt install jenkins
这段代码的作用是安装 Jenkins 及其依赖环境。
2. 安装必需的 Jenkins 插件
进入 Jenkins 管理页面，安装以下插件：
- Pipeline
- Docker Pipeline
- Publish Over SSH
这些插件将帮助我们更好地管理 Jenkins 构建和 Docker 部署。
3. 创建 Jenkins Pipeline 项目
在 Jenkins 首页，选择“新建任务”，创建一个“Pipeline”项目。
4. 编写 Dockerfile 和 Jenkinsfile
Dockerfile的示例：
# 使用官方 Node.js 作为基础镜像
FROM node:14
# 设置工作目录
WORKDIR /usr/src/app
# 将 package.json 和 package-lock.json 复制到工作目录
COPY package*.json ./
# 安装应用依赖
RUN npm install
# 将应用代码复制到工作目录
COPY . .
# 暴露应用端口
EXPOSE 8080
# 运行应用
CMD ["npm", "start"]
Jenkinsfile的示例：
pipeline {
agent any
stages {
stage('Build') {
steps {
script {
// 构建 Docker 镜像
sh 'docker build -t your-image-name:latest .'
}
}
}
stage('Push') {
steps {
script {
// 将镜像推送到远端 Docker Registry
sh 'docker push your-image-name:latest'
}
}
}
stage('Deploy') {
steps {
script {
// 通过 SSH 部署到远端服务器
sshPublisher(publishers: [
sshPublisherDesc(
configName: 'your-remote-server',
transfers: [
sshTransfer(
sourceFiles: 'your-image-name:latest',
removeRemoteFiles: false,
remoteDirectory: '/path/to/deploy'
)
]
)
])
}
}
}
}
}
在这里，注释解释了每个命令的具体作用。
5. 配置 Jenkins Pipeline 的构建步骤
在 Jenkins 项目的配置页面，找到“Pipeline”选项，将上述 Jenkinsfile 内容粘贴到 Pipeline 脚本区域。
6. 将 Docker 镜像推送到远端 Docker Registry
在“Push”步骤中，确保你的 Docker Registry 配置信息是正确的。可以使用 Docker 登录命令来验证：
docker login your-docker-registry
7. 通过 SSH 部署 Docker 容器到远端服务器
在最后一步，通过 SSH 传输镜像到远端服务器并运行。你需要在 Jenkins 中配置 SSH 密钥，以便进行安全连接。
关系图
erDiagram
USER ||--o{ JENKINS_PROJECT : has
JENKINS_PROJECT ||--|{ DOCKER_IMAGE : builds
DOCKER_IMAGE ||--o{ REMOTE_SERVER : deployed_to
甘特图
gantt
title Jenkins Docker Deployment Steps
dateFormat YYYY-MM-DD
section Installation
Install Jenkins :a1, 2023-10-01, 1d
Install Plugins :after a1 , 1d
section Project Setup
Create Pipeline Project :2023-10-02, 1d
Write Dockerfile :2023-10-03, 1d
Write Jenkinsfile :2023-10-04, 1d
section Build and Deploy
Build Docker Image :2023-10-05, 1d
Push Docker Image :2023-10-06, 1d
Deploy to Remote Server :2023-10-07, 1d
结尾
通过以上步骤，您应该能够成功使用 Jenkins 来构建 Docker，并部署到远端服务器。这个过程不仅提高了团队的开发效率，还能确保应用的持续交付。随着经验的积累，你将更加熟练于使用这些工具，欢迎在实践中不断探索更多高级特性！
