This page will briefly discuss the workflow for releasing Open Web Apps. For a description of what Open Web Apps are, see the wiki page.
This involves ensuring the OWA application meets all the requirements HERE.
To ensure the OWA software distribution and versioning is automated and secure we use Bintray.
The preferred deployment trigger to bintray is using version tags. In your .travis.yml file, include the following lines
on: tags: true
Once you make the first release you are welcome to apply for your OWA to be listed under https://bintray.com/openmrs/owa among other OWAs for better recognition within the OpenMRS community. Simply ask for your OWA to be linked on Bintray by posting to Repo Management on Talk. Don't forget to include its Bintray URL in your post.
Anyone, who is a member of the OpenMRS org on Bintray can go to the provided Bintray URL, click "Link", type in "/openmrs/owa" for the repo name and click the "tick" icon next to it to include the OWA.
After confirming that the OWA has been listed under the packages at this location https://bintray.com/openmrs/owa , a member of the OpenMRS bintray org should then go to the package details and under the Files tab, go to the specific deployed file. It should have an actions menu. Select the option to make the file available under downloads.
This should make the file show as an available file for download on the OWA's bintray url under the General tab
To release the application, you need to have the necessary privileges. You need to be at least /dev/3, if you are not, ask on talk.openmrs.com and it will be released for you.
For /dev/3 developers and above,
If you have rights to push to the main repo of the openmrs project you're releasing, you can create tags on your local instance with
git tag -a v1.4
If your .travis.yml file is configured to release on tags, travis will rebuild when the version tags are pushed to the main repo
5. Create a Talk Post announcing the release
To release an open web application, you need to create a post on OpenMRS Talk detailing information about the application. The aim of the OpenMRS talk post is to inform the community about the new release and get feedback from the users of the OWA and fellow developers.
The blog post should at minimum contain
An example of an OWA release talk post can be found HERE.