this is a tool for migrating from ors-config.json to ors-config.yml.
As with Release 8 a lot of config options have been restructured, this tool should help with migrating configs from JSON to YAML format, inform about changes made and point out action steps that need to be done manually.
To migrate your ors-config.json, run the following command in the folder with your config file,
as the current directory is mounted into the container as a volume:
docker run --rm -v ${PWD}:/app heigit/ors-config-migration <path-to-your-ors-config.json>Please examine the container logs carefully (should print to stdout) to see if there are any warnings or errors concerning the migration and fix issues as needed.
The migrated ors-config.yml will be written to the current working directory.
For running the migration script locally you need at least Python version 3.11. Clone the repository and run the following commands in the repo-root directory:
# create virtual python environment
python3 -m venv .venv
# activate venv
source .venv/bin/activate
# install requirements
python3 -m pip install -r requirements.txt
# run migration script
python3 migrate.py <your-ors-json-config-path> [<optional-output-ors-yml-config-path>]The following will build the ors-config-migration docker image locally and run the migration script with the
provided test-config.json file.
Once the container finishes, the container will be removed and the test-config.yml file will be created in the local
working directory.
Clone the repository and run the following commands in the repo-root directory:
# Build the dockerfile
docker build -t ors-config-migration:local .
# Change into a new working directory
mkdir -p ./config && cd ./config
# Execute the migration script by mounting the local working directory into the container
docker run --rm -v ${PWD}:/app ors-config-migration:local config-files-json/test-config.json test-config.yml If you want to run the schema tests locally:
# install pytest
python3 -m pip install pytest
# run tests
python3 -m pytest tests