- SignUp to https://bintray.com
- Create a new repository (if you do not have one yet) named 'owa' of type 'Generic'
- Add a new package on Bintray as per your OWA name to the 'owa' repository
- Post on talk.openmrs.com requesting for your package to be added to the openMRS Bintray account
- If you are a member of the openmrs organisation on bintray, navigate to the owa repository and Add a new package
- The package should have:
- The URL to the repo (a.k.a VCS URL) from which the OWA shall be deployed
- A naming format consistent with the name of the OWA to be released e.g. openmrs-owa-addonmanager
- A License
- Reference to JIRA board if any for issue tracking
- Deploy your bundled OWA file:
- Deploying with TravisCI:
- Install travis command line client
- Get bintray API KEY. You can find the API Key at https://bintray.com/profile/edit (see the left menu) after you log in to Bintray.
- Set up project for deployment to bintray
The preferred deployment trigger to bintray is using version tags. In your .travis.yml file, include the following lines
on: tags: true
- Releasing an OWA requires the necessary privileges to create version tags.
- It is preferable to set the bintray API key as an environment variable in the Travis env e.g. key: $BINTRAY_API_KEY. If the repo does not have this variable set, please reach out on talk.openmrs.com requesting for support from someone with the privileges to add their api_key and you can then use their username
- Example bintray.json
- Example .travis.yml (note dry-run should be set to false, and skip_cleanup should be set to true, and the username should match the user whose API KEY you are going to set use
- Create the appropriate version tag
- Set bintray api key as an environment variable on travis command line client (travis env set NAME VALUE)
- Push changes to remote repo to trigger the deployment process
- In Bintray, 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. (a member of OpenMRS bintray will need to do this)
- Deploying with TravisCI:
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 "owa" for the repo name and then select the "tick" icon next to "/openmrs/owa" 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