README.md

Blue Brain Project - Usecase Wizard

This repository contains all the information related to the use cases that are shown in the Brain Simulation Platform.

All the titles, images, descriptions, files, etc are described in usecases.json

This app is deployed in HBP Collab

To run locally

npm install (install dependencies)

npm run dev (run server)

To deploy in a dev environment:

• The user make a pull request to the dev branch
• A travis plan is triggered to look for any error in the files.
• When the plan finishes, the owners of the repo can merge the new pull request to dev.
• The user receives the notification that his/her pull request was merged.
• A jenkins plan is triggered.
• The new changes appear in Online Use Cases DEV

To deploy in production (non notebook):

• The owner receives the confirmation from the tests and the user that everything works correctly.
• The owner create a pull request from dev environment to master.
• A jenkins plan is triggered.
• Go to jenkins Build with Parameters and check release
• The new changes appear in Brain Simulation Platform

To deploy in production (notebook):

• Download the notebook that is pointed in the file field in usecases.json (Collab UUID)
• Add this notebook into usecases/production_notebooks folder
• Add a new field on the usecases.json next to file called file_prod that points to https://api.github.com/repos/antonelepfl/usecases/contents/production_notebooks/<category>/<notebook_name>.ipynb?ref=master (*)
• Create a Pull Request to dev branch with this 2 changes
• After aproved in dev create a new Pull Request merging dev into master
• After dev is merged into master this jenkin plan is triggered
• To release the new version of the site, tick release checkbox on this plan

How to:

• Add new: use case - MOOC - models
• If single cell models change
• The usual path the user follows

(*) We are using the Github API and not the raw content because we need the SHA to compare using the common header snippet