59 lines
1.7 KiB
Markdown
59 lines
1.7 KiB
Markdown
|
# Docker ckan image 
|
|||
|
|
|
|||
|
|
## Overview
|
|||
|
|
|
|||
|
|
This repository contains base docker image used to build CKAN instances. It's based on [Alpine Linux](https://alpinelinux.org/) and includes only required extensions to start CKAN instance.
|
|||
|
|
|
|||
|
|
## Build
|
|||
|
|
|
|||
|
|
To create new image run:
|
|||
|
|
|
|||
|
|
```sh
|
|||
|
|
docker build --tag ckan-2.8.2 .
|
|||
|
|
```
|
|||
|
|
The –-tag ckan-2.8.2 flag sets the image name to ckan-2.8.2 and the dot ( “.” ) at the end tells docker build to look into the current directory for Dockerfile and related contents.
|
|||
|
|
|
|||
|
|
## List
|
|||
|
|
|
|||
|
|
Check if the image shows up in the list of images:
|
|||
|
|
```sh
|
|||
|
|
docker images
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Run
|
|||
|
|
|
|||
|
|
To start and test newly created image run:
|
|||
|
|
```sh
|
|||
|
|
docker run ckan-2.8.2
|
|||
|
|
```
|
|||
|
|
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:
|
|||
|
|
|
|||
|
|
```sh
|
|||
|
|
docker push [options] <docker-hub>/ckan:<image-tag>
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Upgrade
|
|||
|
|
To upgrade the Docker file to use new CKAN version, in the Dockerfile you should change:
|
|||
|
|
|
|||
|
|
>ENV GIT_BRANCH={ckan_release}
|
|||
|
|
|
|||
|
|
Check [CKAN repository](https://github.com/ckan/ckan/releases) 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.
|