A single codebase for Synapse portals
Building a portal
- src/configurations is the folder of all existing portals
- src/configuration/config-shell is a portal template that can be copied and filled out where the TODOs are written.
Running a portal locally
To run a portal locally, use the linkConfig script, which copies configuration files for the portal that you specify
(replace <portal-name> with one of the subfolder names, like
To run a portal with a local version of SRC run the following commands:
# In Synapse-React-Client/ # Symlink the package itself as well as the local react, react-router, and react-router-dom packages $ yarn link-src $ yarn build # last step is to build the project # In portals/ $ yarn link-src $ ./linkConfig <portal-name> # Note that you can make changes in the SRC project and reflect # them in the portals by running yarn build again. The portals project # can continue to run as you make changes.
To unlink synapse react-client run
Note - Jenkins is accessible only through VPN, reach out to IT to set this up.
Automatic Updates to Staging
When a pull request is merged, the following will occur:
package.json was updated all the staging websites will be built automatically.
If any file under
src/configurations/portal-name/* is updated then the staging site for portal-name will update.
src/configurations/adknoweldgeportal/routesConfig.ts will update adknowledgeportal staging.
Each portal has its own staging job, named
Making a new staging job
- Copy one of the staging jobs
- Change the
Source Code Management/Additional Behaviours/Included Regionssection to only include that portal's configuration folder.
- Change the
Build/Execute Shellsection to build the portal
Deploy the Staging version to Production
deploy-portal-production with parameters, using the portal's folder name, e.g. 'nf' or 'cancercomplexity'
This will copy everything from the staging bucket to the production bucket for that portal. Approval from the portal owner must be obtained before running this job.
Jenkins build script
The code that is run on jenkins is in
Sync current with staging:
$ ./run.sh push-staging [portal-name]
Sync production with production:
$ ./run.sh WARNING-push-production [portal-name]