# 部署流水线问题排查进度

**日期**: 2026-07-19

## 问题概述

K8s 部署时出现 `ImagePullBackOff` 错误，容器无法拉取私有 Registry 镜像。

## 根本原因

**Docker Registry 认证问题**：
- Registry (`192.168.123.199:5000`) 需要认证（用户名: `admin`）
- Gitea Actions workflow 使用 `secrets.REGISTRY_USERNAME` 和 `secrets.REGISTRY_PASSWORD`
- **这两个 secrets 在 Gitea 项目中尚未配置**，导致：
  1. workflow 的 `docker login` 失败
  2. `docker push` 虽然执行但实际未推送成功
  3. K8s 拉取镜像时认证失败 → `authorization failed: no basic auth credentials`

## 已完成的修复

### 1. Gitea Actions 配置修复（已推送）
- ✅ **lpt-fe**: 修复 `github.sha` → `gitea.sha`
- ✅ **lpt-be**: 修复 `github.sha` → `gitea.sha`，kubectl 版本改为 `v1.30.0`
- ✅ **lpt-ai**: 修复 `github.sha` → `gitea.sha`，kubectl 版本改为 `v1.30.0`

### 2. K8s Deployment 修复（已推送）
- ✅ 所有 Deployment YAML 添加 `imagePullSecrets: [name: regcred]`
- ✅ workflow 自动创建 `regcred` secret（使用 Gitea secrets）

### 3. Git 合并冲突
- ⚠️ **lpt-ai** 和 **lpt-be** 的 workflow 文件存在合并冲突标记
- 需要手动解决冲突后重新提交

## 待完成任务

### 关键步骤：配置 Gitea Secrets

需要在 Gitea 中为每个项目添加 Registry 认证信息：

**项目列表**:
- `lpt-fe`
- `lpt-be`
- `lpt-ai`

**操作步骤**（每个项目重复）:
1. 进入项目页面（如 `http://192.168.123.199:3000/cat/lpt-fe`）
2. Settings → Secrets
3. 添加两个 secrets：
   - Name: `REGISTRY_USERNAME`, Value: `admin`
   - Name: `REGISTRY_PASSWORD`, Value: `<htpasswd 对应的明文密码>`

**Registry 密码位置**: `/vol1/1000/registry/auth/htpasswd`（服务器 `192.168.123.199`）

### 次要任务

1. **解决 Git 合并冲突**
   - 文件: `lpt-ai/.gitea/workflows/deploy.yml:34-40`
   - 文件: `lpt-be/.gitea/workflows/deploy.yml:43-48`
   - 清理 `<<<<<<< HEAD`, `=======`, `>>>>>>> xxx` 标记

2. **验证部署**
   - 配置 secrets 后触发一次提交
   - 检查 workflow 日志中 `docker login` 和 `docker push` 是否成功
   - 检查 K8s Pod 是否正常启动：`kubectl get pods -n lpt`

## 其他发现的问题（非紧急）

### Jenkins 流水线（lpt-fe, lpt-be）
- 硬编码镜像标签（`0.0`），无法追溯版本
- lpt-be 健康检查时间过短（5秒），Spring Boot 启动通常需要 10-30 秒
- lpt-be Docker 网络配置可能冲突

### 流水线通用问题
- 缺少镜像清理机制
- 缺少部署失败回滚机制

## 技术细节

### Registry 认证验证
```bash
curl -I http://192.168.123.199:5000/v2/
# 返回: 401 Unauthorized
# Www-Authenticate: Basic realm="Registry Realm"
```

### htpasswd 文件内容
```
admin:$2y$05$PlW.emHsl9qePGTsQPNAzecCkyNWKFO252EpjcRNV9vC8Z9AkGGZ.
```

## 下一步操作清单

1. [ ] 在 Gitea 中配置 3 个项目的 Registry secrets
2. [ ] 解决 lpt-ai 和 lpt-be 的 workflow 合并冲突
3. [ ] 提交修复并触发 workflow
4. [ ] 验证部署成功

---

**备注**: 所有 K8s 配置文件修改已完成并推送到 Gitea，核心问题在于 Gitea Secrets 配置缺失。