第 5 章 插件故障排除

流程

1. 检查 RHDH pod 日志，以识别插件是否需要特定的环境变量或额外的配置，例如：

   Plugin '<PLUGIN_NAME>' threw an error during startup, waiting for X other plugins to finish before shutting down the process. Plugin '<PLUGIN_NAME>' startup failed; caused by Error: Missing required config value at '<concretePluginRequiredVariable.name>' in 'app-config.local.yaml' type="initialization"

2. 通过检查 dynamic-plugins.default.yaml 文件来验证所需的配置，该文件列出了每个插件所需的环境变量。每个插件的变量格式为 ${PLUGIN_VARIABLE_NAME}

3. 如果缺少所需的环境变量，请使用 secret 设置环境变量。例如：

   kind: Secret
   apiVersion: v1
   metadata:
     name: rhdh-secrets
     labels:
       backstage.io/kubernetes-id: developer-hub
   data:
     PLUGIN_VARIABLE_NAME: 'dummy-value'
   type: Opaque

4. 挂载 secret：

   1. 如果使用 Operator 部署 RHDH，请更新 Backstage CR，如下所示：

      spec:
        application:
          extraEnvs:
            secrets:
              - name: rhdh-secrets

   2. 如果使用 Helm Chart 部署 RHDH，请在 Helm Chart 值中的 upstream.backstage 键中，输入 Developer Hub rhdh-secrets secret 的名称作为 extraEnvVarsSecrets 字段的值。例如：

      upstream:
        backstage:
          extraEnvVarsSecrets:
            - rhdh-secrets