CKAN 官方 Docker 镜像文档

1. 镜像概述与主要用途

本镜像为 CKAN（开源数据门户平台）的官方 Docker 镜像，旨在简化 CKAN 的部署与管理。镜像分为基础镜像（base）和开发镜像（dev）两种类型，通常需与 PostgreSQL、Solr 等依赖组件配合，通过 Docker Compose 实现完整的 CKAN 平台部署。官方推荐的部署方案可参考 ckan-docker 仓库。

2. 核心功能与特性

• 预配置环境：内置 CKAN 运行所需的基础依赖与默认配置，减少手动部署复杂度。
• 环境区分：提供基础镜像（生产环境优化）与开发镜像（含调试工具与热重载支持）。
• 版本覆盖：支持稳定版本（2.10、2.11）及开发分支（master），满足不同场景需求。
• 精确版本控制：提供包含补丁版本的标签（如 2.10.5），确保部署版本一致性。

3. 适用场景

• 生产环境：使用基础镜像部署稳定的 CKAN 数据门户，适用于政府、科研机构、企业的数据共享与管理需求。
• 开发环境：通过开发镜像进行 CKAN 扩展开发、功能定制或代码调试。
• 快速验证：利用容器隔离性快速搭建测试环境，验证新配置或扩展功能。

4. 镜像版本与标签

以下为支持的 CKAN 版本及对应 Docker 镜像标签说明：

注：镜像同时提供精确补丁版本标签，如 ckan/ckan-base:2.10.5 或 ckan/ckan-dev:2.10.5，用于指定具体补丁版本。

5. 使用方法

5.1 Docker Compose 部署示例

CKAN 需与数据库、搜索引擎等组件协同工作，推荐通过 Docker Compose 部署。以下为简化配置（完整配置见 ckan-docker）：

# docker-compose.yml
version: '3'

services:
  ckan:
    image: ckan/ckan-base:2.11  # 使用基础镜像（生产环境）
    ports:
      - "5000:5000"  # CKAN 服务端口
    environment:
      - CKAN_SITE_URL=http://localhost:5000  # 站点访问 URL
      - CKAN_DB_USER=ckan  # 数据库用户名
      - CKAN_DB_PASSWORD=secure_password  # 数据库密码
      - CKAN_DB_HOST=db  # 数据库服务名（对应下方 db 容器）
      - CKAN_DB_PORT=5432  # 数据库端口
      - CKAN_DB_NAME=ckan  # 数据库名称
      - CKAN_SOLR_URL=[***]  # Solr 服务 URL
    depends_on:
      - db
      - solr

  db:
    image: postgres:13  # CKAN 兼容的 PostgreSQL 版本
    environment:
      - POSTGRES_USER=ckan
      - POSTGRES_PASSWORD=secure_password
      - POSTGRES_DB=ckan
    volumes:
      - postgres_data:/var/lib/postgresql/data  # 持久化数据库数据

  solr:
    image: ckan/solr:latest  # CKAN 预配置 Solr 镜像
    volumes:
      - solr_data:/var/solr/data  # 持久化 Solr 数据

volumes:
  postgres_data:
  solr_data:

启动命令：

docker-compose up -d

5.2 开发环境使用（dev 镜像）

开发镜像包含代码热重载、调试工具等特性，适合扩展开发：

# 克隆官方开发仓库
git clone [***]
cd ckan-docker

# 使用开发环境配置启动（需仓库中包含 docker-compose.dev.yml）
docker-compose -f docker-compose.dev.yml up -d

6. 镜像构建与推送

若需本地构建或向 DockerHub 推送镜像（需权限），可通过以下步骤操作：

6.1 构建基础镜像（base）

以 CKAN 2.11 基础镜像为例：

# 进入对应版本的基础镜像目录
cd ckan-2.11/base

# 本地构建
make build

# 推送至 DockerHub（需权限）
make push

6.2 构建开发镜像（dev）

以 CKAN 2.10 开发镜像为例：

# 进入对应版本的开发镜像目录
cd ckan-2.10/dev

# 本地构建
make build

# 推送至 DockerHub（需权限）
make push

其他版本（如 2.9、master）的构建步骤类似，进入对应版本的 base 或 dev 目录执行 make build 或 make push 即可。

7. 注意事项

• 旧版本支持：旧版 CKAN 镜像可能通过 镜像标签 获取，但根据 CKAN 发布政策，这些版本不再提供官方支持，建议使用 2.10 或 2.11 稳定版。
• 标签选择：生产环境建议使用精确补丁版本标签（如 2.11.1），避免自动更新导致兼容性问题。
• 依赖兼容性：确保 PostgreSQL、Solr 等依赖组件版本与 CKAN 兼容（参考 CKAN 官方文档）。