GitHub Action 实现超简单的持续集成(CI)

GitHub Action 官方文档

GitHub Action 中使用 Docker 的官方文档

所用项目代码获取:公众号发送cloud

前言

在上一篇几分钟完成前后端分离项目部署文章中,我们完成了前后端分离项目的部署,但随着开发的进行,我们每次更新都手动打包上传部署,那无疑是十分繁琐且固定,那是否可以让这一步骤自动触发执行呢?答案当然是可以的,市面上有许多的持续集成与部署的组件可以使用,如:Jenkins、GitLab CI等等。

但因为我们是个人前期开发的小项目,可以使用更为简便的 GitHub Action 来实现持续集成,只需要编辑一个配置文件即可。

官网对于GitHub Action的介绍:是一种持续集成和持续交付 (CI/CD) 平台,可用于自动执行生成、测试和部署管道。(详细的使用说明请自行阅读文档

前端项目

配置

在项目目录下创建.github/workflows目录,编辑配置文件 deploy,yml

yaml 复制代码
name: 'Deployment To Cloud'

on:
  workflow_dispatch:
  push:
    branches: [main]
  
jobs:
  deployment:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Setup node
        uses: actions/setup-node@v3
        with:
          node-version: 16.14.x
      - name: install && build
        run: pnpm install && pnpm run build
        
      - name: upload file
        uses: kostyaten/ssh-server-deploy@v4
        with: 
          host: ${{ secrets.HOST }}
          username: ${{ secrets.USERNAME }}
          password: ${{ secrets.PASSWORD }}
          port: 22
          scp_source: "./dist"
          scp_target: ${{ secrets.TARGET }}

验证

可以看到dist目录也已经上传到了服务器

后端项目

配置

以sevice模块为例子,在项目下创建Dockerfile文件并编辑

shell 复制代码
FROM zeroclian/jdk17
MAINTAINER ZeroClian
ADD service/target/cloud-service.jar /cloud-service.jar
ENTRYPOINT ["java","-jar","/cloud-service.jar"]
  • FROM: 拉取基础环境镜像
  • MAINTAINER: 添加镜像作者信息
  • ADD: 将指定文件复制到镜像的指定位置下
  • ENTRYPOINT: 指定容器启动时运行的命令

在项目根目录下创建.github/workflows目录,编辑配置文件 deploy,yml

yaml 复制代码
name: Java CI with Maven

on:
  push:
    branches: [ main ]
    paths-ignore:
      - '**.md'
  pull_request:
    branches: [ main ]
    paths-ignore:
      - '**.md'

jobs:
  build:

    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v3
      - name: Set up JDK 17
        uses: actions/setup-java@v3
        with:
          java-version: '17'
          distribution: 'adopt'
          cache: 'maven'
      - name: Build with Maven
        run: mvn clean package -DskipTests=true -Dmaven.javadoc.skip=true -B -V
      - name: Login to Docker Hub
        uses: docker/login-action@v3
        with:
          username: ${{ secrets.DOCKERHUB_USERNAME }}
          password: ${{ secrets.DOCKERHUB_PASSWORD }}
      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v3
      - name: Build and Push Service
        uses: docker/build-push-action@v5
        with:
          context: .
          file: ./service/Dockerfile
          push: true
          tags: zeroclian/cloud-service:latest
      - name: Build and Push Gateway
        uses: docker/build-push-action@v5
        with:
          context: .
          file: ./gateway/Dockerfile
          push: true
          tags: zeroclian/cloud-gateway:latest

验证

可以看到相关的镜像已经推送到了 Docker Hub 上

这时只需要在服务器上重新拉取最新的镜像,重新启动容器即可完成项目的更新

shell 复制代码
 docker pull zeroclian/cloud-gateway
 docker pull zeroclian/cloud-service
 docker run -di --name=cloud-gateway -p 9999:9999 zeroclian/cloud-gateway
 docker run -di --name=cloud-service -p 8001:8001 zeroclian/cloud-service

配置解析

  • name: 工作流名称,将显示在Actions的All workflows下
  • on: 配置触发工作流的事件动作,如push;也可以指定某个分支,排除某个文件
  • jobs: 作业组,配置需要执行的一系列步骤,顺序执行
    • name: 作业的名称,会显示到Github Action上,示例中为deploymentbuild
    • runs-on: 指定运行的服务器类型
    • steps: 需要执行的命令步骤
      • name: 步骤名
      • run: 执行脚本或运行shell命令
      • uses: 引用其他的workflows文件
      • with: 根据文件的说明,添加所需的配置参数

隐私参数,如用户名、密码等,使用${{ secrets.XXX }}或者${{ env.XXX }},参数可在setting里填写,避免泄漏。

其他workflows的引用可以直接在编辑文件的时候搜索使用

总结

至此通过简单的添加几个配置文件,完成了前后端的持续集成(CI),大大减少了重复操作,使我们可以专注于业务的开发。

相关推荐
韶君1 天前
Jenkins(CI/CD工具)
ci/cd·jenkins
极小狐1 天前
如何使用极狐GitLab 的外部状态检查功能?
数据库·ci/cd·gitlab·devops·mcp
高峰君主1 天前
全栈自动化:从零构建智能CI/CD流水线
运维·ci/cd·自动化
龙智DevSecOps解决方案1 天前
CI/CD解决方案TeamCity在游戏开发中的应用价值与优势分析
ci/cd·游戏开发·jetbrains·持续集成·teamcity
鱼饼6号2 天前
Jenkins Pipeline 构建 CI/CD 流程
linux·运维·服务器·ci/cd·容器·jenkins
qq_400552003 天前
CI/CD自动化部署(持续集成和持续交付/部署)
运维·ci/cd·自动化
云攀登者-望正茂4 天前
60个GitLab CI/CD 面试问题和答案
ci/cd·gitlab·devops
weisian1516 天前
云原生--CNCF-3-核心工具介绍(容器和编排、服务网格和通信、监控和日志、运行时和资源管理,安全和存储、CI/CD等)
安全·ci/cd·云原生
rider1896 天前
【3】CICD持续集成-k8s集群中安装Jenkins-agent(主从架构)
ci/cd·kubernetes·jenkins
梁萌8 天前
05-DevOps-Jenkins自动拉取构建代码2
运维·ci/cd·jenkins·devops·spring boot部署