- docker
- make
- Clone the repository
- Update the submodules by using
git submodule update --init --recursive
- Copy the
.env.example
as.env
and modify the variables in the file as per your need and replace the variables with the actual values of the environment. - Run the make file to create the images (base image and the service image) by the
make
command.- If you are using Windows, refer below for instructions on setting up the
make
function. - Runmake
command
- If you are using Windows, refer below for instructions on setting up the
- Build the Development Environment for 510 Data Catalog using the docker-compose by
docker-compose -f docker-compose-dev.yml build
.- If you are using Windows, ensure that all the files are converted to LF line breaks before this step. This can be acheived using
dos2unix
script. For further instructions, refer below
- If you are using Windows, ensure that all the files are converted to LF line breaks before this step. This can be acheived using
- Once the Build is done, run the project by
docker-compose -f docker-compose-dev.yml up
.- If DB related issue comes while setting up the environment, please exec into container using
docker exec -it ckan bash
and then runckan db init
- If DB related issue comes while setting up the environment, please exec into container using
Once the project is up, you can browse the project using http://localhost:5000 or the CKAN_SITE_URL
you used in .env
The development setup uses the src/
directory for all the custom extensions and required extension (using git submodules) and mount it is as volume to docker so the changes made in src/
will be directly updated in the docker setup. For more details, please follow developer guide
Follow the above steps mentioned in the local environment setup but replace the docker-compose-dev.yml
with docker-compose.yml
-
Make Command: The
make
command should be available on all Linux systems. If you are developing on Windows, you can try one of these:-
Installing any GNU Compiler system such as MinGW or Cygwin should provide the
make
command. -
Install Chocolatey Package Manager and install its
make
package using the command below. This method is tested but will require administrator access to install Chocolatey.choco install make
-
-
Dos2Unix: Dos2Unix is a handy command-line utility to convert Windows text files (using CRLF line breaks) to Linux/UNIX text files (using LF line breaks).
-
Download Dos2Unix ZIP file and extract its contents.
-
The zip contains a bin folder. Add the path up to the bin folder in your System's PATH environment variables to use the script in the terminal.
-
To convert all files in a folder and its subfolders from CRLF to LF format, open a terminal in the folder and run one of the following:
// For GitBash Terminal Users find . -type f -print0 | xargs -0 dos2unix // For Windows Powershell Terminal users Get-ChildItem .\ -Recurse -File | select FullName | % { dos2unix $_.FullName }
-
The conversion process will take a few minutes to complete.
-
To update the metadata fields please follow the instructions
For All security related issue please follow the security guide
Please follow the developer guide for the components, usage and contribution to the project.
Thanks to all the people who contributed directly or indirectly.