This repository contains scripts and configuration for building version 2 of the OneBusAway Application Suite for use with Docker.
A demonstration of the functionality using only basic Docker can be seen by executing the ./bin/ci script. This demo runs with a GTFS feed from Halifax, Nova Scotia.
To build bundles and run the webapp server with your own GTFS feed, use the Docker Compose services in this repository.
To build a bundle, use the build-bundle service:
cp /PATH/TO/YOUR_TRANSIT_GTFS.zip ./bundle/YOUR_TRANSIT_GTFS.zip
docker-compose up build-bundleThis process will create all necessary bundle files and metadata, and all will be accessible in your local repo's ./bundle directory.
Once you have a built OBA bundle inside ./bundle, you can run the OBA server and make it accessible on your host machine with:
docker-compose up obaYou will then have three webapps available:
- API, hosted at
http://localhost:8888/onebusaway-api-webapp/api?key=TEST- an example call could be to
http://localhost:8888/onebusaway-api-webapp/api/where/agencies-with-coverage.json?key=TEST, which should show metadata about the agency you loaded - the test/demo API key is set in
./config/onebusaway-api-webapp-data-sources.xml; this can be changed as needed, and should be deleted before use in production
- an example call could be to
- Transit Data Federation, hosted at
http://localhost:8888/onebusaway-transit-data-federation-webapp/ - Enterprise Interface, hosted at
http://localhost:8888/routes/index
When done using this web server, you can use the shell-standard ^C to exit out and turn it off. If issues persist across runs, you can try using docker-compose down -v and then docker-compose up oba to refresh the Docker containers and services.
The Postgres 10 database Docker Compose service should remain up after a call of docker-compose up oba. Otherwise, you can always invoke it using docker-compose up postgres.
A database port is open to your host machine, so you can connect to it programmatically using psql:
psql postgres://postgres@localhost:5433/onebusaway