1、监控部署平台介绍

fops是一款包含：Docker集群管理、自动化部署、调度中心管理（FSchedule2.x)、日志采集、链路追踪、健康检查一体的小型轻量平台

基于docker环境进行部署和管理，通过简单的button click快速发布您的应用和监控应用的健康状态。

2、功能

集群管理：实时检查集群所有节点的健康状态。
应用部署：将Git仓库的代码、编译打包成docker镜像并发布到DockerSwarm集群（本地或远程集群）。
健康状态：实时检测应用的运行状态。
日志采集：实时查询Docker日志，以及通过farseer-go框架接入的应用，提供更精准的日志查询。
调度中心：提供FSchedule2.0的任务管理、监控、日志的Dashboard。
链路追踪：通过farseer-go框架接入的链路追踪，提供数据查询。
慢查询：支持db、Redis、http、es、mq 详细调用报告。
配置中心：提供应用的配置管理（未提供UI查询）
访问统计：提供各个链路的性能统计

3、自动化部署

3.1 在fops中心新建你的应用，并配置好git仓库

3.2 配置工作流文件

工作流文件默认在应用的根目录：.fops/workflows/build.yml,如：

name: build
jobs:
  build:
    runs-on: steden88/cicd:3.0      # 工作流运行的容器镜像
    proxy: "192.168.1.123:7890"     # 配置工作环境的代理
    with:                           # 全局参数
      a: "可用于steps内，如{{a}}"
    env:
      GO111MODULE: on               # 配置构建容器环境变量
      GOPROXY: https://goproxy.cn   # 配置构建容器环境变量
      
    steps:
      - name: 开启Git代理
        uses: gitProxy@v1
        with:
          proxy: "socks5://192.168.1.123:7890"

      - name: 拉取应用Git
        uses: checkout@v1 # 在fops配置了依赖时，将自动拉取所有依赖Git

#      - name: 拉取框架fs
#        uses: checkout@v1
#        with:
#          gitHub: https://github.com/farseer-go/fs.git
#          gitBranch: main
#          gitUserName: test
#          gitUserPwd: 123456
#          gitPath: farseer-go/fs

      - name: 安装go
        uses: setup-go@v1
        with:
          goVersion: go1.22.5
          goDownload:

      - name: 编译
        run:
          - rm -rf ./go.work
          - go work init ./
          - go work edit -replace github.com/farseer-go/fs=../farseer-go/fs
          - go mod download
          - GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o ./fops -ldflags="-w -s" .

      - name: 安装npm
        uses: setup-npm@v1

      - name: 编译前端
        run:
          - mkdir wwwroot
          - cd ./wwwsrc
          - npm install
          - npm run build
          - cp -r dist/* ../wwwroot/

      - name: 打包镜像
        uses: dockerBuild@v1

      - name: 上传镜像
        uses: dockerPush@v1

      - name: 更新镜像
        uses: dockerswarmUpdateVer@v1

3.3 jobs.build.runs-on = steden88/cicd:3.0-npm

fops在构建时会启动jobs.build.runs-on指定的镜像，后续构建步骤将在该环境中执行。

目前fops官方提供：steden88/cicd:3.0-npm镜像。该镜像基于alpine:latest，在其中安装了git、docker等基础工具

3.4 jobs.build.steps

为定义的构建步骤，根据该顺序逐个执行。

jobs.build.steps.name：自定义的步骤名称
jobs.build.steps.uses：使用的action名称，规则为：名称@版本。也可自定义实现action。
jobs.build.steps.with：定义参数，参数由action要求定义
jobs.build.steps.run：运行shell脚本

3.5 Action

fops目前为大家提供了8个常用的action程序：点这里查看

3.5.1 gitProxy: git代理

配置通过代理来拉取git仓库时，因为我们经常github无法访问。则可用这个action。需要你自己提供proxy

3.5.2 checkout: 拉取git

如果你在fops中定义了依赖仓库，则会同时把这些依赖仓库一同拉取下来。

同时，如果你需要拉取未配置在fops的git。可通过with参数来指定仓库地址，如：

      - name: 拉取框架fs
        uses: checkout@v1
        with:
          gitHub: https://github.com/farseer-go/fs.git
          gitBranch: main
          gitUserName: test
          gitUserPwd: 123456
          gitPath: farseer-go/fs

如果你需要拉取多个，则定义多次该action即可。

gitPath用于你希望存储到本地相对路径下的哪个目录。用于后续打包时使用。

3.5.4 setup-go：安装go

      - name: 安装go
        uses: setup-go@v1
        with:
          goVersion: go1.22.5 #指定版本
          goDownload: # 自定义下载链接，可不填

3.5.5 run：运行shell

通过run配置，可自定义要执行的shell脚本，

      - name: 编译
        run:
          - rm -rf ./go.work
          - go mod download
          - GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o ./fops -ldflags="-w -s" .

3.5.6 setup-npm：安装npm

也可搭配run，在执行完setup-npm后，运行run定义的shell脚本

      - name: 安装npm
        uses: setup-npm@v1
        run: # 安装cnpm
          - npm install -g cnpm --registry=https://registry.npmmirror.com/

3.5.7 dockerBuild：打包镜像

将根据集群中定义的docker配置，对编译完的程序进行打包。

默认情况下，Dockerfile文件定义在应用的仓库根目录中如需更改路径，请到应用中心修改

      - name: 打包镜像
        uses: dockerBuild@v1

3.5.8 dockerPush：上传镜像

上传到集群定义的镜像hub，将在镜像打包成功后上传。

可以配置docker官网hub或私有hub，配置请到集群中修改

      - name: 上传镜像
        uses: dockerPush@v1

3.5.9 dockerswarmUpdateVer：更新镜像

将镜像部署到当前集群

      - name: 更新镜像
        uses: dockerswarmUpdateVer@v1

如果需要更新到远程集群，可以使用remoteClusterId参数：

      - name: 更新镜像
        uses: dockerswarmUpdateVer@v1
        with:
          remoteClusterId: 1

fops是如何知道远程集群的地址，这需要在远程集群中安装好fops。同时在本地的集群配置中设置好远程fops地址。

farseers/FOPS