devops/xxljob/README.md

95 lines
2.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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
```