# 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. 数据库准备
确保 MySQL 数据库已安装并运行，并创建 `xxl_job` 数据库：

```sql
CREATE DATABASE xxl_job DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

### 2. 数据库初始化
执行 XXL-JOB 提供的数据库初始化脚本 `/sql/xxl_job.sql`

### 3. 镜像准备
确保以下镜像已推送到镜像仓库：
- `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

## 配置说明

### 数据库连接
默认配置连接到名为 `mysql` 的 MySQL 服务：
- 数据库: xxl_job
- 用户名: root
- 密码: 123456

如需修改数据库连接信息，请编辑 `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. **数据库连接失败**: 确认 MySQL 服务是否正常运行

### 日志查看
```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
```