101 lines
2.3 KiB
Markdown
101 lines
2.3 KiB
Markdown
# 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
|
||
```
|
||
|