ckan/ckan-base-datapusher

ckan-base-datapusher 镜像文档

1. 镜像概述和主要用途

ckan-base-datapusher 是 CKAN DataPusher 扩展的官方 Docker 镜像，提供预配置的 DataPusher 服务环境，主要用于实验性部署。

DataPusher 是 CKAN 的数据推送工具，用于将 CSV 等格式的数据自动导入 CKAN 数据存储。截至 2024 年 2 月，官方正推进用 XLoader 替代 DataPusher，本镜像仓库将用于过渡期的功能过渡与兼容性支持。

源代码地址：https://github.com/ckan/ckan-docker-base

2. 核心功能和特性

• 容器化部署：标准化容器封装，简化 DataPusher 服务的部署流程，降低环境依赖复杂度。
• 预配置环境：内置基础配置，减少手动配置步骤，开箱即可用于实验场景。
• 版本化支持：提供多个 DataPusher 版本标签，满足不同实验需求。

3. 使用场景和适用范围

• CKAN 实验性部署：需要快速验证 DataPusher 功能的场景。
• 开发/测试环境：为 CKAN 实例开发或测试数据推送功能时使用。
• 过渡期兼容：在 XLoader 完全替代 DataPusher 前，作为过渡方案使用。

4. 使用方法和配置说明

4.1 镜像获取

从 Docker 仓库拉取指定版本镜像（以最新版本 0.0.21 为例）：

bash
docker pull docker.xuanyuan.run/ckan-base-datapusher:0.0.21

4.2 基本运行示例（docker run）

bash
docker run -d \
  --name datapusher \
  -p 8800:8800 \  # DataPusher 默认服务端口
  -e CKAN_SITE_URL=http://ckan:5000 \  # 连接的 CKAN 实例 URL
  ckan-base-datapusher:0.0.21

4.3 Docker Compose 配置示例

yaml
version: '3'
services:
  datapusher:
    image: docker.xuanyuan.run/ckan-base-datapusher:0.0.21
    ports:
      - "8800:8800"
    environment:
      - CKAN_SITE_URL=http://ckan:5000  # CKAN 实例基础 URL
      - DATAPUSHER_MAX_CONTENT_LENGTH=10485760  # 最大请求体大小（10MB）
      - DATAPUSHER_REDIS_URL=redis://redis:6379/0  # Redis 任务队列地址（如使用）
    depends_on:
      - ckan  # 依赖的 CKAN 服务
      - redis  # 依赖的 Redis 服务（如使用）
    restart: unless-stopped

4.4 配置参数与环境变量

可通过环境变量调整 DataPusher 行为，常见参数包括：

• CKAN_SITE_URL：必填，CKAN 实例的基础 URL，用于 DataPusher 与 CKAN 通信。
• DATAPUSHER_MAX_CONTENT_LENGTH：允许的最大请求体大小（字节），默认 10485760（10MB）。
• DATAPUSHER_REDIS_URL：Redis 服务 URL，用于任务队列（若使用 Redis 作为后端）。
• DATABASE_URL：数据库连接 URL（如使用 PostgreSQL 存储任务状态），格式：postgresql://user:pass@host:port/dbname。

注：完整配置参数及默认值可参考 https://github.com/ckan/ckan-docker-base 中的配置文件。

5. 版本信息

不同 DataPusher 版本对应以下 Docker 镜像标签：