Gitea 与 Drone 实践 - 愧怍的小站

之前搭建过 Gitlab，但是就只是搭建而已，并未实际使用，因为我大部分的代码还是存放在 Github 上。

并且大部分项目都是在 Vercel 上运行的（Vercel 是真好用），但是最近国内访问 vercel 情况不容乐观，貌似被墙了呜呜。然后 Gitlab 的资源占用非常严重，几乎占用了一半的服务器性能，可点我查看运行状态。与此同时，随着很多私有项目越来越多，使用 git 私有仓库以及 Vercel 部署，肯定不如自建私有 git 服务和自有服务器部署使用体验来好。

于是就想搭建一个轻量级仓库，同时支持 CI/CD。经过一番的调研，决定使用 Gitea 和 Drone 作为解决方案。

Gitea

Gitea 是一个开源社区驱动的轻量级代码托管解决方案，后端采用 Go 编写，采用 MIT 许可证.

你可以在横向对比 Gitea 与其它 Git 托管工具查看 gitea 与其他 git 工具的优势与缺陷。

安装

这里我选用 Docker 进行安装，安装文档可在官方文档中查看其他安装方式

docker-compose.yml
version: '3'

networks:
  gitea:
    external: false

volumes:
  gitea:
    driver: local

services:
  server:
    image: gitea/gitea:1.17.1
    container_name: gitea
    environment:
      - USER_UID=1000
      - USER_GID=1000
    restart: always
    networks:
      - gitea
    volumes:
      - gitea:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - '10800:3000'
      - '2221:22'

根据自身需求配置 docker-compose.yml 内容。运行 docker-compose up 等待部署

服务器防火墙与云服务安全组都需要开放端口才可访问，服务器ip:10800，将会出现如下界面

因为修改配置相对比较麻烦，所以在首次安装的时候，请根据实际需求进行配置安装。

修改配置

假设要修改其中的配置的话，gitea 的后台管理面板是无法直接修改的。需要到 /data/gitea/conf/app.ini 中修改，具体修改的配置参阅自定义 Gitea 配置 - Docs

注意

必须完全重启 Gitea 以使配置生效。

迁移仓库

从其他第三方 git 仓库迁移到 gitea，可以访问https://git.kuizuo.cn/repo/migrate 来迁移仓库

稍等片刻，取决于访问 github 仓库的速度。有可能还会迁移失败，就像下面这样。

所以可以申请访问令牌（Access Token），在 New Personal Access Token 处创建。迁移成功后，如下图所示

镜像仓库

很大部分时间，gitea 只能作为我的副仓库，或者说 github 的镜像仓库。

gitea 也提供镜像仓库的方案，官方文档Repository Mirror

Drone

由于 Gitea 并没有内置 CI/CD（持续集成/持续部署）的解决方案，所以需要配置第三方的，这里推荐使用 Drone CI。

Drone 是面向繁忙开发团队的自助服务持续集成平台。相对于常见的Jenkins，选中 Drone 的原因在于它非常简洁，不像 Jenkins 那样复杂，同时它拥有可以满足基本需求的能力，并且提供了许多实用的插件，如GitHub，Email，微信，钉钉等

安装

由于我们使用了 gitea，所以 drone 中选择 gitea 来安装，这是官方文档 Gitea | Drone，照着操作即可。

需要安装 Server 和 Runner，一个是 Drone 的服务，另一个用于检测 Git 记录，以重新构建项目。

这里贴下 drone 的 docker 配置（根据文档和自己部署的 git 服务配置来替换）。

server
docker run \
  --volume=/var/lib/drone:/data \
  --env=DRONE_GITEA_SERVER=https://try.gitea.io \
  --env=DRONE_GITEA_CLIENT_ID=05136e57d80189bef462 \
  --env=DRONE_GITEA_CLIENT_SECRET=7c229228a77d2cbddaa61ddc78d45e \
  --env=DRONE_RPC_SECRET=super-duper-secret \
  --env=DRONE_SERVER_HOST=drone.company.com \
  --env=DRONE_SERVER_PROTO=https \
  --publish=80:80 \
  --publish=443:443 \
  --restart=always \
  --detach=true \
  --name=drone \
  drone/drone:2

runner
docker run --detach \
  --volume=/var/run/docker.sock:/var/run/docker.sock \
  --env=DRONE_RPC_PROTO=https \
  --env=DRONE_RPC_HOST=drone.company.com \
  --env=DRONE_RPC_SECRET=super-duper-secret \
  --env=DRONE_RUNNER_CAPACITY=2 \
  --env=DRONE_RUNNER_NAME=my-first-runner \
  --publish=3000:3000 \
  --restart=always \
  --name=runner \
  drone/drone-runner-docker:1

查看连接情况

docker logs runner

执行完毕后，然后访问线上的 drone 服务，点击 CONTINUE 将会跳转到你的 Git 授权页面

点击应用授权，再次回到 drone，此时页面 Dashboard 列出了 gitea 的所有仓库（如果没有的话，可以点击右上角的 SYNC 来同步）。

实战

上述只是安装了，我们还需要编写 .drone.yml 配置文件来告诉 drone 我们要做什么，编写过程与 Github Action类似。相关文档: Pipeline | Drone

部署前端项目

这里就选用 antfu/vitesse 作为演示。这里省略 clone 仓库的步骤。进入到自己的 gitea 仓库，然后添加 .drone.yml 文件，内容如下：

kind: pipeline
type: docker
name: ci

steps:
  - name: install & build
    image: node
    commands:
      - npm config set registry http://mirrors.cloud.tencent.com/npm/
      - npm i -g pnpm
      - pnpm i
      - pnpm run build

  - name: upload
    image: appleboy/drone-scp
    settings:
      host:
        from_secret: host
      username:
        from_secret: username
      password:
        from_secret: password
      port: 22
      command_timeout: 2m
      target: /www/wwwroot/${DRONE_REPO_OWNER}/${DRONE_REPO_NAME}
      source:
        - ./dist

这里对 .drone.yml 配置进行详解：

其中 build 这个不用多说，与 node 构建相关的，不过多介绍。

upload 则使用appleboy/drone-scp插件，可以将构建出来的文件通过发送到服务器指定位置。在这里 source 对应就是构建的文件，target 则是要移动的位置，这里的 /www/wwwroot/${DRONE_REPO_OWNER}/${DRONE_REPO_NAME} 对应本项目为 /www/wwwroot/kuizuo/vitesse。此外 ssh 的 host，username，password 或 key，都作为环境变量（私有变量的方式传递，这在 drone 的控制台中可以设置）。

由于每次构建可能需要删除原有的已部署的资源文件，那么可以使用 appleboy/drone-ssh 插件来执行终端命令来删除，例如

kind: pipeline
name: default

steps:
  - name: deploy
    image: appleboy/drone-ssh
    environment:
        DEPLOY_PATH:
            from_secret: /www/wwwroot/${DRONE_REPO_OWNER}/${DRONE_REPO_NAME}
    settings:
        host:
            from_secret: host
        username:
            from_secret: username
        password:
            from_secret: password
        port: 22
        command_timeout: 2m
        envs: [DEPLOY_PATH]
        script:
            - rm -rf $${DEPLOY_PATH}

具体就因人而异了，这里我仅作为演示。

大致介绍完毕（其实已经介绍差不多了），有关更多插件可以参阅 drone 插件。这里开始演示，进入 drone 页面，找到仓库，默认情况下，所有仓库都处于未激活状态。

点击 ACTIVATE REPOSITORY 根据选项选择，点击右上角的NEW BUILD选择分支，添加 drone 环境变量（私有变量），即上面的 from_secret 后面的内容（host，username，password），即可开始运行。

静等 PIPELINE 执行完毕，结果如下

此时打开宝塔，跳转到指定目录下，就可以看到构建的内容都已经放到指定位置了

这时候只需要配置下 nginx，就能将页面展示到公网上，这里就不在这里赘述。当完成上述配置完毕后，每次只需要 pull request，drone 就会自动拉取 gitea 的代码，并开始执行.drone.yml中的任务。

部署 nest 项目

TODO。。。

参考文章

【CI/CD】搭建 drone 服务，构建前端 cicd 工作流，实现博客的自动化打包并部署 - 掘金 (juejin.cn)

单机部署 CI/CD 进阶版：宝塔+gitea+drone | Laravel China 社区 (learnku.com)

Gitea​

安装​

修改配置​

迁移仓库​

镜像仓库​

Drone​

安装​

实战​

部署前端项目​

部署 nest 项目​

参考文章​