> 本文作者：丁辉

# Helm部署Drone

[官方文档](https://docs.drone.io/)

[官方中文文档](https://drone.cool/)

## 介绍

**Drone 是一个开源的持续集成和持续部署（CI/CD）平台，广泛用于自动化代码构建、测试和发布流程**。

## 开始部署

1. 添加 Drone Helm Chart 存储库

   ```bash
   helm repo add drone https://charts.drone.io
   helm repo update
   ```

2. 创建命名空间

   ```bash
   kubectl create namespace drone
   ```

3. 部署 Postgres

   ```bash
   kubectl apply -f https://gitee.com/offends/Kubernetes/raw/main/File/Yaml/drone-postgres.yaml
   ```

4. 生成密钥

   ```bash
   openssl rand -hex 16
   ```

5. 进入 Github 创建 OAuth2 应用获取 `DRONE_GITHUB_CLIENT_ID` 和 `DRONE_GITHUB_CLIENT_SECRET`

6. 生成 Secret

   > 对接 Gitea 参数替换如下：
   >
   > DRONE_GITEA_CLIENT_ID
   >
   > DRONE_GITEA_CLIENT_SECRET

   ```bash
   kubectl create secret generic drone-secret \
     --from-literal=DRONE_RPC_SECRET=填入密钥 \
     --from-literal=DRONE_GITHUB_CLIENT_ID=填入Github-ID \
     --from-literal=DRONE_GITHUB_CLIENT_SECRET=填入Github-SECRET \
     --from-literal=DRONE_GIT_USERNAME=配置Github用户名 \
     --from-literal=DRONE_GIT_PASSWORD=配置Github密码 \
     --from-literal=DRONE_USER_CREATE=username:填入管理员用户名,admin:true \
     -n drone
   ```

   **参数解释**

   | 参数                          | 描述                                                         |
   | ----------------------------- | ------------------------------------------------------------ |
   | `DRONE_RPC_SECRET=`           | 将名为`DRONE_RPC_SECRET`的密钥添加到Secret中，用于Drone CI/CD工具的RPC通信和验证。 |
   | `DRONE_GITHUB_CLIENT_ID=`     | 将GitHub OAuth应用程序的客户端ID添加到Secret中。             |
   | `DRONE_GITHUB_CLIENT_SECRET=` | 将GitHub OAuth应用程序的客户端密钥添加到Secret中。           |
   | `DRONE_GIT_USERNAME=`         | 将GitHub用户名添加到Secret中，用于访问GitHub仓库。           |
   | `DRONE_GIT_PASSWORD=`         | 将GitHub密码添加到Secret中，用于访问GitHub仓库。             |
   | `DRONE_USER_CREATE=username:` | 指定在Drone启动时创建的用户信息，包括用户名和角色（管理员）。 |

7. 编写模版文件

   > 对接 Gitea 参数替换如下：
   >
   > DRONE_GITEA_SERVER

   ```bash
   vi drone-values.yaml
   ```

   内容如下

   ```yaml
   # 开启 ingress 对外访问
   ingress:
     enabled: true
     className: "" # 指定 ingress 控制器, 不指定则需要集群内存在默认的 ingress 控制器
     hosts:
       - host: # 域名
         paths:
           - path: /
             pathType: Prefix
     tls:
       - secretName: drone-tls
         hosts:
           - # 域名
     
   env:
     DRONE_GITHUB_SERVER: https://github.com #仓库地址
     DRONE_SERVER_HOST: #域名
     DRONE_SERVER_PROTO: https
     DRONE_DATABASE_DRIVER: postgres
     DRONE_DATABASE_DATASOURCE: postgres://postgres:postgres@drone-db:5432/drone?sslmode=disable
   extraSecretNamesForEnvFrom:
     - drone-secret
   persistentVolume:
     enabled: false
   ```

   > 其他参数
   >
   > ```bash
   > # oauth会验证gitlab证书，如果验证不过，需要打开
   > DRONE_GITLAB_SKIP_VERIFY: true
   > ```

8. 安装

   ```bash
   helm install drone drone/drone -f drone-values.yaml -n drone
   ```

## 卸载

1. 卸载 drone

   ```bash
   helm uninstall drone -n drone
   ```

2. 删除 secret

   ```bash
   kubectl delete secret drone-secret -n drone
   ```

3. 删除命名空间

   ```bash
   kubectl delete namespace drone
   ```

# 问题记录

> 2025-8-25遇到 Drone 对接 Gitea 时报错
>
> ```bash
> You will be redirected to your source control management system to authenticate
> ```

## 根本原因

- Gitea 将 Drone 的 OAuth2 应用识别为 **Public Client（公开客户端）**，默认要求 **PKCE（Proof Key for Code Exchange）**。
- Drone 作为传统 CI/CD 工具不支持 PKCE，因此在交换授权码时，Gitea拒绝了请求，返回 `invalid_request` 和 `PKCE is required for public clients`。

------

## 解决思路

1. 确认 Gitea 日志中报错 `PKCE is required for public clients`，确定是 Gitea OAuth2 客户端类型问题。
2. 将 Drone 在 Gitea 中注册的 OAuth2 应用改为 **Confidential Client（机密客户端）**，避免 PKCE 校验。
3. 更新 Drone 使用新的 Client ID / Secret，确保 OAuth2 授权流程可用。

------

## 最终解决方案

1. **在 Gitea 中重新创建 OAuth2 应用**：
   - 登录 Gitea → `Settings` → `Applications` → `Manage OAuth2 Applications` → `New OAuth2 Application`
   - **Redirect URI**：`https://域名/login`
   - **勾选 Confidential Client（机密客户端）**
   - 保存并获取新的 **Client ID** 和 **Client Secret**。
2. **更新 Drone 配置**：
   - 在 Kubernetes Secret 中更新
   - 重启 Drone 服务。
3. **重新访问 Drone**：
   - 打开 `https://域名/login` ，用 Gitea 登录授权，验证 OAuth2 流程正常完成。