Docker ckan image

Overview

This repository contains the necessary files for building a base docker image for CKAN. The build can target either Alpine Linux or Debian Linux and only includes required extensions to start a CKAN instance. This is based-off Keitaro's docker-ckan.

NOTE
The master branch tracks and absorbs changes from the upstream Keitaro repository which then goes into the develop branch. The develop contains our modifications to the original work done by Keitaro mostly to include support for building a Debian Linux based CKAN image. The Debian build is modelled after the original Alpine build, to ensure the same build and runtime mechanisms apply across the targetted distros.

Modifications should be done with care in order not to deviate too much from the source and thereby hamper the "pulling and merging" of improvements from the upstream repository.

Build

To create a new image, use the build.sh bash script. Here is a usage description gotten from ./build.sh --help:

Build Alpine or Debian based CKAN image

Usage:
  ./build.sh [options]

Options:
  --deb         | -d      build Debain image.
  --dry-run               performs a dry-run to show configs.
  --help        | -h      show this message.
  --namespace             docker hub account name.
  --no-cache              build image without using cache.
  --tag         | -t      the image tag.

The script is configured to build an Alpine image by default (except when --deb flag is provided). The built image is named in the form <namespace>/ckan and tagged with the latest tag for the repository or "latest" if there is none (or uses value from --tag <ckan-version> option if provided). The resulting full image name becomes <namespace>/ckan:<tag>-alpine for Alpine or just <namespace>/ckan:<tag> for a Debian image. For instance: ehealthafrica/ckan:2.7.8-alpine.

List

Check if the image shows up in the list of images:

 docker images

Run

To start and test newly created image run:

 docker run <namespace>/ckan:<image-tag>

Check if CKAN was succesfuly started on http://localhost:5000. The ckan site url is configured in ENV CKAN_SITE_URL.

Upload to DockerHub

It's recommended to upload built images to DockerHub

To upload the image to DockerHub run:

docker push [options] <docker-hub>/ckan:<image-tag>

Upgrade

To upgrade the Docker files to use new CKAN version, in the Dockerfiles you should change:

ENV GIT_BRANCH={ckan_release}

Check CKAN repository for the latest releases. If there are new libraries used by the new version requirements, those needs to be included too.

Extensions

Default extensions used in the Dockerfile are kept in:

ENV CKAN__PLUGINS envvars image_view text_view recline_view datastore datapusher

Add new scripts

You can add scripts to CKAN custom images and copy them to the docker-entrypoint.d directory. Any *.sh or *.py file in that directory will be executed after the main initialization script (prerun.py) is executed.