This repo stores CIOOS Pacific ERDDAP datasets datasets.d/*.xml
which is used by CIOOS Pacific's ERDDAP at https://data.cioospacific.ca/erddap/ and the dev site at https://pac-dev2.cioos.org/erddap/. It also provides a docker-compose.local.yaml
file so you can test out your changes on your local machine.
Server | Linter | Server Update |
---|---|---|
https://data.cioospacific.ca/erddap | ||
https://pac-dev2.cioos.org/erddap |
This repository relies on the docker-erddap
docker container and uses the experimental datasets.d
feature available within this container (see more documentation here). To include a new dataset, apply the following steps:
datasets.d
for each dataset. Use GenerateDatasetsXml.sh
to generate a new dataset xml.<dataset>
and end with </dataset>
. There should be no XML prolog (
remove <?xml...
)fileDir
line, the folder name should also match your dataset ID exactly : <fileDir>/datasets/<your_dataset_id></fileDir>
A compliance check is completed nightly on a subset of every datasets by the CIOOS erddap-compliance-runner
using the IOOS Compliance Checker tool. A link to the results is added to each erddap datasets in the upper right corner.
We are testing compliance for the CF1.6, ACDD 1.3 standards.
The different components of the ERDDAP system and datasets configuration are defined through the environment variables present within the docker container.
To start a new configuration create a copy of the sample.env
file as .env
and fill up the different items available. The environment variables are following three main categories:
setup.xml
. /datasets.d.sh
of docker-erddap.sh update-erddap.sh
to create datasets.xmldocker-compose up
. On unix systems you will need to run with sudo
For both servers, configuration is handled within the .env
file which overwrites fields present within the setup.xml
through the ERDDAP_*
variables, expressions to hidden within the datasets.xml are defined by the variables ERDDAP_SECRET_*
. Pushes to main and development branches triggers an update of each associated servers via the update workflow
The following commands are usefull for handling an erdddap docker container:
docker-compose up -d
docker restart erddap
or docker-compose restart
docker-compose down
erddap/data/logs/log.txt
for more informationsh DasDds.sh
And then type in a dataset ID