Uploaded image for project: 'Red Hat Internal Developer Platform'
  1. Red Hat Internal Developer Platform
  2. RHIDP-8688

Upgrade notes for Adoption insights from previous versions to RHDH 1.7

    • Icon: Task Task
    • Resolution: Done
    • Icon: Undefined Undefined
    • None
    • 1.7.0
    • Documentation, Plugins
    • None

      The Adoption Insights plugin in earlier versions of RHDH1.7 was disabled by default and required some actions (described here) to enable it. However, from version RHDH1.7 this plugin is enabled by default and upgrading to that version requires some actions to complete it successfully, otherwise you will get the following error:

       

      /opt/app-root/src/node_modules/@backstage/backend-app-api/dist/wiring/BackendInitializer.cjs.js:196
                  throw new Error(`Plugin '${r.pluginId}' is already registered`);
                        ^Error: Plugin 'adoption-insights' is already registered
          at #doStart (/opt/app-root/src/node_modules/@backstage/backend-app-api/dist/wiring/BackendInitializer.cjs.js:196:19)
          at process.processTicksAndRejections (node:internal/process/task_queues:105:5)
          at async BackendInitializer.start (/opt/app-root/src/node_modules/@backstage/backend-app-api/dist/wiring/BackendInitializer.cjs.js:163:5)
          at async BackstageBackend.start (/opt/app-root/src/node_modules/@backstage/backend-app-api/dist/wiring/BackstageBackend.cjs.js:19:5)Node.js v22.16.0
      

      It is because there is a conflict with the previous definition of the Adoption Insights plugins, and the new ones enabled by default. 

       

      If your dynamic plugin configuration is similar to:

       

      kind: ConfigMap
      apiVersion: v1
      metadata:
        name: dynamic-plugins-rhdh
      data:
        dynamic-plugins.yaml: |
          includes:
            - dynamic-plugins.default.yaml
          plugins:
            # Other Plugins
            # Adoptions Insights
            - package: ./dynamic-plugins/dist/backstage-community-plugin-analytics-provider-segment
              disabled: true
            - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-adoption-insights:bs_1.35.1__0.0.2!red-hat-developer-hub-backstage-plugin-adoption-insights
              disabled: false
              pluginConfig:
                dynamicPlugins:
                  frontend:
                    red-hat-developer-hub.backstage-plugin-adoption-insights:
                      appIcons:
                        - name: adoptionInsightsIcon
                          importName: AdoptionInsightsIcon
                      dynamicRoutes:
                        - path: /adoption-insights
                          importName: AdoptionInsightsPage
                          menuItem:
                            icon: adoptionInsightsIcon
                            text: Adoption Insights
                      menuItems:
                        adoption-insights:
                          parent: admin
                          icon: adoptionInsightsIcon
            - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-adoption-insights-backend:bs_1.35.1__0.0.2!red-hat-developer-hub-backstage-plugin-adoption-insights-backend
              disabled: false
            - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-analytics-module-adoption-insights:bs_1.35.1__0.0.2!red-hat-developer-hub-backstage-plugin-analytics-module-adoption-insights
              disabled: false
              pluginConfig:
                dynamicPlugins:
                  frontend:
                    red-hat-developer-hub.backstage-plugin-analytics-module-adoption-insights:
                      apiFactories:
                        - importName: AdoptionInsightsAnalyticsApiFactory
      

      Commented those references is required to avoid this issue.

      This step should be described somewhere in the upgrading or Adoption Insights documentation as part of the upgrade from previous versions.

              rhn-support-pabel Priyanka Kantem
              rmarting@redhat.com Roman Martin Gil
              RHIDP - Documentation
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

                Created:
                Updated:
                Resolved: