Preview Deployments - psu-libraries/scholarsphere GitHub Wiki
ScholarSphere 4 has N number of "dev" environments where Developers can have their code running in a production-like, isolated environment.
Conventions
Branch Name
we tell CI/CD that we want to have a deployment for our hacking by prefixing the branch name with preview/
Example:
git checkout -b preview/super-rad-thing
Everything after the prefix is slugified, and the output is considered the "environment"
The branch will be slugified so that a DNS compliant address can be used. Slugification uses the following pattern:
sed -e "s/[^[:alnum:]]/-/g" | tr -s "-" | tr A-Z a-z| sed -e "s/preview-//g"
in short: all SHOUT CASE gets converted to lowercase, any non alnum character gets turned into a -
and any repeating -
gets smashed down into 1
examples:
preview/ISSUE#234%of_users => issue-234-of-users
preview/some_thing__neat => some-thing-neat
preview/THIS_IS_SO_COOL => this-is-so-cool
preview/i(things)$%#0-go_here => i-things-0-go-here
Domain Name
Given CI is green, you'll get a release called "scholarsphere-{{ environment }}.dsrd.libraries.psu.edu
Examples:
scholarsphere-issue-234-of-users.dsrd.libraries.psu.edu
scholarsphere-super-rad-thing.dsrd.libraries.psu.edu
Kubernetes
If you need access to the rails console, or database access etc, check out the following guide. https://github.com/psu-stewardship/scholarsphere-4/wiki/kubernetes
Azure AD
Presently we can't automate the creation of reply urls for oauth. If you need to test login/logout functionality you'll need to add a reply URL to the app.
https://github.com/psu-stewardship/scholarsphere-4/wiki/Azure-AD-configuration