Github项目CI&CD部署

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 来生成：

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

复制代码

然后会提示输入密码：

1. Enter passphrase (empty for no passphrase):

复制代码

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

• github_cicd_key（私钥）
  
• github_cicd_key.pub（公钥）
  

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

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

复制代码

回到 GitHub 仓库页面：

• 进入 Settings -> Security -> Secrets and variables → Actions
  
• 点击 New repository secret
  
• 添加以下三个 Secret：
  

NameValue（值）SERVER_HOST目标主机 IP（如 123.123.123.123）SERVER_USER登录用户名（如 ubuntu、root 等）SSH_PRIVATE_KEY打开 github_cicd_key 文件，复制全部内容粘贴进来2.2 创建 CI/CD 工作流

在本地项目根目录（Windows 上）创建文件：

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

复制代码

内容如下所示：

1. name: Deploy Blog
3. # 支持两种触发方式
4. on:
5.   # 1. 手动触发（GitHub UI 上点击 "Run workflow"）
6.   workflow_dispatch:
8.   # 2. 自动触发：仅当推送到 main 分支 且 提交信息含 [deploy]
9.   push:
10.     branches: [main]
12. jobs:
13.   deploy:
14.     if: >
15.       github.event_name == 'workflow_dispatch' ||
16.       (github.event_name == 'push' && contains(github.event.head_commit.message, '[deploy]'))
18.     runs-on: ubuntu-latest
19.     steps:
20.       - name: Run remote script via SSH
21.         uses: appleboy/ssh-action@v1.0.3
22.         with:
23.           host: ${{ secrets.SERVER_HOST }}
24.           username: ${{ secrets.SERVER_USER }}
25.           key: ${{ secrets.SSH_PRIVATE_KEY }}
26.           script: |
27.             cd /home/ubuntu/
28.             bash -l -c './build-and-deploy.sh'

复制代码

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

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

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

1. git add .
2. git commit -m "Add simple CI/CD workflow"
3. 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环境配置
2. export NVM_DIR="$HOME/.nvm"
3. [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
4. [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion
6. export LD_LIBRARY_PATH=/home/ubuntu/GISBasic/lib/:/home/ubuntu/GISBasic/lib64/:${LD_LIBRARY_PATH:-} #支持变量 LD_LIBRARY_PATH 未定义或为空

复制代码

• 配置文件 build-and-deploy.yml 执行脚本命令增加 bash -l -c，表示以登录用户的身份启动一个新 shell，并在这个环境中运行脚本。例如这里的：
  

1. bash -l -c './build-and-deploy.sh'

复制代码

3. 展望

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

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

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！