OpenMRS environments
Platform
| Alias | Purpose | Deployment Build (update version) | Reset build (restart and clean data) | Docker image tag | Backups | Cleans data on deployment |
|---|---|---|---|---|---|---|
Metadata Sharing Builder | Deploy mdsbuilder (manually) | - | openmrs/openmrs-distro-mdsbuilder |  |  | |
| uat-platform.openmrs.org | OpenMRS Platform Release Testing | UAT Platform (manually) | Redeploy uat-platform (daily) | openmrs/openmrs-distro-platform:uat | | |
Reference Application
| Alias | Purpose | Deployment Build (update version) | Reset build (restart and clean data) | Docker image tag | Owner | Backups | Cleans data on deployment |
|---|---|---|---|---|---|---|---|
| qa-refapp.openmrs.org | OpenMRS RefApp automated QA Testing (from CI) | Reference Application Distribution (on green build) | - | openmrs/openmrs-reference-application-distro:qa | | | |
| modules-refapp.openmrs.org | OpenMRS RefApp Community modules (modules are manually installed) | Modules refapp (manually) | Redeploy modules-refapp (manually) (Override customised variable 'destroy.data' to false to just restart it without losing data) | openmrs/openmrs-reference-application-distro:modules | Daniel Kayiwa | | |
| demo.openmrs.org | OpenMRS RefApp demo site (stable version) | Demo (manually) | Redeploy docker demo (daily) | openmrs/openmrs-reference-application-distro:demo | | | |
| uat-refapp.openmrs.org | OpenMRS RefApp Release Testing | UAT refapp (manually) | Redeploy uat-refapp (weekly) | openmrs/openmrs-reference-application-distro:uat | | |
Developer Test Environments
When we have the resources available, we will try to help developers in the OpenMRS community in hosting & demonstrating their OpenMRS-related work. Since resources are limited, these hosted developer test environments should be reserved for community collaboration projects and used for short periods of time. Examples would include hosting an instance of OpenMRS to demonstrate or get user feedback/testing of a feature or module during a community sprint or development spike.
In most cases, we expect developers to use their own resources for short-term hosting (e.g., a GSoC student can host her project in Digital Ocean).
If you require a development test server (and it has been agreed in talk), please submit an ITSM ticket and describe your needs. Only a limited number of test servers are available, so please let us know when you are done so the resources may be used by someone else. Setting it up can take a few hours, so please submit your ticket at least a week in advance:
In your request, include:
- Your name, OpenMRS ID, and developer stage.
- A short description of how the test server will be used.
- The date until the server is needed (a few weeks)
- A statement that you understand you will be responsible for the application and troubleshooting (they are running in docker)
- A link to the pull request with your application How to deploy a new application to our infrastructure
| Alias | Purpose | Deployment Build (update version) | Reset build | Docker image tag | Expires | Owner | Backups | Cleans data on deployment |
|---|---|---|---|---|---|---|---|---|
| OpenMRS 3.x Ref App Servers | OpenMRS 3.x RefApp | None. | openmrs/openmrs-reference-application-3-gateway openmrs/openmrs-reference-application-3-frontend openmrs/openmrs-reference-application-3-backend | Never | | | ||
| Sync demo environment | None. | openmrs/openmrs-reference-application-distro:sync files |
| | | |||
| Sync demo environment | None. | openmrs/openmrs-reference-application-distro:sync-legacy files |
| | | |||
| OpenMRS-Ebola demo | OpenMRS 2.0 - Ebola/DTE 03 | ??? | ? | ? | ||||
OpenMRS Release Testing for MSF. | Redeploy msf-refapp (manually) (Override customised variable 'destroy.data' to false to just restart it without losing data) | openmrs/openmrs-reference-application-distro:msf docker-compose | ??? | ???? |
| | ||
| OpenMRS development Testing | Deploy Reference Application 2.x/DTE 04 | ??? | ||||||
| OpenMRS for ebola demo | Deploy ebola | (Override customised variable 'destroy.data' to true to just to destroy the data) | openmrs/ebola-distro:latest |
| |  | ||
| OpenMRS for ebola demo | Manual. Short-lived environment | openmrs/openmrs-reference-application-distro:uat |
| @ssmusoke | | |
Docker environments
You should be able to run all dockerised environments (with database and data) locally using docker-compose and docker. Each folder has a readme file explaining how to do it.
Every environment is using a different docker image tag; when the tag is pushed docker hub is configured to call a webhook and deploy the new version of the image/application. The docker autodeploy is defined in ansible and deployed to required docker hosts.
Talk discussions
- https://talk.openmrs.org/t/why-uat-platform-is-being-deployed-from-refappdistro-in-bamboo/8708/3
- https://talk.openmrs.org/t/we-have-a-qa-refapp-server-lets-use-it-for-manual-testing/9652/4
- https://issues.openmrs.org/browse/ITSM-3976
- https://talk.openmrs.org/t/qa-refapp-not-inline-with-ra-2-6/10821
- https://talk.openmrs.org/t/shifting-to-using-the-correct-environments-for-testing/2070/3
- https://talk.openmrs.org/t/openmrs-test-environments/10973
- https://talk.openmrs.org/t/dev03-uat-platform-and-int-platform-machine/14179/1