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. 数据库准备

确保 MySQL 数据库已安装并运行，并创建 xxl_job 数据库：

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

安装步骤

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

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

配置说明

数据库连接

默认配置连接到名为 mysql 的 MySQL 服务：

• 数据库: xxl_job
• 用户名: root
• 密码: 123456

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

日志查看

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