This cookbook installs and configures Joerd, a system for creating global, tiled elevation maps.
apt- For installing OS packages.git- To check out Joerd versions from Github.runit- To run Joerd as a service.user- To create a special user for Joerd.
ubuntu- Only tested on Ubuntu so far.
python- Joerd is written in Python, so it needs the interpreter.python-pip- Joerd has several Python package dependencies which need to be installed.python-gdal- Most of the heavy lifting is done by GDAL via Python.python-bs4- For getting the information out of remote file listing pages.python-numpy- For the heavy lifting that GDAL doesn't do, e.g: normal calculation.gdal-bin- Because Joerd shells out togdalbuildvrt.
| Key | Type | Description | Default |
|---|---|---|---|
| [:joerd][:cfg_path] | String | Path to put configuration files in. | '/etc/joerd' |
| [:joerd][:cfg_file] | String | What to call the main YAML configuration file. | 'config.yaml' |
| [:joerd][:bin_path] | String | Path to install the Joerd binary as. | '/usr/local/bin/joerd' |
| [:joerd][:logging_file] | String | What to call the Python logging config file. | 'logging.conf' |
| [:joerd][:user][:user] | String | What to call the Joerd user. | 'joerd' |
| [:joerd][:user][:home] | String | What directory to use as Joerd's home. | '/home/joerd' |
| [:joerd][:user][:create_group] | Boolean | True if a group should be created for the Joerd user. | true |
| [:joerd][:user][:enabled] | Boolean | True if the user should be created. | true |
| [:joerd][:revision][:joerd] | String | The revision, tag or branch to of the Joerd source to use. | 'master' |
| [:joerd][:pip_requirements_location] | String | The location of the file to dump the Python package requirements to. | '/etc/joerd/pip-requirements.txt' |
| [:joerd][:pip_requirements] | List of String | Lists the requirements of the Joerd package, including the Joerd package itself. | See attributes/default.rb |
| [:joerd][:runit][:timeout] | Number | The timeout in seconds to use when runit runs Joerd. | 300 |
| [:joerd][:sqs_queue_name] | String | The name of the SQS queue to use for receiving jobs. | '' |
| [:joerd][:s3_bucket_name] | String | The name of the bucket to store output tiles in. | '' |
| [:joerd][:s3_upload_config] | JSON Object | Additional parameters to include along with the S3 upload. | {} |
The Joerd cookbook is available under the GPLv3 license.
We welcome contributions to Joerd. If you would like to report an issue, or even better fix an existing one, please use the Joerd cookbook issue tracker on GitHub.