Docker五部曲之五：通过Docker和GitHub Action搭建个人CICD项目_其他编程

文章目录

项目介绍
dockerfile解析
compose.yml解析
github action解析
项目测试
结语

项目介绍

该项目是一个入门cicd-demo，它由以下几部分组成：

dockerfile：用于构建自定义镜像
compose.yml：用于搭建应用程序依赖环境并部署
deploy.yml：通过github actions连接腾讯云服务器并构建环境

通过这个demo，你可以：

从开发到部署所需的所有操作全部都在本地定义完成
不需要在服务器上手动安装任何软件即可完成部署
每次在代码合并到master时自动完成构建和部署

项目地址：cicd-blog
测试网址：www.ningyu.ink

在这里插入图片描述

dockerfile解析

这个dockerfile分为四个构建阶段：

base：构建基础镜像
dev：构建开发环境镜像
build：打包
prod：构建生产环境镜像

# syntax=docker/dockerfile:1

from eclipse-temurin:17-jdk-jammy as base
workdir /blog
copy .mvn/ .mvn
copy mvnw pom.xml ./
run chmod +x mvnw
run ./mvnw dependency:resolve
copy src ./src

from base as dev
expose 8080
run chmod +x mvnw
cmd ["./mvnw", "spring-boot:run"]

from base as build
run ./mvnw package

from eclipse-temurin:17-jre-jammy as prod
expose 8080
copy --from=build /blog/target/blog-*.jar /blog.jar
cmd ["java", "-jar", "/blog.jar"]

compose.yml解析

该文件包含两个profiles：

dev：开发环境，可使用docker compose --profiles dev up -d --build在本地运行
prod：生产环境：可使用docker compose --profiles prod up -d --build在服务器运行

services:
  blog-dev:
    build:
      context: .
      target: dev
    container_name: blog
    ports:
      - "8080:8080"
    environment:
      - mysql_url=jdbc:mysql://mysql/blog?servertimezone=asia/shanghai
    volumes:
      - ./:/blog
    networks:
      mysql-net:
    depends_on:
      - mysql-dev
    profiles:
      - dev

  blog-prod:
    build:
      context: .
      target: prod
    container_name: blog
    environment:
      - mysql_url=jdbc:mysql://mysql/blog?servertimezone=asia/shanghai
    volumes:
      - ./:/blog
    networks:
      mysql-net:
      nginx-net:
    depends_on:
      - mysql-prod
    profiles:
      - prod

  mysql-dev:
    image: mysql:8.0
    container_name: mysql
    ports:
      - "3306:3306"
    environment:
      - mysql_root_password=123456
      - mysql_database=blog
    volumes:
      - mysql_data:/var/lib/mysql
      - mysql_config:/etc/mysql/conf.d
      - ./sql/init.sql:/docker-entrypoint-initdb.d/init.sql
    networks:
      mysql-net:
    profiles:
      - dev

  mysql-prod:
    image: mysql:8.0
    container_name: mysql
    environment:
      - mysql_root_password=123456
      - mysql_database=blog
    volumes:
      - mysql_data:/var/lib/mysql
      - mysql_config:/etc/mysql/conf.d
      - ./sql/init.sql:/docker-entrypoint-initdb.d/init.sql
    networks:
      mysql-net:
    profiles:
      - prod

  nginx-dev:
    image: nginx
    container_name: nginx
    ports:
      - "80:80"
      - "443:443"
    environment:
      - nginx_host=ningyu.ink
      - nginx_port=80
    volumes:
      - ./nginx/templates:/etc/nginx/templates
      - ./nginx/nginx.conf:/etc/nginx/nginx.conf:ro
      - ./nginx/ssl:/etc/nginx/ssl
    networks:
      nginx-net:
    profiles:
      - dev

  nginx-prod:
    image: nginx
    container_name: nginx
    ports:
      - "80:80"
      - "443:443"
    environment:
      - nginx_host=ningyu.ink
      - nginx_port=80
    volumes:
      - ./nginx/templates:/etc/nginx/templates
      - ./nginx/nginx.conf:/etc/nginx/nginx.conf:ro
      - ./nginx/ssl:/etc/nginx/ssl
    networks:
      nginx-net:
    profiles:
      - prod

volumes:
  mysql_data:
  mysql_config:

networks:
  mysql-net:
    driver: bridge
  nginx-net:
    driver: bridge

nginx反向代理到容器以及ssl证书设置

nginx的所有配置都在项目下的nginx目录下并通过三个挂在绑定挂载到了容器中：

在这里插入图片描述
其中：

ssl：用于存放ssl证书
templates：用于存放前端代码
nginx.conf：用于自定义配置

由于本项目还没有前端代码，所以在访问时直接代理到了后端接口，具体配置如下：

http {
    include       mime.types;
    default_type  application/octet-stream;
    sendfile        on;
    keepalive_timeout  65;

    server {
     listen 443 ssl;
     server_name ningyu.ink;
     ssl_certificate  /etc/nginx/ssl/ningyu.ink_bundle.crt;
     ssl_certificate_key /etc/nginx/ssl/ningyu.ink.key;
     ssl_session_timeout 5m;
     ssl_ciphers ecdhe-rsa-aes128-gcm-sha256:ecdhe:ecdh:aes:high:!null:!anull:!md5:!adh:!rc4;
     ssl_protocols tlsv1.2 tlsv1.3;
     ssl_prefer_server_ciphers on;
        location / {
          proxy_pass http://blog:8000/test/log;
        }
    }

    server {
        listen       80;
        server_name  ningyu.ink;
        return 301 https://$host$request_uri;
    }
}

其中我们将80端口转发到了443端口，并且在配置文件中可以直接使用容器名称进行网络代理（前提是在同一网络下）：

在这里插入图片描述

mysql的准备工作

mysql的compose.yml构建语法是这样的：

  mysql-prod:
    image: mysql:8.0
    container_name: mysql
    environment:
      - mysql_root_password=123456
      - mysql_database=blog
    volumes:
      - mysql_data:/var/lib/mysql
      - mysql_config:/etc/mysql/conf.d
      - ./sql/init.sql:/docker-entrypoint-initdb.d/init.sql
    networks:
      mysql-net:
    profiles:
      - prod

它做了以下事情：

传递了两个环境变量：
- mysql_root_password指定了root密码
- mysql_database指定了容器运行后需要创建的数据库
绑定了三个卷：其中第三个指定了一个在项目目录/sql/init.sql的初始化脚本，该脚本用于在数据库中创建应用需要的表

spring和环境变量的交互

可以看到application.yml内容是这样的：

server:
  port: 8080

spring:
  application:
    name: blog
  datasource:
    username: ${mysql_user:root}
    password: ${mysql_password:123456}
    url: ${mysql_url:jdbc:mysql://localhost/blog?servertimezone=asia/shanghai}
    driver-class-name: com.mysql.cj.jdbc.driver

mybatis:
  mapper-locations: classpath:mapper/*.xml

其中通过${}读取的环境变量值都是在compose.yml中定义的，这极大增强了灵活性。

github action解析

github action通过.github/workflows下的deploy.yml起作用，其文件内容是这样的：

name: deploy
on:
  push:
    branches:
      - master
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: deploy to tencent server
        uses: appleboy/ssh-action@v1.0.3
        with:
          host: ${{ secrets.remote_host}}
          key: ${{ secrets.server_ssh_key }}
          username: ${{ secrets.remote_user }}
          script: |
            # 切换到主目录
            cd ~ || exit
            # 判断是否安装了docker，如果没有则使用官方提供的脚本安装docker
            if ! command -v docker &> /dev/null ; then
              curl -fssl https://get.docker.com -o get-docker.sh
              sh get-docker.sh
            fi
            # 判断是否拉拉取了代码，没有拉取则拉取
            if [ ! -d "./blog" ]; then
              git clone https://github.com/chinesecooly/blog.git
            fi
            # 进入工作目录
            cd blog || exit
            # 更新代码
            git pull
            # 运行prod环境下的构建，并且每次都重新构建镜像
            docker compose --profile prod up -d --build

它的作用如下：

当向master分支推送代码时就自动运行该action
使用了一个别人定义好的action（appleboy/ssh-action@v1.0.3）通过ssh连接到了腾讯云服务器，这个action需要三个参数（with语句中指定的），这三个参数存储在以下位置，需要根据自己的服务器配置。
最后与执行了一个shell脚本，该脚本有以下功能：
- 首先检查服务器上是否安装了docker，如果没安装则下官方提供的shell脚本进行安装
- 再检查是否拉取了代码，如果没拉取则拉取
- 然后进入项目目录并更新代码
- 最后使用docker compose --profile prod up -d --build命令部署项目，--profile选项指定了选取的profile，-d选项指定了容器在后台运行，--build选项指定了每次运行这条指令时都重新构建镜像，这保证了我们每次更新的代码都能署到服务器上

项目测试

以下controller是该项目提供的一个测试controller，他完成了一次接收请求、操作数据库、做出响应的过程：

@slf4j
@restcontroller
@requestmapping("/test")
public class testcontroller {
    @resource
    private testmapper testmapper;

    @getmapping("/log")
    public result log() {
        test test = new test();
        test.setmsg("a get request");
        test.setdata(localdatetime.now());
        testmapper.insert(test);
        return result.success(test);
    }
}

项目部署后访问一下是这样的：

在这里插入图片描述

我们在dev修改一下代码：

@slf4j
@restcontroller
@requestmapping("/test")
public class testcontroller {
    @resource
    private testmapper testmapper;

    @getmapping("/log")
    public result log() {
        test test = new test();
        test.setmsg("a get request after one push");
        test.setdata(localdatetime.now());
        testmapper.insert(test);
        return result.success(test);
    }
}