https://github.com/databiosphere/saturn-ui-prod-deploy

Terra UI automated prod deploy service
https://github.com/databiosphere/saturn-ui-prod-deploy

Last synced: about 2 months ago
JSON representation

Terra UI automated prod deploy service

• Host: GitHub
• URL: https://github.com/databiosphere/saturn-ui-prod-deploy
• Owner: DataBiosphere
• Created: 2018-06-20T19:34:49.000Z (almost 8 years ago)
• Default Branch: dev
• Last Pushed: 2024-12-10T18:45:10.000Z (over 1 year ago)
• Last Synced: 2025-06-27T01:38:15.203Z (9 months ago)
• Language: JavaScript
• Homepage:
• Size: 3.86 MB
• Stars: 2
• Watchers: 10
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

          
# Saturn prod deploy

Runs the Saturn production deploy process. This is done via scheduled workflow on CircleCI. See the `config.yml` file for details.

## Saturn Hotfix Procedure

1. Create a hotfix ticket on your board

2. Once your ticket is created open it and click "Add Checklist" (at the top of the edit modal)

3. In the checklist section select "load templates"

![load template](docs/load-template.png)

4. Choose the `Terra UI Hotfix Release Template`

5. Follow the instructions on this template

## Saturn Rollback Procedure

### Prequisites

You will need a `firecloud.org` account and your account will need to be in the `firecloud-project-owners` group.

You can check your access by trying to access the [bvdp-saturn-prod](https://console.cloud.google.com/appengine/versions?project=bvdp-saturn-prod&serviceId=default) project.

If you cannot access this project you will need to contact dsp-devops. You can request access to the project in the [dev ops channel](https://broadinstitute.slack.com/archives/CADM7MZ35)

### Procedure

1. Make an announcement on the [terra-ui](https://broadinstitute.slack.com/archives/C01EHNUM73R) channel that you will be rolling back the release

2. Make sure you are logged in to your `firecloud.org` account

3. Go to the [saturn prod deployment project](https://console.cloud.google.com/appengine/versions?project=bvdp-saturn-prod&serviceId=default) in the gcp console

4. Once in the console go to the App Engine Versions

  

![Appengine versions sidebar](docs/select-versions.png)

4. Choose the version prior to the current running version. 

![Choose a deployment screenshot](docs/choose-deployment.png)

5. Once you have selected the version click "Migrate Traffic"

   1. A dialog box will pop up, click "Migrate" 

  

![Migration dialog screenshot](docs/migrate-dialog.png)

6. Confirm that the release has been rolled back and is working by visiting [Terra](https://app.terra.bio/) and checking the build date of the application by scrolling to the bottom of the hamburger menu:

![Terra build date](docs/terra-build-date.png)

7. Make an announcement on the [terra-ui](https://broadinstitute.slack.com/archives/C01EHNUM73R) channel that you have completed the rollback.