Deployment process - NIAID-Data-Ecosystem/nde-strapi GitHub Wiki

The Strapi instance is deployed automatically to AWS using GitHub Actions.

🌱 Branch Overview

  • dev Used for internal development and testing. Changes here are reflected in the development environment. The development instance is intended primarily for testing major updates (such as version upgrades), it has a separate/isolated server and database.

  • main Represents the production-ready version. The staging and production environments share a strapi application and database. Pushing to this branch triggers a deployment to the staging and production environments.

Additional information about the different environment routes can be found here.

Deploying content to the portal

For most content types managed in Strapi, updates made through the CMS are reflected automatically in the portal without requiring code changes or manual deployment.

🔄 When a Portal Rebuild is Required

If your content update involves the creation of a new route in the NIAID Data Ecosystem Portal - such as adding a new dynamic page (ex: documentation page docs/new-route) - you will need to trigger a portal rebuild to generate the new route.

Example

If you add a documentation page titled "Help" with the slug /docs/help, you must initiate a rebuild of the portal. This ensures that the route is statically generated and becomes accessible on the live site.

✅ No code changes are needed - just the rebuild.

Additional information about dynamic routing in Next.js can be found here.

Steps to re-build:

  1. Navigate to the NIAID Data Ecosystem Portal Github Actions tab. Find the last deployment on the desired branch. image

  2. Click on re-run all jobs. image