个人网站 目的,上海市工程建设质量管理协会网站,计算机大专学历有用吗,网站后台需求通过 Jenkins 和 Docker 部署微信小程序#xff0c;并实现自动构建、发布和版本更新#xff0c;主要涉及以下几个步骤#xff1a;
设置 Jenkins 环境配置 GitLab 与 Jenkins 的集成构建 Docker 镜像部署和发布微信小程序配置 Jenkins 自动构建
以下是详细的步骤说明#…通过 Jenkins 和 Docker 部署微信小程序并实现自动构建、发布和版本更新主要涉及以下几个步骤
设置 Jenkins 环境配置 GitLab 与 Jenkins 的集成构建 Docker 镜像部署和发布微信小程序配置 Jenkins 自动构建
以下是详细的步骤说明 1. 设置 Jenkins 环境
首先确保你已经安装和配置了 Jenkins 服务器。假设你已经安装了 Jenkins并且 Jenkins 能够正常运行。
安装 Jenkins 所需插件
Docker Plugin用于在 Jenkins 中执行 Docker 操作。GitLab Plugin用于集成 GitLab 仓库与 Jenkins。Pipeline Plugin用于通过流水线Pipeline来定义构建过程。
在 Jenkins 上安装插件的方法
进入 Jenkins Dashboard点击 Manage Jenkins。选择 Manage Plugins。在 Available 标签页中搜索并安装以下插件 GitLab PluginDocker Pipeline PluginPipeline Plugin 2. 配置 GitLab 与 Jenkins 集成
确保你在 Jenkins 上配置了与 GitLab 的集成以便 Jenkins 可以从 GitLab 获取代码并触发构建。
配置 GitLab Webhook 登录到你的 GitLab 仓库。 进入 Settings - Webhooks。 添加一个新的 Webhook输入 Jenkins 服务器的 URL格式为 http://jenkins_url/project/jenkins_job_name例如 http://localhost:8080/project/wechat-miniapp-build选择 Push events 和 Merge requests这样每次代码提交到 GitLab 时Jenkins 会自动开始构建。
配置 GitLab 连接到 Jenkins
进入 Jenkins点击 Manage Jenkins - Configure System。在 GitLab 配置部分输入 GitLab 的 API URL 和 API Token。你需要创建一个 GitLab 访问令牌Token 在 GitLab 上进入 User Settings - Access Tokens创建一个新的访问令牌。 保存设置后你可以通过 GitLab Plugin 连接到 GitLab 仓库。 3. 构建 Docker 镜像
在 Jenkins 中创建一个 Pipeline 作业用来构建 Docker 镜像并部署微信小程序。
Dockerfile 示例
首先在你的微信小程序项目根目录下创建一个 Dockerfile用于构建 Docker 镜像。
# 使用 Node.js 镜像作为基础镜像
FROM node:16# 创建并设置工作目录
WORKDIR /app# 将当前目录下的项目文件复制到 Docker 容器中
COPY . .# 安装依赖
RUN npm install# 执行构建命令
RUN npm run build# 暴露端口
EXPOSE 3000# 启动微信小程序构建服务例如使用 Nginx 或其他方式
CMD [npm, start]Jenkins Pipeline 脚本
创建一个 Jenkins Pipeline 来执行代码的拉取、Docker 镜像的构建和发布。
pipeline {agent anyenvironment {DOCKER_IMAGE wechat-miniappDOCKER_REGISTRY your-docker-registry // Docker registry 地址}stages {stage(Checkout) {steps {// 从 GitLab 获取代码git http://your_gitlab_repo_url.git}}stage(Build Docker Image) {steps {script {// 构建 Docker 镜像sh docker build -t ${DOCKER_REGISTRY}/${DOCKER_IMAGE}:latest .}}}stage(Push Docker Image) {steps {script {// 将构建的镜像推送到 Docker Registrysh docker push ${DOCKER_REGISTRY}/${DOCKER_IMAGE}:latest}}}stage(Deploy) {steps {script {// 在服务器上拉取并运行 Docker 镜像sh docker pull ${DOCKER_REGISTRY}/${DOCKER_IMAGE}:latestsh docker run -d -p 3000:3000 ${DOCKER_REGISTRY}/${DOCKER_IMAGE}:latest}}}}post {always {// 构建结束后执行的操作比如清理旧的容器sh docker system prune -f}}
}说明
Checkout从 GitLab 拉取代码。Build Docker Image构建 Docker 镜像。Push Docker Image将镜像推送到 Docker Registry如果你使用的是私有仓库可以推送到私人 Docker 仓库。Deploy在目标服务器上拉取并运行 Docker 镜像。
4. 部署和发布微信小程序 构建微信小程序的发布版本 使用 npm run build 命令来构建生产版本通常会生成一个用于发布的文件夹例如dist/ 或 build/。然后将这些文件部署到你选择的 web 服务器上例如 Nginx、Apache 等。 上传小程序代码 微信小程序通常需要使用微信开发者工具上传到微信服务器。你可以在构建完成后利用微信小程序开发者工具的命令行工具进行自动化上传。 微信小程序提供了 CLI 工具叫做 weapp-cli你可以通过以下方式上传代码 npm install -g weapp-cli
weapp-cli upload --appid your_app_id --project path_to_your_project然后可以将 upload 命令添加到 Jenkins Pipeline 的最后一个阶段。 stage(Upload to WeChat) {steps {script {// 上传到微信小程序sh weapp-cli upload --appid your_app_id --project ./dist}}
}5. 配置 Jenkins 自动构建
每次有新代码提交到 GitLab 时Jenkins 会通过 Webhook 自动触发构建过程。确保你的 GitLab 项目正确配置了 Webhook指向 Jenkins 的构建 URL。
配置 Webhook
在 GitLab 项目中添加 Jenkins 的 Webhook确保它能在每次推送代码后触发 Jenkins 构建任务。 总结
Jenkins 安装和配置确保你已经安装并配置了 Jenkins 和相关插件。GitLab 与 Jenkins 集成通过 Webhook 配置 GitLab 与 Jenkins 的集成。Dockerfile 和 Jenkins Pipeline编写 Dockerfile 和 Jenkins Pipeline 脚本来构建、推送 Docker 镜像。上传小程序使用微信小程序 CLI 工具上传构建的代码。自动化构建和部署通过 Webhook 和 Jenkins 自动化构建和部署流程。
在 AlmaLinux 上配置 Jenkins 自动化构建、Docker 部署和与 GitLab 集成的步骤涵盖从系统安装到 Jenkins 配置、Docker 部署、GitLab 集成、以及微信小程序自动构建和上传等过程。下面是详细的安装和配置步骤。 1. 安装 Jenkins 和依赖
首先我们需要在 AlmaLinux 上安装 Jenkins。
1.1 安装 JavaJenkins 的运行依赖
Jenkins 需要 Java 运行环境通常推荐使用 OpenJDK。
sudo dnf install java-11-openjdk-devel -y1.2 安装 Jenkins
Jenkins 官方提供了 RHEL/CentOS 8 和 AlmaLinux 8 的安装包。你可以通过以下步骤安装 Jenkins
添加 Jenkins 仓库
sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat/jenkins.repo导入 Jenkins GPG 密钥
sudo rpm --import https://pkg.jenkins.io/redhat/jenkins.io.key安装 Jenkins
sudo dnf install jenkins -y1.3 启动 Jenkins 服务
安装完成后启动 Jenkins 服务并使其开机自启
sudo systemctl start jenkins
sudo systemctl enable jenkins1.4 开放 Jenkins 的端口默认 8080
sudo firewall-cmd --zonepublic --add-port8080/tcp --permanent
sudo firewall-cmd --reload1.5 访问 Jenkins Web UI
在浏览器中访问 Jenkins
http://your-server-ip:8080首次访问时Jenkins 会要求你输入解锁密钥。你可以在以下位置找到它
sudo cat /var/lib/jenkins/secrets/initialAdminPassword输入密码后你可以继续设置 Jenkins。 2. 安装 Jenkins 插件
在 Jenkins 中我们需要安装一些插件来支持 Docker 和 GitLab 集成。
进入 Jenkins 控制台点击 Manage Jenkins - Manage Plugins。在 Available 标签下搜索并安装以下插件 Docker Pipeline支持在 Jenkins 中执行 Docker 命令。GitLab Plugin与 GitLab 仓库集成。Pipeline Plugin用于定义 Jenkins 流水线Pipeline。
安装完成后重启 Jenkins。 3. 安装 Docker
在 Jenkins 中使用 Docker 来构建和部署微信小程序。首先你需要安装 Docker。
3.1 安装 Docker
# 安装 Docker 依赖
sudo dnf install -y yum-utils device-mapper-persistent-data lvm2# 设置 Docker 仓库
sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo# 安装 Docker CE
sudo dnf install docker-ce docker-ce-cli containerd.io -y# 启动并启用 Docker
sudo systemctl start docker
sudo systemctl enable docker3.2 配置 Docker 用户权限
为了避免每次运行 Docker 命令时都需要使用 sudo你可以将 Jenkins 用户添加到 docker 组
sudo usermod -aG docker jenkins然后重新启动 Jenkins 服务
sudo systemctl restart jenkins4. 配置 GitLab 集成
Jenkins 需要能够从 GitLab 获取代码并触发构建。
4.1 配置 GitLab Webhook 在 GitLab 上进入你的项目。 进入 Settings - Webhooks。 添加一个新的 Webhook设置 URL 为 Jenkins 构建的 URL http://jenkins-ip:8080/project/jenkins-job-name选择 Push events 和 Merge request events确保每次提交或合并时 Jenkins 都能触发构建。
4.2 配置 GitLab Plugin
在 Jenkins 中点击 Manage Jenkins - Configure System。在 GitLab 配置部分输入 GitLab 的 URL 和 API Token。 在 GitLab 中生成 API Token进入 User Settings - Access Tokens 创建一个新的访问令牌。 配置完成后保存并测试连接。 5. 创建 Jenkins Pipeline
使用 Jenkins Pipeline 来定义整个构建过程。创建一个新的 Pipeline 类型的 Job。
5.1 配置 Job
在 Jenkins 控制台点击 New Item - Pipeline。在 Pipeline 配置页面选择 Pipeline Script。在 Pipeline Script 部分编写你的 Jenkins Pipeline 脚本定义构建、Docker 镜像构建和微信小程序上传的过程。
5.2 Jenkins Pipeline 脚本示例
以下是一个完整的 Jenkins Pipeline 脚本示例
pipeline {agent anyenvironment {DOCKER_IMAGE wechat-miniappDOCKER_REGISTRY your-docker-registry}stages {stage(Checkout) {steps {// 从 GitLab 获取代码git http://your_gitlab_repo_url.git}}stage(Build Docker Image) {steps {script {// 构建 Docker 镜像sh docker build -t ${DOCKER_REGISTRY}/${DOCKER_IMAGE}:latest .}}}stage(Push Docker Image) {steps {script {// 推送 Docker 镜像到 Docker Registrysh docker push ${DOCKER_REGISTRY}/${DOCKER_IMAGE}:latest}}}stage(Deploy) {steps {script {// 拉取并运行 Docker 镜像sh docker pull ${DOCKER_REGISTRY}/${DOCKER_IMAGE}:latestsh docker run -d -p 3000:3000 ${DOCKER_REGISTRY}/${DOCKER_IMAGE}:latest}}}stage(Upload to WeChat) {steps {script {// 使用微信小程序 CLI 上传代码sh weapp-cli upload --appid your_app_id --project ./dist}}}}post {always {// 清理 Docker 系统sh docker system prune -f}}
}6. 微信小程序的构建和上传
6.1 安装微信小程序 CLI 工具
如果你需要自动化上传微信小程序可以使用 weapp-cli 工具。
在你的构建过程中安装并使用微信小程序 CLI 来上传小程序代码
npm install -g weapp-cli6.2 配置自动上传
将上传命令添加到 Jenkins Pipeline 中的最后一个阶段
stage(Upload to WeChat) {steps {script {// 上传到微信小程序sh weapp-cli upload --appid your_app_id --project ./dist}}
}你需要替换 your_app_id 和 ./dist 为你实际的小程序 App ID 和构建后的目录。 7. 自动化构建与部署
GitLab Push每次代码提交到 GitLab 时Webhooks 会触发 Jenkins 构建。Jenkins PipelineJenkins 会从 GitLab 拉取代码构建 Docker 镜像并进行微信小程序的自动构建与上传。Docker 部署使用 Docker 容器运行构建好的微信小程序。 8. 总结
通过这些步骤你可以在 AlmaLinux 上配置 Jenkins结合 Docker 部署和 GitLab 集成自动化构建和发布微信小程序
安装 Jenkins 和 Docker。配置 Jenkins 与 GitLab 的集成。使用 Docker 构建镜像并发布。使用微信小程序 CLI 自动上传代码。配置 Webhook自动触发 Jenkins 构建。
要将微信小程序部署到 Docker 上并使用 Jenkins 实现自动构建和更新我们需要明确几个关键步骤。主要的步骤包括
构建微信小程序微信小程序的构建过程通常会生成一个可以通过 Web 服务器提供服务的构建文件夹。你可以将这些文件夹作为 Docker 镜像的一部分来部署。创建 Docker 镜像我们需要为微信小程序创建一个 Docker 镜像这样可以在容器中运行它。Jenkins 自动构建和发布在 Jenkins 中配置一个流水线来自动化从 GitLab 拉取代码、构建 Docker 镜像、推送到 Docker 仓库并部署到目标服务器。
详细步骤 1. 准备微信小程序项目
微信小程序本身是一个前端项目通常使用 npm run build 进行构建这样会生成一个可以通过 Web 服务器提供的构建文件夹例如 dist/ 或 build/。
首先确保你已经准备好微信小程序的代码并能够通过以下命令构建它
npm install
npm run build2. Dockerfile 示例
接下来我们需要为微信小程序创建一个 Dockerfile这样就能将构建好的文件夹部署到 Docker 容器中。
2.1 创建 Dockerfile
在微信小程序的项目根目录下创建一个 Dockerfile示例如下
# 使用 Nginx 作为基础镜像
FROM nginx:alpine# 设置工作目录
WORKDIR /usr/share/nginx/html# 将本地构建的文件例如 dist 文件夹复制到容器的工作目录中
COPY ./dist /usr/share/nginx/html# 暴露 Nginx 的默认端口 80
EXPOSE 80# 默认命令启动 Nginx
CMD [nginx, -g, daemon off;]这里的 Dockerfile 做了以下几件事情
使用 Nginx 作为 Web 服务器来提供小程序的静态资源。将构建后的文件夹例如 dist/复制到 Nginx 默认的 Web 根目录 /usr/share/nginx/html。设置 Nginx 启动命令并暴露容器的 80 端口。
2.2 构建 Docker 镜像
在项目根目录下执行以下命令来构建 Docker 镜像
docker build -t wechat-miniapp .2.3 运行 Docker 容器
构建镜像之后运行 Docker 容器
docker run -d -p 8080:80 wechat-miniapp这将启动一个 Nginx 服务器监听宿主机的 8080 端口。你可以通过访问 http://your-server-ip:8080 来查看你的微信小程序。 3. 配置 Jenkins 自动构建和更新
接下来我们要使用 Jenkins 自动化构建和更新过程。主要的任务是从 GitLab 获取代码、构建 Docker 镜像、推送镜像到 Docker Hub 或私有仓库然后在目标服务器上拉取最新的镜像并运行。
3.1 安装 Jenkins 插件
在 Jenkins 上安装以下插件
Docker Pipeline用于在 Jenkins 中执行 Docker 操作。GitLab Plugin用于与 GitLab 集成拉取代码。Pipeline Plugin用于在 Jenkins 中创建流水线脚本。
3.2 配置 Jenkins 连接到 GitLab
在 Jenkins 上配置 GitLab 集成
进入 Jenkins点击 Manage Jenkins - Configure System。在 GitLab 配置部分添加 GitLab 服务器的 URL 和 API Token。你可以在 GitLab 上创建一个新的 API Token。在 GitLab Plugin 中测试连接是否成功。
3.3 配置 Jenkins Pipeline
在 Jenkins 中点击 New Item - Pipeline。在 Pipeline 配置页面中选择 Pipeline script。在 Pipeline script 中编写你的构建脚本示例如下
pipeline {agent anyenvironment {DOCKER_IMAGE wechat-miniappDOCKER_REGISTRY your-docker-registry // Docker 仓库地址例如 Docker Hub 或私有仓库DOCKER_TAG latest // Docker 镜像标签}stages {stage(Checkout) {steps {// 从 GitLab 获取代码git http://your_gitlab_repo_url.git}}stage(Install Dependencies) {steps {script {// 安装依赖sh npm install}}}stage(Build) {steps {script {// 构建微信小程序sh npm run build}}}stage(Build Docker Image) {steps {script {// 构建 Docker 镜像sh docker build -t ${DOCKER_REGISTRY}/${DOCKER_IMAGE}:${DOCKER_TAG} .}}}stage(Push Docker Image) {steps {script {// 将镜像推送到 Docker 仓库sh docker push ${DOCKER_REGISTRY}/${DOCKER_IMAGE}:${DOCKER_TAG}}}}stage(Deploy Docker Container) {steps {script {// 在目标服务器上拉取最新镜像并运行 Docker 容器sh docker pull ${DOCKER_REGISTRY}/${DOCKER_IMAGE}:${DOCKER_TAG}sh docker stop wechat-miniapp || truesh docker rm wechat-miniapp || truesh docker run -d --name wechat-miniapp -p 8080:80 ${DOCKER_REGISTRY}/${DOCKER_IMAGE}:${DOCKER_TAG}}}}}post {always {// 清理 Docker 镜像和容器sh docker system prune -f}}
}说明
Checkout从 GitLab 仓库中拉取代码。Install Dependencies安装微信小程序的依赖。Build构建微信小程序通常会生成一个 dist/ 或 build/ 文件夹。Build Docker Image使用 Dockerfile 构建 Docker 镜像。Push Docker Image将构建好的 Docker 镜像推送到 Docker 仓库例如 Docker Hub 或私有 Docker Registry。Deploy Docker Container在目标服务器上拉取镜像并运行 Docker 容器将微信小程序部署到生产环境。Post Actions清理 Docker 镜像和容器释放资源。
3.4 配置 GitLab Webhook
在 GitLab 中进入你的项目设置配置 Webhook使每次代码推送后自动触发 Jenkins 构建 在 GitLab 中进入项目设置 - Webhooks。 添加 Jenkins 的 Webhook 地址 http://jenkins-ip:8080/project/jenkins-job-name选择 Push events 和 Merge requests这样每次代码提交或合并时Jenkins 会自动构建。 4. 总结
通过以上步骤你可以实现以下目标
Docker 部署微信小程序使用 Nginx 作为 Web 服务器部署构建好的微信小程序。Jenkins 自动构建和发布通过 Jenkins Pipeline自动化从 GitLab 拉取代码、构建 Docker 镜像、推送镜像到 Docker 仓库、部署到目标服务器。自动更新每次代码提交到 GitLabJenkins 会自动触发构建并部署最新版本的小程序。
这样你就可以通过 Docker 容器化的方式利用 Jenkins 自动化构建和部署微信小程序从而提高开发和发布的效率。
