easyckan/ckan-datapusher

EasyCKAN v2.6 Beta.1

![Build Status]([***]

EasyCKAN是安装CKAN平台的最简方式，基于Docker容器，兼容所有Linux x64发行版。

仍在使用旧版本？

EasyCKAN已更新至基于Docker容器的新技术版本。若您的组织或***门户仍使用旧版本，可在https://github.com/thenets/EasyCKAN/tree/legacy%E6%89%BE%E5%88%B0%E6%97%A7%E7%89%88%E3%80%82

谁应使用EasyCKAN？

EasyCKAN项目适用于单节点门户和开发环境。若需负载均衡或其他高级功能，建议从CKAN源码安装手动创建环境。

EasyCKAN包含什么？

• EasyCKAN命令行工具（CLI）
• CKAN 2.6.2版本
• 官方支持插件：
  • DataStore插件（CKAN基础安装版本）

1. 系统要求

您的服务器/虚拟机需满足以下条件：

• Linux x64内核版本3.10或更高
  • 支持简单安装的发行版：Ubuntu、Fedora、CentOS、openSUSE
  • 其他发行版需手动安装
• 2GB内存
• 6GB可用磁盘空间
• 端口80、5000未被占用

建议使用全新的Ubuntu安装环境（非强制要求）。

2. 安装步骤

在服务器/虚拟机上执行以下命令：

bash
curl -sSL https://raw.githubusercontent.com/thenets/Easy-CKAN/master/install_easyckan.sh | sudo bash
sudo easyckan install

3. EasyCKAN命令行使用

EasyCKAN命令行是与CKAN安装交互的最佳方式。

3.1 启动开发模式服务器

运行开发环境服务器：

bash
sudo easyckan dev # 可通过5000端口访问

3.2 部署生产模式

完成开发后，切换到生产环境：

bash
sudo easyckan production # 可通过80端口访问

3.3 创建管理员用户

将"my_username"替换为您需要的用户名：

bash
easyckan exec paster sysadmin add my_username --config=/etc/ckan/default/development.ini

3.4 进入虚拟环境

若需执行自定义命令或在CKAN虚拟环境中使用bash：

bash
easyckan exec

3.5 进入PostgreSQL命令行

访问PostgreSQL CLI：

bash
easyckan exec psql -h ckan-postgres -Upostgres

3.6 创建额外配置文件

若从一开始设置生产环境，建议创建干净的配置文件：

bash
easyckan exec paster make-config ckan /etc/ckan/default/production.ini

3.7 修复操作

多数常见问题可通过重启解决：

bash
easyckan repair # 重启所有Docker容器，保留CKAN数据

若CKAN目录/文件权限错误，重置为默认：

bash
sudo chown -R 5000.5000 /usr/lib/ckan/ /etc/ckan/ /var/lib/ckan/

3.8 从零创建插件

CKAN允许从零创建插件，需先构建结构再编译：

bash
# 启用虚拟环境并进入插件目录
easyckan exec
cd /usr/lib/ckan/default/src

# 从零创建插件（将my_plugin替换为您的插件名，建议保留ckanext-前缀）
paster --plugin=ckan create -t ckanext ckanext-my_plugin

# 编译插件
cd ./ckanext-my_plugin
python setup.py develop

# 退出容器
exit

之后在配置文件/etc/ckan/default/development.ini的ckan.plugins =后添加插件名（如my_plugin）。

4. 问题与支持

• IRC：可在Freenode.net的#easyckan频道咨询（无需账号，输入"thenets"联系作者）。
• GitHub：提交问题至https://github.com/thenets/Easy-CKAN/issues%E3%80%82
• 邮件：发送至***。

文件位置

所有文件位于默认路径：

/etc/easyckan   # EasyCKAN文件
/etc/ckan/      # CKAN设置文件
/usr/lib/ckan/  # CKAN主文件及插件/扩展
/var/lib/ckan/  # CKAN上传文件

待办事项

计划添加以下改进：

• 功能：卸载工具
• 功能：界面化插件安装
• 改进：更友好的bash界面
• 插件：Harvester

特别感谢

• @alersonluz：协助Ubuntu初始安装程序
• @mohnjatthews：改进README文档
• @timgiles：新插件安装程序
• @vladimirghetau：新插件安装程序
• @samisnunu：CKAN 2.6测试

开发者安装（最新版本）

若需最新版EasyCKAN（可能含bug，风险自负）：

1. 安装curl：
   • Ubuntu/Debian：sudo apt-get install -y curl
   • Fedora/CentOS：sudo yum install -y curl
2. 执行安装命令：

bash
curl -sSL https://raw.githubusercontent.com/thenets/Easy-CKAN/dev/install_easyckan.sh | sudo bash
sudo easyckan install
sudo easyckan dev