Releasing changes to production for the new CMS

These are instructions for the new workflow needed to release changes to production in our new Content Management System (CMS).

For more information about how to modify content in the CMS, please view our CMS user guide.

Preview Site

When you receive a GitHub issue (or other task) that requires you to change content within the CMS:

• First, navigate to the correct CMS page.
• Once on the correct CMS page, make sure to UNCLICK the "reviewed" box under the Production section.

• Make whatever content changes are needed within the CMS page.
• Be sure to click the purple check button at the top right of the CMS page to save your changes.

After you save the CMS page:

• Check to make sure your changes are on the preview site: https://preview-onrr-frontend.app.cloud.gov/
• At this point, your changes should ONLY be available on the preview site. (That is the purpose of UNCLICKING the "reviewed" box in the CMS.)
• Check the Development Site: https://dev-onrr-frontend.app.cloud.gov/
• In the Development Site, you should see this "Draft" display below:

SME review

• If your task requires SME review and approval, send them the appropriate Preview Site link.
• Once you get SME approval, you can move your changes to the Development Site.

Development Site

In order to move your Preview Site changes to the Development Site:

• Navigate to the correct CMS page.
• CLICK the "reviewed" box under the Production section.
• Then click the purple check button at the top right of the CMS page to save your changes.

After you save the CMS page:

• Check the Development Site: https://dev-onrr-frontend.app.cloud.gov/
• You should now see your changes that were previously only on the Preview Site now in the Development Site.

Production Site

When you are ready for your changes to go live:

• Navigate to the onrr.gov-site on CircleCI: https://app.circleci.com/pipelines/github/ONRR/onrr.gov-site?branch=main
  • Make sure the project is set to "onrr.gov-site"
  • Make sure the branch is set to "main"

• Click the "Trigger Pipeline" button.
• You will the the following pop-up, click the blue "Trigger Pipeline" button.

• CircleCI will then build the workflow, with your changes incorporated.

NOTE: Any changes that are currently in the Development Site will be pulled into Production. Be sure to only move changes to the Development Site that are ready for Production.

After CircleCI finishes building:

• Check the Production Site: https://prod-onrr-frontend.app.cloud.gov/
• You should now see your changes that were previously on the Preview and Development Sites now on the Production Site.
• The changes should also appear on the beta site: https://beta.onrr.gov/
• Once the new site officially launches, changes should also appear on the live site: https://onrr.gov/