179 lines
5.0 KiB
Markdown
179 lines
5.0 KiB
Markdown
> 本文作者：丁辉
|
||
|
||
# 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 流程正常完成。
|