yadd/lemonldap-ng-cron

yadd/lemonldap-ng-cron

镜像概述和主要用途

yadd/lemonldap-ng-cron是一个专用的cron服务镜像，用于维护LemonLDAP::NG（LLNG）的会话数据库。当部署多个LLNG门户实例时，需禁用门户中的cron功能，通过此镜像执行会话数据库的维护任务，确保会话数据的一致性和清理工作正常进行。

核心功能和特性

• 核心功能：运行LLNG会话数据库的维护任务，包括会话清理、数据一致性检查等
• 主要特性：
  • 独立部署，不依赖门户实例的cron服务
  • 专为多门户实例场景设计，支持集中式维护
  • 与LLNG生态组件（门户、数据库、缓存服务）无缝集成

使用场景和适用范围

适用于部署了多个LemonLDAP::NG门户实例的场景，需要集中管理会话数据库维护任务。典型应用包括：

• 企业级SSO（单点登录）系统，多门户实例负载均衡部署
• 需要确保会话数据定时清理和维护的LLNG环境
• 对会话数据一致性要求高的生产环境

详细使用方法和配置说明

环境变量配置

该镜像通过环境变量进行配置，常用环境变量如下：

Docker Compose部署示例

以下是使用docker-compose部署的完整示例，包含LLNG数据库、Redis、多门户实例、cron服务等组件：

yaml
services:
  # LLNG PostgreSQL数据库
  llng-db:
    image: yadd/lemonldap-ng-pg-database
    environment:
      - POSTGRES_PASSWORD=pwd  # 数据库密码
    healthcheck:
      test: ["CMD-SHELL", "pg_isready"]  # 健康检查命令
      interval: 10s  # 检查间隔
      timeout: 5s    # 超时时间
      retries: 5     # 重试次数

  # Redis缓存服务
  redis:
    image: redis

  # LLNG门户实例（多实例部署）
  auth:
    image: yadd/lemonldap-ng-portal
    hostname: auth.example.com
    environment:
      - SSODOMAIN=example.com          # SSO域
      - PORTAL=https://auth.example.com # 门户URL
      - LOGLEVEL=notice                # 日志级别
      - LOGGER=stderr                  # 日志输出目标
      - USERLOGGER=stderr              # 用户日志输出目标
      - PG_SERVER=llng-db              # PostgreSQL服务器地址
      - REDIS_SERVER=redis:6379        # Redis服务器地址
      - PORTAL_CRON=no                 # 禁用门户内置cron
    depends_on:
      llng-db:
        condition: service_healthy     # 依赖数据库服务健康
    scale: 3                           # 部署3个门户实例
    networks:
      - db
      - frontend
      - sso

  # cron服务（会话数据库维护）
  cron:
    image: yadd/lemonldap-ng-cron
    environment:
      - SSODOMAIN=example.com          # SSO域，需与门户一致
      - PORTAL=https://auth.example.com # 门户URL，需与门户一致
      - LOGLEVEL=notice                # 日志级别
      - LOGGER=stderr                  # 日志输出目标
      - USERLOGGER=stderr              # 用户日志输出目标
      - PG_SERVER=llng-db              # 连接LLNG数据库
      - REDIS_SERVER=redis:6379        # 连接Redis缓存
    depends_on:
      llng-db:
        condition: service_healthy     # 依赖数据库服务健康
      auth:
        condition: service_started     # 依赖门户实例启动

  # LLNG管理界面（可选）
  manager:
    image: yadd/lemonldap-ng-manager
    environment:
      - SSODOMAIN=example.com
      - PORTAL=https://auth.example.com
      - PG_SERVER=llng-db
      - REDIS_SERVER=redis:6379
      - LOGLEVEL=notice
      - LOGGER=stderr
      - USERLOGGER=stderr
    depends_on:
      llng-db:
        condition: service_healthy
      redis:
        condition: service_started
      auth:
        condition: service_started
    networks:
      - db
      - frontend
      - sso

  # 负载均衡（可选）
  haproxy:
    image: haproxy:2.6-bullseye
    ports:
      - 443:443  # 映射HTTPS端口
    volumes:
      - ./haproxy:/usr/local/etc/haproxy:ro  # HAProxy配置
      - ./ssl/both.pem:/etc/ssl/certs/both.pem  # SSL证书
    sysctls:
      - net.ipv4.ip_unprivileged_port_start=0  # 允许非特权用户使用低端口
    depends_on:
      - auth
      - manager

networks:
  db:
  frontend:
  sso:

部署注意事项

1. 依赖关系：cron服务需依赖LLNG数据库服务健康和门户实例启动，配置depends_on确保启动顺序
2. 多实例配置：门户实例需设置PORTAL_CRON=no禁用内置cron，避免维护任务重复执行
3. 环境变量一致性：cron服务的环境变量（如SSODOMAIN、PORTAL、数据库连接信息）需与门户实例保持一致
4. 网络配置：确保cron服务与数据库、Redis和门户实例在同一网络中，能够正常通信