Amazon Web Services (AWS) offers a suite of services that can be used to host and manage a OneBusAway (OBA) deployment. Now that we have containerized the OBA, we need to create documentation (and any necessary accompanying code changes) that will allow a reasonably technical IT worker to set up and deploy OBA on AWS.
Outcome and Deliverables
The end result of this should be a guide written in Markdown that a reasonably technical person, but not necessarily a software developer (think senior IT at a transit agency) can use to deploy OneBusAway in a scalable, secure way on AWS. Despite the fact that this task appears in the onebusaway-docker issue tracker, the end product should be added to https://github.com/oneBusAway/onebusaway-docs
The guide should start at the point of creating an AWS account. It doesn't need to lay out how to do this, but it should include a link to the AWS help docs that explain how to do this.
The guide will then explain how to apply our IaC artifacts created in #62 for setting up OBA on AWS.
Note: this is blocked on issues #62 and #63
Overview
Amazon Web Services (AWS) offers a suite of services that can be used to host and manage a OneBusAway (OBA) deployment. Now that we have containerized the OBA, we need to create documentation (and any necessary accompanying code changes) that will allow a reasonably technical IT worker to set up and deploy OBA on AWS.
Outcome and Deliverables
The end result of this should be a guide written in Markdown that a reasonably technical person, but not necessarily a software developer (think senior IT at a transit agency) can use to deploy OneBusAway in a scalable, secure way on AWS. Despite the fact that this task appears in the onebusaway-docker issue tracker, the end product should be added to https://github.com/oneBusAway/onebusaway-docs
Look at the guides published on https://developer.onebusaway.org, like this Quickstart guide for a sense of tone, length, etc.
Thoughts about the guide