当前位置: 首页 > news >正文

Github项目CICD部署

1. 引言

在软件开发中,CI/CD(持续集成 / 持续部署)是一种自动化流程:每当代码更新,系统会自动构建、测试并部署应用,避免手动操作的繁琐与错误。作为 DevOps 的核心实践,CI/CD 有力支撑了敏捷开发“快速交付、持续反馈”的理念,让团队既能灵活响应变化,又能保障交付质量。

2. 操作

2.1 配置 SSH 密钥

如果代码托管在 GitHub 上,那么可以通过 GitHub Actions 来实现 CI/CD 部署。其实 GitHub Actions 的实现原理很简单,就是通过 SSH 登录到目标主机,然后执行一键安装部署脚本。

由于 GitHub Actions 的原理是 Github 主机登录到目标主机(Ubuntu)来执行命令,因此最好先生成一对专用于 CI/CD 新的 SSH 密钥。笔者的开发环境是 Windows,因此通过 PowerShell 来生成:

ssh-keygen -t rsa -b 4096 -f ./github_cicd_key

然后会提示输入密码:

Enter passphrase (empty for no passphrase):

CI/CD 场景下一般用无密码密钥,直接按回车。结束运行后就可以看到两个密钥文件:

  • github_cicd_key(私钥)
  • github_cicd_key.pub(公钥)

将公钥内容添加到 Ubuntu 服务器的 ~/.ssh/authorized_keys:

# 在 Ubuntu 服务器上执行
echo "粘贴 github_cicd_key.pub 的全部内容" >> ~/.ssh/authorized_keys

回到 GitHub 仓库页面:

  • 进入 Settings -> Security -> Secrets and variables → Actions
  • 点击 New repository secret
  • 添加以下三个 Secret:
Name Value(值)
SERVER_HOST 目标主机 IP(如 123.123.123.123)
SERVER_USER 登录用户名(如 ubuntu、root 等)
SSH_PRIVATE_KEY 打开 github_cicd_key 文件,复制全部内容粘贴进来

2.2 创建 CI/CD 工作流

在本地项目根目录(Windows 上)创建文件:

.github/workflows/build-and-deploy.yml

内容如下所示:

name: Deploy Blog# 支持两种触发方式
on:# 1. 手动触发(GitHub UI 上点击 "Run workflow")workflow_dispatch:# 2. 自动触发:仅当推送到 main 分支 且 提交信息含 [deploy]push:branches: [main]jobs:deploy: if: >github.event_name == 'workflow_dispatch' ||(github.event_name == 'push' && contains(github.event.head_commit.message, '[deploy]'))runs-on: ubuntu-lateststeps:- name: Run remote script via SSHuses: appleboy/ssh-action@v1.0.3with:host: ${{ secrets.SERVER_HOST }}username: ${{ secrets.SERVER_USER }}key: ${{ secrets.SSH_PRIVATE_KEY }}script: |cd /home/ubuntu/bash -l -c './build-and-deploy.sh'

这段工作流配置的意思是:

  • 可以手动触发(GitHub UI 上点击 "Run workflow")CI/CD 工作流。
  • 可以自动触发 CI/CD 工作流,不过要求推送到 main 分支且提交信息含 [deploy] 。
  • 使用 SSH 的配置 SERVER_HOSTSERVER_USERSSH_PRIVATE_KEY 登录目标主机 。
  • 执行一键构建和部署脚本 build-and-deploy.sh

build-and-deploy.yml 需要提交并推送到 GitHub:

git add .
git commit -m "Add simple CI/CD workflow"
git push origin main

最后,通过打开 GitHub 仓库 → Actions 标签页,就可以看到是否有 workflow 正在运行(绿色 ✔ 表示成功),还可以查看具体的 CI/CD 日志。

2.3 注意事项

CI/CD 的配置文件 build-and-deploy.yml 中执行任意 shell 命令,不过还是推荐封装好一键构建部署脚本,直接调用这个脚本。很多情况下可以使用这个脚本来进行手动部署。

另外 GitHub Actions 使用的是 非交互式、非登录式 shell,不会加载 .bashrc 或 .profile,环境变量(尤其是 PATH)与手动登录时不同。因此,有两种方案:

  1. 在构建部署脚本的开头显式加载环境。比如:
# 用于CI/CD环境配置
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completionexport LD_LIBRARY_PATH=/home/ubuntu/GISBasic/lib/:/home/ubuntu/GISBasic/lib64/:${LD_LIBRARY_PATH:-} #支持变量 LD_LIBRARY_PATH 未定义或为空
  1. 配置文件 build-and-deploy.yml 执行脚本命令增加 bash -l -c,表示以登录用户的身份启动一个新 shell,并在这个环境中运行脚本。例如这里的:
bash -l -c './build-and-deploy.sh'

3. 展望

其实 CI/CD 配置远不是那么简单,随着项目复杂度提升,还可以逐步引入更多工程实践:

  • 基于 Git Tag 的正式发布:当功能稳定时,打一个 v1.0.0 这样的语义化版本标签,自动触发构建并将二进制文件上传到 GitHub Release,方便他人下载使用。
  • 自动化测试集成:在部署前运行单元测试、端到端测试,确保新代码不会破坏现有功能。
  • 多环境支持:区分开发、预发、生产环境,避免直接在生产服务器上“试错”。
  • 基础设施即代码(IaC):用 Ansible、Terraform 等工具管理服务器配置,让环境可复现、可版本控制。
  • 监控与回滚机制:部署后自动检查服务健康状态,异常时自动回退到上一版本。
http://www.jsqmd.com/news/120253/

相关文章:

  • 2025年12月中国童装品牌深度调研:男生女生童装舒适度与性价比分析报告 - 品牌测评鉴赏家
  • 【机械】螺旋千斤顶的标准机械分析Matlab实现
  • mengzhu铃声
  • Semantic Kernel 实战系列(七) - 高级主题 - Agents 与多代理系统
  • 《手搓》线程池优化的追求
  • 集合幂级数(1)
  • 【超全】基于SSM的毕业生就业管理系统【包括源码+文档+调试】
  • 2025年12月男生女生童装品牌深度评测:高性价比与质量的双重保障 - 品牌测评鉴赏家
  • 【信号去噪】基于维纳滤波实现语音去噪附Matlab代码
  • Java毕设项目:基于springboot的高校校园一卡通管理系统的设计与实现(源码+文档,讲解、调试运行,定制等)
  • BNO055九轴传感器原理图设计,已量产(加速度传感器)
  • cesium126,240311,Ce for Ue 官方教程的一些变化P1 - 概述几个变化:
  • 2025年12月男生女生童装羽绒服品牌深度评测:高性价比之选 - 品牌测评鉴赏家
  • Semantic Kernel 实战系列(六) - Memory与向量存储
  • 2025冬至继上
  • 边界与内部和相等的稳定子数组
  • 中文分词演示 - yi
  • 用 .NET MAUI 10 + VS Copilot 从 0 开发一个签到 App(四)和 Copilot 一起创建「签到历史页面」
  • 医院危急值处理模型 - yi
  • 【课程设计/毕业设计】基于SpringBoot框架的乡村政务信息管理系统基于springboot的村务管理系统的设计与实现【附源码、数据库、万字文档】
  • 2025年12月中国童装品牌调研:HEYLADS男生女生品牌实力解析 - 品牌测评鉴赏家
  • 5.A.swift 使用指南
  • 震惊!选对云服务器代理商,这5个关键指标必须知道!
  • Autodesk组件高危漏洞剖析:CVE-2025-10887缓冲区溢出威胁深度解析
  • 用 .NET MAUI 10 + VS Copilot 从 0 开发一个签到 App(五)注册 + 登录
  • sleuth(micrometer)+zipkin - yebinghuai-qq
  • 【毕业设计】基于springboot的校园一卡通管理系统的设计与实现(源码+文档+远程调试,全bao定制等)
  • 学习笔记:网络流
  • 震惊!云服务器代理商性价比排行,这3家让你省下千万预算!
  • Linux 中md5sum -c 参数