eccenca/ckan-docker

eccenca/ckan-docker镜像中文文档

镜像概述

eccenca/ckan-docker是开源数据管理系统CKAN的Docker化部署方案，包含CKAN主程序、Solr（搜索服务）、PostgreSQL（数据库服务）的镜像构建与运行配置，帮助用户快速搭建数据发布、分享和管理平台。

核心功能

1. 提供CKAN及其依赖服务（Solr、PostgreSQL）的Docker镜像构建流程
2. 支持通过环境变量自定义CKAN配置（如站点URL、调试模式、插件、邮件设置等）
3. 简化CKAN部署步骤，便于快速启动和测试

使用场景

• ***部门搭建公共数据开放门户
• 科研机构构建数据共享平台
• 企业内部数据资产管理与协作
• 开发人员测试CKAN功能或进行二次开发

配置说明

CKAN容器启动时会生成ckan.ini配置文件，可通过docker run的-e参数设置以下环境变量：

通用设置

• CKAN_SITE_URL：站点URL（默认：http://localhost）
• CKAN_DEBUG：调试模式（默认：False）
• CKAN_PLUGINS：额外插件（未设置）
• DB_FT_SEARCH_LANG：数据库全文搜索语言（默认：english）

国际化设置

• CKAN_LOCALE：语言（默认：en）

订阅源设置

• CKAN_FEED_AUTHORITY：订阅源权威信息（未设置）
• CKAN_FEED_DATE：订阅源日期（未设置）
• CKAN_FEED_AUTHOR：订阅源作者（未设置）
• CKAN_FEED_AUTHOR_LINK：订阅源作者链接（未设置）

存储设置

• CKAN_STORAGE_PATH：存储路径（默认：/var/lib/ckan）

活动流设置

• CKAN_ACTIVITY_STREAM_ENABLED：活动流启用状态（默认：True）

邮件设置

• EMAIL_TO：接收***（默认：ckan-admin@localhost）
• EMAIL_FROM：发送***（默认：ckan_instance@localhost）
• EMAIL_SMTP_SERVER：SMTP服务器（默认：smtp.localhost）
• EMAIL_SMTP_STARTTLS：是否启用STARTTLS（默认：True）
• EMAIL_SMTP_USER：SMTP用户名（默认：EXAMPLEUSER）
• EMAIL_SMTP_PASS：SMTP密码（默认：EXAMPLEPASS）
• EMAIL_SMTP_EMAIL_FROM：SMTP发送***（默认：ckan_instance@localhost）

Docker部署示例

构建镜像

1. 构建基础镜像

bash
git clone https://github.com/eccenca/baseimage-docker.git
cd baseimage-docker/image
docker build -t eccenca/baseimage:latest .

2. 构建CKAN主镜像

bash
git clone --recursive https://github.com/eccenca/ckan-docker.git
cd ckan-docker
docker build -t eccenca/ckan:latest .

3. 构建Solr镜像

bash
cd ckan-docker/contrib/docker/solr
docker build -t eccenca/ckan-solr:latest .

4. 构建PostgreSQL镜像

bash
cd ckan-docker/contrib/docker/postgresql
docker build -t eccenca/ckan-postgresql:latest .

运行服务

1. 启动Solr服务

bash
docker run -d --name ckan_solr eccenca/ckan-solr:latest

2. 启动PostgreSQL服务

bash
docker run -d --name ckan_db eccenca/ckan-postgresql:latest

3. 启动CKAN服务（方式一：进入容器初始化）

bash
docker run -it --rm --link ckan_solr:solr --link ckan_db:db -p 80:80 --name ckan_ckan eccenca/ckan:latest /bin/bash

在容器内执行初始化命令：

bash
/sbin/my_init

4. 启动CKAN服务（方式二：直接启动）

bash
docker run -it --rm --link ckan_solr:solr --link ckan_db:db -p 80:80 --name ckan_ckan eccenca/ckan:latest