Skip to content

Latest commit

 

History

History
59 lines (47 loc) · 2.34 KB

README.md

File metadata and controls

59 lines (47 loc) · 2.34 KB

ckan

Infrastructure and Automation tooling for deploying ckan.

To run this playbook

ansible-playbook -K -i inventory.yml ckan.yml

Project Status

This role can be used to deploy a single node instance of ckan. It is recommended to configure a reverse proxy for ssl termination. If a remote database is being used replace postgres_host with the remote hosts address in inventory.yml.

Future Features

This project is not intended to only be a ckan role. In the future AWS EC2 support, remote postgres (RDS), Ceph, and other high availability features are planned to be added.

Basic Administration

Creating a Sysadmin user

sudo -u www-data /usr/lib/ckan/default/bin/ckan -c /etc/ckan/default/ckan.ini sysadmin add admin name=admin

Xloader configuration

  1. Login as an admin user
  2. Go to API Tokens
  3. Create an API token for xloader
  4. Insert the API token into inventory.yml
xloader_api_token: API_TOKEN

Role Usage

Variable Description
fqdn The fully qualified domain name of the target host.
ckan_version The ckan installation version. Only supported version is 2.10+
postgres_host The address of the PostgreSQL instance.
postgres_password The postgres user master password alongside with the user password for the ckan_default postgres user.
xloader_api_token API Token for https://github.com/ckan/ckanext-xloader
plugins ckan plugins that are to be loaded into ckan on startup. xloader & datastore (required) are installed by default.

Contributing

This project uses Vagrant as the primary method to test this Ansible playbook.

Set the virtualization provider.

export VAGRANT_DEFAULT_PROVIDER=libvirt

Set the default network interface to use for the bridge.

# Vagrantfile
DEFAULT_NETWORK_INTERFACE = "eth1"

Start the virtual machine.

vagrant up