devops/xxljob/README.md

# XXL-JOB 安装说明

## 概述
XXL-JOB 是一个分布式任务调度平台，本目录包含了在 Kubernetes 集群中部署 XXL-JOB 的所有配置文件。

## 文件说明
- `xxljob-deployment.yaml` - XXL-JOB Admin 部署配置
- `xxljob-service.yaml` - XXL-JOB Admin 服务配置
- `xxljob-ingress.yaml` - XXL-JOB Admin 入口配置
- `install-xxljob.sh` - 自动安装脚本

## 安装前准备

### 1. 数据库配置
本部署使用 H2 内存数据库，无需额外配置数据库服务。H2 数据库会在应用启动时自动创建和初始化。

### 2. 镜像准备
确保以下镜像已推送到镜像仓库：
- `registry.t-aaron.com/xxl-job/xxl-job-admin:latest`

## 安装步骤

### 方法一：使用安装脚本（推荐）
```bash
chmod +x install-xxljob.sh
./install-xxljob.sh
```

### 方法二：手动安装
```bash
# 应用部署配置
kubectl apply -f xxljob-deployment.yaml

# 应用服务配置
kubectl apply -f xxljob-service.yaml

# 应用入口配置
kubectl apply -f xxljob-ingress.yaml
```

## 访问信息
- **访问地址**: https://xxljob-ops.t-aaron.com
- **默认用户名**: admin
- **默认密码**: 123456

## 配置说明

### 数据库连接
默认配置使用 H2 内存数据库：
- 数据库: xxl_job (内存数据库)
- 用户名: sa
- 密码: (空)
- 驱动: org.h2.Driver

如需修改数据库连接信息，请编辑 `xxljob-deployment.yaml` 文件中的 `PARAMS` 环境变量。

### 访问令牌
默认访问令牌为 `default_token`，如需修改请编辑 `xxljob-deployment.yaml` 文件。

## 验证安装
安装完成后，可以通过以下命令检查部署状态：

```bash
# 检查 Pod 状态
kubectl get pods -l app=xxl-job-admin

# 检查服务状态
kubectl get svc xxl-job-admin

# 检查入口状态
kubectl get ingress xxl-job-admin-ingress
```

## 故障排除

### 常见问题
1. **Pod 启动失败**: 检查镜像是否正确拉取
2. **无法访问**: 检查 Ingress 配置和域名解析
3. **数据丢失**: H2 是内存数据库，Pod 重启后数据会丢失

### 日志查看
```bash
kubectl logs -l app=xxl-job-admin
```

## 卸载
如需卸载 XXL-JOB，执行以下命令：

```bash
kubectl delete -f xxljob-ingress.yaml
kubectl delete -f xxljob-service.yaml
kubectl delete -f xxljob-deployment.yaml
```