{"id":36443820,"url":"https://github.com/cms-orbits/cms-sao","last_synced_at":"2026-01-11T22:02:09.585Z","repository":{"id":71084895,"uuid":"143602910","full_name":"cms-orbits/cms-sao","owner":"cms-orbits","description":"The microservice that orbits around CMS exposing entries and draft resources and handles its processing (submit, evaluation and scoring)","archived":false,"fork":false,"pushed_at":"2019-11-01T00:05:56.000Z","size":191,"stargazers_count":0,"open_issues_count":2,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-06-21T21:07:05.512Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cms-orbits.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-08-05T10:21:08.000Z","updated_at":"2019-11-01T00:03:44.000Z","dependencies_parsed_at":"2023-03-12T07:45:19.318Z","dependency_job_id":null,"html_url":"https://github.com/cms-orbits/cms-sao","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/cms-orbits/cms-sao","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cms-orbits%2Fcms-sao","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cms-orbits%2Fcms-sao/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cms-orbits%2Fcms-sao/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cms-orbits%2Fcms-sao/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cms-orbits","download_url":"https://codeload.github.com/cms-orbits/cms-sao/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cms-orbits%2Fcms-sao/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28324838,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-11T18:42:50.174Z","status":"ssl_error","status_checked_at":"2026-01-11T18:39:13.842Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-11T22:02:09.505Z","updated_at":"2026-01-11T22:02:09.572Z","avatar_url":"https://github.com/cms-orbits.png","language":"Go","readme":"# CMS Sao\n\nA microservice that orbits around [CMS](https://github.com/cms-dev/cms) exposing\nthe Entry, Result, Score and Scoreboard entities as [REST](https://en.wikipedia.org/wiki/Representational_state_transfer)\nresources.\n\n## Up and running\n\nCMS Sao can be deployed and run as a Docker container or a standalone binary;\neither way is recommend to run this application as the former one.\n\n### Prerequisites\n\nCMS Sao heavily relies on [CMS](https://github.com/cms-dev/cms) including its\ndatabase, so in order to have this application up and running you will need:\n\n1. CMS 1.3.x or greater (the current Sao version was designed against the last CMS revision in January 2018)\n2. CMS PostreSQL DB schema access (it could be the same credentials that CMS uses but is not recommended)\n3. MongoDB as temporal storage and message queue\n4. Docker engine 17.x or greater\n\n### Deployment\n\nCMS Sao can be deployed and run as a Docker container, it can be done directly\nusing `docker container run` command:\n\n```shell\ndocker container run -p 8000:8000 cmsorbits/cms-sao\n```\n\nOr it can be run using `docker-compose up` with a `docker-compose.yml` file\nsimilar to the one on the project root.\n\n### Configuration\n\nAll the intrinsic configurations can be overridden via the `config.properties`\nfile in Sao's working directory (you could use `config.properties.example` as\nguide) or as environment variables with the `SAO_` prefix. As for example in\norder to override the `datasource.host` value, you could start the Docker\ncontainer with the following syntax:\n\n```shell\ndocker container run -p 8000:8000 -e 'SAO_CMS_DATASOURCE_HOST=10.10.37.10' cmsorbits/cms-sao\n```\n\nWhen CMS Sao is executed using `docker-compose` the override values can be provided directly\nin the `docker-compose.yml` or `docker-compose.override.yml` files (within the `environment`\nsection).\n\nThe most relevant properties are:\n\nProperty name | Default value | Description\n--- | --- | ---\nserver.port | 8000 | The port where the application will listen for incoming requests\nserver.log.request | false | When set as true the application will log each incoming request to the STDOUT\nserver.error.tracedump | false | When set as true the application will include the error trace in failure responses\ncms.url | http://localhost/ | The URL where Sao can stablish communication with CMS\ncms.datasource.name | cmsdb | CMS PostgreSQL schema name\ncms.datasource.username | cmsuser | CMS PostgreSQL datasource username\ncms.datasource.password | | CMS PostgreSQL datasource password\ncms.datasource.host | 127.0.0.1 | CMS PostgreSQL host network address\ncms.datasource.port | 5432 | CMS PostgreSQL instance port\ncms.datasource.sslmode | disable | CMS PostgreSQL [ssl mode](https://www.postgresql.org/docs/9.1/libpq-ssl.html) (valid values: require, disable, verify-ca, verify-full)\ndocumentsource.name | cmsdb | MongoDB database name\ndocumentsource.usernaname | cmsuser | MongoDB datasource username\ndocumentsource.password | | MongoDB datasource password\ndocumentsource.host | 127.0.0.1 | MongoDB host network address\ndocumentsource.port | 27017 | MongoDB port\nneso.queue.name | neso_queue | Neso worker queue name\n\n## License\n\nThis project is licensed under the **MIT License** - see the [LICENSE](LICENSE)\nfile for details.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcms-orbits%2Fcms-sao","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcms-orbits%2Fcms-sao","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcms-orbits%2Fcms-sao/lists"}