kartoza/ckanext-dalrrd-emc-dcpr

Electronic Metadata Catalog for South Africa's Department of Land Reform and Rural Development # ckanext-dalrrd-emc-dcpr This is a ckan extension that implements the Electronic Metadata Catalog for South Africa's Department of Agriculture, Land Reform and Rural Development (DALRRD). It also contains additional utilities, useful for running the full EMC. ## Dataset metadata fields Dataset fields are defined with the help of the ckan scheming extension. The dataset schema file can be found in `ckanext/dalrrd_emc_dcpr/scheming/dataset_schema.yaml`. It has the definition of the EMC dataset metadata fields, which conform with the South African spatial metadata standard (SANS1878) ## Deployment This project is deployed onto the following environments: - **testing :orange_circle:** - testing.emc.kartoza.com - **staging**: TBD - **production**: TBD Deployment details are kept elsewhere. ## Installation While this project can be installed standalone, it is primarily meant to be used together with docker. ### docker standalone installation Ideally, you should be able to pull prebuilt images from dockerhub: hub.docker.com ``` docker pull kartoza/ckanext-dalrrd-emc-dcpr:main ``` Alternatively, you can also build the image locally by using the provided build script: ``` cd docker ./build.sh ``` After having the image, use it to create containers. In order to be properly recognized, your config files must be mounted at `/home/appuser/ckan.ini` and `/home/appuser/who.ini`. For example, when running standalone: ``` docker run \ --rm \ --volume=/home/myuser/my-ckan.ini:/home/appuser/ckan.ini \ --volume=/home/myuser/who.ini:/home/appuser/who.ini \ kartoza/ckanext-dalrrd-emc-dcpr:main ``` The provided `Dockerfile` has the following peculiarities: - It **requires** you to mount the ckan configuration files in order to work; - Uses poetry to install Python packages and manage their environment; - A custom docker entrypoint script implemented in Python. It has access to the poetry env and can be called b …