FITS

Field Time Series data.

Node modules

To install external node module dependencies for the web application, and copy the required files to be available to the frontend, run:

cmd/fits-api/assets/dependencies/install.sh

To add a new dependency, add it to the package.json file (with a fixed version) and run npm install. This will add it to the node_modules folder (this should not be source controlled). Choose which files you need from the module's folder, and add them to the install.sh script so that they're copied over when the script is run (these files are source controlled).

Compilation

There are scripts build.sh and build-push.sh for building Docker containers.

Database

There is a Docker file which can be used to create a DB image with the DB schema ready to use:

docker build --rm=true -t 615890063537.dkr.ecr.ap-southeast-2.amazonaws.com/fits-db:12 .
docker push 615890063537.dkr.ecr.ap-southeast-2.amazonaws.com/fits-db:12

To start the database:

docker run -e POSTGRES_PASSWORD={yourpassword} -p 5432:5432  615890063537.dkr.ecr.ap-southeast-2.amazonaws.com/fits-db:12

Add test data to the DB with:

./etc/scripts/initdb-test.sh postgres {yourpassword}

Full DB init and load a small amount of test data with:

cd scripts; ./initdb.sh postgres {yourpassword}

Logical Model

The database logical model.

Deployment

Deployment on AWS Elastic Beanstalk (EB) using Docker containers.

fits-api

There are files for EB - both to deploy the application and also set up logging from the container (application) to CloudWatch Logs. Create a zip file and then upload the zip to EB.

cd deploy
zip fits.zip Dockerrun.aws.json .ebextensions/*