Name: intermine-registry
Owner: InterMine
Description: Registry to store and browse all known instances of InterMine. Entirely developed during Google Summer of Code 2017 by Leonardo Kuffo
Created: 2017-05-08 15:25:38.0
Updated: 2017-08-23 09:16:53.0
Pushed: 2017-11-29 12:34:36.0
Homepage: http://registry.intermine.org
Size: 12267
Language: JavaScript
GitHub Committers
User | Most Recent Commit | # Commits |
---|---|---|
Daniela Butano | 2018-02-08 15:56:44.0 | 40 |
Yo Yehudi | 2017-11-29 12:20:17.0 | 1 |
Aman Dwivedi | 2018-02-06 09:32:40.0 | 2 |
Leonardo Xavier Kuffo Rivero | 2017-08-29 12:26:04.0 | 163 |
Other Committers
User | Most Recent Commit | # Commits |
---|
InterMine Registry is a place where all the up-to-date instances information is stored and can be consumed by applications like Blue Genes, iOS, InterMine R, the friendly mine tool or available to everyone who needs it. The core of InterMine Registry is its RESTful API. Running over Node.js integrated with MongoDB, it contains methods (endpoints) to administer the instances on the registry (add, update & delete) and search among them. Furthermore, InterMine Registry also includes a nice fully responsive front-end web application, from which everyone can see all the InterMine instances and search among them.
InterMine registry was entirely implemented and developed as a GSoC 2017 program project by the student Leonardo Kuffo. Click here to find all of Leonardo's contributions for the project as evidence of his work.
The core of the InterMine Registry App is the restFUL API. It contains endpoints to search and administer instances. These endpoints can be reached through the following base path: http://intermine.org/registry/service/
POST
/instances Add an instance to the registry.GET
/instances Get all the instances from the registry.GET
/instances/{instanceIdOrName} Get an instance by its ID or Name.PUT
/instances/{instanceId} Update an instance.DELETE
/instances/{instanceId} Deletes an instance.PUT
/syncrhonize Update the branding & version information of every instance.PUT
/syncrhonize/{instanceIdOrName} Update the branding & version information of the specified instance.You can check the detailed API documentation for more information and testing.
Install Node.js on your host.
Install MongoDB on your host.
Clone this repository on your host:
clone https://github.com/intermine/intermine-registry.git
From your terminal or CMD access to the registryapp directory an execute the following command:
install
To run the application, being on the same directory:
start
In addition of running the application, this will also configure the MongoDB environment (database, collection & indexes). If you wish to populate the registry you may do (on another CMD or terminal) node initRegistry.js
, which will initialize all the registry instances with basic information.
The API-DOCS are generated based on the swagger.json
file in the repository. In order for the API-DOCS to work correctly, on this file you have to specify the “HOST” and the “SCHEME” of the app (http or https).
For more in-deep information about the code, and detailed guidelines on the project, please, visit the following link.