Drone 使用指南¶

预计阅读时长 : 3 分钟

Drone 是一个基于 Docker 的轻量级 CI/CD 平台，可以用于自动化构建、测试和部署应用程序。

通过在 VPS 上部署 Drone，可以结合 Git 仓库即可实现自动化构建、测试和部署应用程序。

部署 Drone¶

部署 Drone 需要先确定使用的 Git 服务。如果使用 Github 作为 Git 服务可以参照官方 GitHub 教程 ⧉ 进行配置。

配置并在 VPS 上部署完毕之后，即可登录 Drone 管理页面，进行 Github 的账号授权，之后所有和 Git 相关的操作都无需再进行重复授权。

激活 Project¶

在初次进入 Drone 管理页面以及在 Github 上新增仓库之后，需要点击右上角的 Sync 按钮，同步 Github 上的仓库列表。

然后，在列表中选择需要进行自动化操作的仓库，点击 Activate Repository 按钮，即可在 Drone 中激活该仓库。

如果该仓库涉及的后续操作，需要访问宿主机上的文件系统，那么还要进入仓库配置页面，在 Settings 标签下，打开 Project Settings 里的 Trusted 选项，启用 privileged 模式。

创建 Pipeline¶

Drone 使用 Pipeline 来执行具体的构建任务，要创建 Pipeline，首先需要在项目的根目录下创建 .drone.yml 文件。

具体的 Docker 类型 Pipeline 配置文件的语法可以参考官方文档 ⧉。

pipeline 示例
kind: pipeline
type: docker
name: sync-libukai

trigger:
  branch:
    - main
  event:
    - push
    - cron

steps:
  - name: sync-repo
    image: alpine/git
    volumes:
      - name: docs-directory
        path: /docs
    commands:
      - cd /docs
      - git config --global --add safe.directory /docs
      - git fetch origin main
      - git reset --hard origin/main

volumes:
  - name: docs-directory
    host:
      path: /home/git/mkdocs/libukai

执行 Pipeline¶

在创建完毕 Pipeline 之后，推送更新到 Github，即可根据触发条件触发 Drone 执行 Pipeline。