Chapter 2. Breaking changes

• Modify the default-config/secret-files.yaml key in the default configuration of the Operator (rhdh-default-config ConfigMap in the rhdh-operator namespace) to include custom .npmrc content.

• In your Backstage custom resource (CR), complete the following steps:

  1. Create a new Secret containing the custom .npmrc content.
  2. Mount the Secret to the install-dynamic-plugins initContainer.

  3. Set the NPM_CONFIG_USERCONFIG environment variable to reference to the mounted .npmrc file in the spec.deployment.patch section.

     Example of a Secret containing the .npmrc file

     apiVersion: v1
     kind: Secret
     metadata:
       name: dynamic-plugins-npmrc
     type: Opaque
     stringData:
       .npmrc: |
         @my-company:registry=https://my-company.example.com
         //<registry-url>:_authToken=<auth-token>
     ---
     apiVersion: rhdh.redhat.com/v1alpha3
     kind: Backstage
     metadata:
       name: my-rhdh
     spec:
       application:
         dynamicPluginsConfigMapName: my-dynamic-plugins-rhdh
       # --- BEGIN WORKAROUND: Ensure you have the volumes, volume mounts and NPM_CONFIG_USERCONFIG env var listed below
       deployment:
         patch:
           spec:
             template:
               spec:
                 initContainers:
                   - name: install-dynamic-plugins
                     volumeMounts:
                       - mountPath: /opt/app-root/src/.my-dynamic-plugins-npmrc.dynamic-plugins
                         name: my-dynamic-plugins-npmrc
                     env:
                       - name:
                       - name: NPM_CONFIG_USERCONFIG
                         # path before .npmrc should be the same as in the mountPath above
                         # file name .npmrc should be the same as key in the dynamic-plugins-npmrc secret above
                         value: /opt/app-root/src/.my-dynamic-plugins-npmrc.dynamic-plugins/.npmrc
                 volumes:
                   - name: my-dynamic-plugins-npmrc
                     secret:
                       secretName: dynamic-plugins-npmrc
       # --- END WORKAROUND

Additional resources

• RHDHBUGS-2000