Emergency Runbook
This site is hosted on AWS Amplify by New Relic's OpenSource team and is maintained and supported by New Relic's developer experience team. If you have any questions or comments, please reach out to opensource@newrelic.com.
To diagnose a particular alert, we've started a Common Issues
Use the Amplify Console UI to select a previous build and redeploy that build.
First, determine the desired previous build:
- Navigate to the Releases tab in the opensource-website repo.
- Determine which release to rollback to. Typically, this should be
latest_release - 1. However, you might need to go back further. Click the commit hash (in this case,12f5187).
- Use this commit message/hash value to locate the corresponding build in the Amplify Console.
Steps to redeploy in Amplify:
- Log into the Amplify Console via nr-prod okta.
- Select the
opensource-websiteapp. UnderFrontend environments, selectmaster.
- Click the
View build historybutton to see all the previous builds that have run. - Find the appropriate build corresponding to the release you located from the repo releases. This is the build to roll back to. Click
Build #xxxto select that build. In this case, you'd selectBuild #10.
- Click
Redeploy this version. Validate once the deploy is finished. - Notify The Open Source Team and the @hero in #help-opensource of the rollback so we can address the underlying issue.
This project supports three environments, local development, staging (a.ka. development), and production.
Note: When building the site, Gatsby coerces anything you've set in NODE_ENV to production
Corresponds to the master branch
New Relic Domains: https://opensource.newrelic.com
Corresponds to the develop branch
Amplify Domain: https://develop.d2pwh5nf8rvczf.amplifyapp.com/ New Relic Domains:
To run, execute npm start from the root of this repository.
Should you want New Relic Browser instrumentation while developing locally, you will need to add an additional configuration option to gatsby-config.js for the gatsby-plugin-newrelic plugin.
The site is a combination of template-generated pages and single pages built using React, markup, and MDX.
Beyond the CI/CD automation, GitHub Actions are used to keep the stats data related to each project updated on a scheduled basis. Some of the architecture consequences of that change are described here.
No issues yet!