devops/xxljob

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

安装步骤

方法一：使用安装脚本（推荐）

chmod +x install-xxljob.sh
./install-xxljob.sh

方法二：手动安装

# 应用部署配置
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 文件。

验证安装

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

# 检查 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 重启后数据会丢失

日志查看

kubectl logs -l app=xxl-job-admin

卸载

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

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