Skip to content

From Backstage-owned plugin

If you are migrating from the PagerDuty plugin that was maintained by Backstage (@backstage/plugin-pagerduty), the steps to migrate are pretty straight forward.

  1. Remove the legacy PagerDuty plugin from your Backstage project

    # From your Backstage root directory
    yarn remove --cwd packages/app @backstage/plugin-pagerduty
    
  2. Install the new frontend PagerDuty plugin for Backstage

    # From your Backstage root directory
    yarn add --cwd packages/app @pagerduty/backstage-plugin @pagerduty/backstage-plugin-common
    
  3. Replace all occurrences of @backstage/plugin-pagerduty with @pagerduty/backstage-plugin in your components

  4. Install the backend PagerDuty plugin for Backstage

    yarn add --cwd packages/backend @pagerduty/backstage-plugin-backend @pagerduty/backstage-plugin-common
    
  5. Add the backend plugin to your Backstage project

  6. Configure API credentials to make requests to PagerDuty REST API

  7. Remove PagerDuty proxy configuration from you app-config.yaml file

  8. Re-install dependencies and run Backstage locally to test that everything is working

    # From your Backstage root directory
    yarn install && yarn dev