@backstage/plugin-kubernetes 0.7.10-next.1 → 0.8.0-next.3

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # @backstage/plugin-kubernetes
 
+## 0.8.0-next.3
+
+### Minor Changes
+
+- 754be7c5106: refactor kubernetes error detection to make way for proposed solutions
+
+  **BREAKING**: `DetectedError` now appears once per Kubernetes resource per error instead of for all resources which have that error, `namespace` and `name` fields are now in `sourceRef` object `message` is now a `string` instead of a `string[]`. `ErrorDetectableKind` has been removed.
+
+### Patch Changes
+
+- e7fb0117485: fixes a bug where an empty authorization header was provided to the proxy endpoint when a cluster had a server-side auth provider
+- c159ab64a60: `KubernetesBackendClient` now requires a `kubernetesAuthProvidersApi` value to be provided. `KubernetesApi` interface now has a proxy method requirement.
+- Updated dependencies
+  - @backstage/plugin-catalog-react@1.5.0-next.3
+  - @backstage/catalog-model@1.3.0-next.0
+  - @backstage/core-components@0.13.0-next.3
+  - @backstage/config@1.0.7
+  - @backstage/core-plugin-api@1.5.1-next.1
+  - @backstage/errors@1.1.5
+  - @backstage/theme@0.2.19-next.0
+  - @backstage/plugin-kubernetes-common@0.6.2-next.2
+
+## 0.7.10-next.2
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/core-components@0.12.6-next.2
+  - @backstage/plugin-catalog-react@1.4.1-next.2
+  - @backstage/core-plugin-api@1.5.1-next.1
+  - @backstage/catalog-model@1.2.1
+  - @backstage/config@1.0.7
+  - @backstage/theme@0.2.19-next.0
+  - @backstage/plugin-kubernetes-common@0.6.2-next.1
+
 ## 0.7.10-next.1
 
 ### Patch Changes

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="react" />
 import * as _backstage_core_plugin_api from '@backstage/core-plugin-api';
-import { DiscoveryApi, IdentityApi, OAuthApi, OpenIdConnectApi } from '@backstage/core-plugin-api';
+import { OAuthApi, OpenIdConnectApi, DiscoveryApi, IdentityApi } from '@backstage/core-plugin-api';
 import { Entity } from '@backstage/catalog-model';
 import { KubernetesRequestBody, ObjectsByEntityResponse, WorkloadsByEntityRequest, CustomObjectsByEntityRequest, ClusterObjects, CustomResourceMatcher, ClientPodStatus, ClusterAttributes } from '@backstage/plugin-kubernetes-common';
 import { JsonObject } from '@backstage/types';
@@ -15,7 +15,7 @@ declare const kubernetesPlugin: _backstage_core_plugin_api.BackstagePlugin<{
  *
  * @public
  */
-declare type EntityKubernetesContentProps = {
+type EntityKubernetesContentProps = {
     /**
      * Sets the refresh interval in milliseconds. The default value is 10000 (10 seconds)
      */
@@ -38,32 +38,25 @@ interface KubernetesApi {
     }[]>;
     getWorkloadsByEntity(request: WorkloadsByEntityRequest): Promise<ObjectsByEntityResponse>;
     getCustomObjectsByEntity(request: CustomObjectsByEntityRequest): Promise<ObjectsByEntityResponse>;
-}
-
-declare class KubernetesBackendClient implements KubernetesApi {
-    private readonly discoveryApi;
-    private readonly identityApi;
-    constructor(options: {
-        discoveryApi: DiscoveryApi;
-        identityApi: IdentityApi;
-    });
-    private handleResponse;
-    private postRequired;
-    getObjectsByEntity(requestBody: KubernetesRequestBody): Promise<ObjectsByEntityResponse>;
-    getWorkloadsByEntity(request: WorkloadsByEntityRequest): Promise<ObjectsByEntityResponse>;
-    getCustomObjectsByEntity(request: CustomObjectsByEntityRequest): Promise<ObjectsByEntityResponse>;
-    getClusters(): Promise<{
-        name: string;
-        authProvider: string;
-    }[]>;
+    proxy(options: {
+        clusterName: string;
+        path: string;
+        init?: RequestInit;
+    }): Promise<Response>;
 }
 
 interface KubernetesAuthProvider {
     decorateRequestBodyForAuth(requestBody: KubernetesRequestBody): Promise<KubernetesRequestBody>;
+    getCredentials(): Promise<{
+        token?: string;
+    }>;
 }
 declare const kubernetesAuthProvidersApiRef: _backstage_core_plugin_api.ApiRef<KubernetesAuthProvidersApi>;
 interface KubernetesAuthProvidersApi {
     decorateRequestBodyForAuth(authProvider: string, requestBody: KubernetesRequestBody): Promise<KubernetesRequestBody>;
+    getCredentials(authProvider: string): Promise<{
+        token?: string;
+    }>;
 }
 
 declare class KubernetesAuthProviders implements KubernetesAuthProvidersApi {
@@ -75,12 +68,18 @@ declare class KubernetesAuthProviders implements KubernetesAuthProvidersApi {
         };
     });
     decorateRequestBodyForAuth(authProvider: string, requestBody: KubernetesRequestBody): Promise<KubernetesRequestBody>;
+    getCredentials(authProvider: string): Promise<{
+        token?: string;
+    }>;
 }
 
 declare class GoogleKubernetesAuthProvider implements KubernetesAuthProvider {
     authProvider: OAuthApi;
     constructor(authProvider: OAuthApi);
     decorateRequestBodyForAuth(requestBody: KubernetesRequestBody): Promise<KubernetesRequestBody>;
+    getCredentials(): Promise<{
+        token: string;
+    }>;
 }
 
 /**
@@ -90,9 +89,37 @@ declare class GoogleKubernetesAuthProvider implements KubernetesAuthProvider {
  */
 declare class ServerSideKubernetesAuthProvider implements KubernetesAuthProvider {
     decorateRequestBodyForAuth(requestBody: KubernetesRequestBody): Promise<KubernetesRequestBody>;
+    getCredentials(): Promise<{}>;
+}
+
+declare class KubernetesBackendClient implements KubernetesApi {
+    private readonly discoveryApi;
+    private readonly identityApi;
+    private readonly kubernetesAuthProvidersApi;
+    constructor(options: {
+        discoveryApi: DiscoveryApi;
+        identityApi: IdentityApi;
+        kubernetesAuthProvidersApi: KubernetesAuthProvidersApi;
+    });
+    private handleResponse;
+    private postRequired;
+    private getCluster;
+    private getCredentials;
+    getObjectsByEntity(requestBody: KubernetesRequestBody): Promise<ObjectsByEntityResponse>;
+    getWorkloadsByEntity(request: WorkloadsByEntityRequest): Promise<ObjectsByEntityResponse>;
+    getCustomObjectsByEntity(request: CustomObjectsByEntityRequest): Promise<ObjectsByEntityResponse>;
+    getClusters(): Promise<{
+        name: string;
+        authProvider: string;
+    }[]>;
+    proxy(options: {
+        clusterName: string;
+        path: string;
+        init?: RequestInit;
+    }): Promise<Response>;
 }
 
-declare type FormatClusterLinkOptions = {
+type FormatClusterLinkOptions = {
     dashboardUrl?: string;
     dashboardApp?: string;
     dashboardParameters?: JsonObject;
@@ -122,18 +149,18 @@ interface ClusterLinksFormatterOptions {
     object: any;
     kind: string;
 }
-declare type ClusterLinksFormatter = (options: ClusterLinksFormatterOptions) => URL;
+type ClusterLinksFormatter = (options: ClusterLinksFormatterOptions) => URL;
 
 declare const clusterLinksFormatters: Record<string, ClusterLinksFormatter>;
 
-declare type ClusterProps = {
+type ClusterProps = {
     clusterObjects: ClusterObjects;
     podsWithErrors: Set<string>;
     children?: React.ReactNode;
 };
 declare const Cluster: ({ clusterObjects, podsWithErrors }: ClusterProps) => JSX.Element;
 
-declare type CronJobsAccordionsProps = {
+type CronJobsAccordionsProps = {
     children?: React.ReactNode;
 };
 declare const CronJobsAccordions: ({}: CronJobsAccordionsProps) => JSX.Element;
@@ -143,7 +170,7 @@ interface CustomResourcesProps {
 }
 declare const CustomResources: ({}: CustomResourcesProps) => JSX.Element;
 
-declare type ErrorPanelProps = {
+type ErrorPanelProps = {
     entityName: string;
     errorMessage?: string;
     clustersWithErrors?: ClusterObjects[];
@@ -156,31 +183,50 @@ declare const ErrorPanel: ({ entityName, errorMessage, clustersWithErrors, }: Er
  *
  * @public
  */
-declare type ErrorSeverity = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10;
-/**
- * Kubernetes kinds that errors might be reported by the plugin
- *
- * @public
- */
-declare type ErrorDetectableKind = 'Pod' | 'Deployment' | 'HorizontalPodAutoscaler';
+type ErrorSeverity = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10;
 /**
  * A list of errors keyed by Cluster name
  *
  * @public
  */
-declare type DetectedErrorsByCluster = Map<string, DetectedError[]>;
+type DetectedErrorsByCluster = Map<string, DetectedError[]>;
+interface ResourceRef {
+    name: string;
+    namespace: string;
+    kind: string;
+    apiGroup: string;
+}
 /**
  * Represents an error found on a Kubernetes object
  *
  * @public
  */
 interface DetectedError {
+    type: string;
     severity: ErrorSeverity;
-    cluster: string;
-    namespace: string;
-    kind: ErrorDetectableKind;
-    names: string[];
-    message: string[];
+    message: string;
+    proposedFix: ProposedFix[];
+    sourceRef: ResourceRef;
+    occuranceCount: number;
+}
+type ProposedFix = LogSolution | DocsSolution | EventsSolution;
+interface ProposedFixBase {
+    errorType: string;
+    rootCauseExplanation: string;
+    possibleFixes: string[];
+}
+interface LogSolution extends ProposedFixBase {
+    type: 'logs';
+    container: string;
+}
+interface DocsSolution extends ProposedFixBase {
+    type: 'docs';
+    docsLink: string;
+}
+interface EventsSolution extends ProposedFixBase {
+    type: 'events';
+    docsLink: string;
+    podName: string;
 }
 
 /**
@@ -191,7 +237,7 @@ interface DetectedError {
  */
 declare const detectErrors: (objects: ObjectsByEntityResponse) => DetectedErrorsByCluster;
 
-declare type ErrorReportingProps = {
+type ErrorReportingProps = {
     detectedErrors: DetectedErrorsByCluster;
 };
 declare const ErrorReporting: ({ detectedErrors }: ErrorReportingProps) => JSX.Element;
@@ -203,10 +249,10 @@ declare const HorizontalPodAutoscalerDrawer: (props: {
     children?: React.ReactNode;
 }) => JSX.Element;
 
-declare type IngressesAccordionsProps = {};
+type IngressesAccordionsProps = {};
 declare const IngressesAccordions: ({}: IngressesAccordionsProps) => JSX.Element;
 
-declare type JobsAccordionsProps = {
+type JobsAccordionsProps = {
     jobs: V1Job[];
     children?: React.ReactNode;
 };
@@ -231,18 +277,18 @@ declare const PodDrawer: (props: {
     expanded?: boolean;
 }) => JSX.Element;
 
-declare type PodColumns = 'READY' | 'RESOURCE';
-declare type PodsTablesProps = {
+type PodColumns = 'READY' | 'RESOURCE';
+type PodsTablesProps = {
     pods: V1Pod[];
     extraColumns?: PodColumns[];
     children?: React.ReactNode;
 };
 declare const PodsTable: ({ pods, extraColumns }: PodsTablesProps) => JSX.Element;
 
-declare type ServicesAccordionsProps = {};
+type ServicesAccordionsProps = {};
 declare const ServicesAccordions: ({}: ServicesAccordionsProps) => JSX.Element;
 
-declare type KubernetesContentProps = {
+type KubernetesContentProps = {
     entity: Entity;
     refreshIntervalMs?: number;
     children?: React.ReactNode;
@@ -271,4 +317,4 @@ declare const GroupedResponsesContext: React.Context<GroupedResponses>;
 
 declare const ClusterContext: React.Context<ClusterAttributes>;
 
-export { Cluster, ClusterContext, ClusterLinksFormatter, ClusterLinksFormatterOptions, CronJobsAccordions, CustomResources, DeploymentResources, DetectedError, DetectedErrorsByCluster, EntityKubernetesContent, EntityKubernetesContentProps, ErrorDetectableKind, ErrorPanel, ErrorReporting, ErrorSeverity, GoogleKubernetesAuthProvider, GroupedResponses, GroupedResponsesContext, HorizontalPodAutoscalerDrawer, IngressesAccordions, JobsAccordions, KubernetesApi, KubernetesAuthProviders, KubernetesAuthProvidersApi, KubernetesBackendClient, KubernetesContent, KubernetesDrawer, KubernetesObjects, PodDrawer, PodNamesWithErrorsContext, PodNamesWithMetricsContext, PodsTable, Router, ServerSideKubernetesAuthProvider, ServicesAccordions, clusterLinksFormatters, detectErrors, formatClusterLink, isKubernetesAvailable, kubernetesApiRef, kubernetesAuthProvidersApiRef, kubernetesPlugin, kubernetesPlugin as plugin, useCustomResources, useKubernetesObjects };
+export { Cluster, ClusterContext, ClusterLinksFormatter, ClusterLinksFormatterOptions, CronJobsAccordions, CustomResources, DeploymentResources, DetectedError, DetectedErrorsByCluster, EntityKubernetesContent, EntityKubernetesContentProps, ErrorPanel, ErrorReporting, ErrorSeverity, GoogleKubernetesAuthProvider, GroupedResponses, GroupedResponsesContext, HorizontalPodAutoscalerDrawer, IngressesAccordions, JobsAccordions, KubernetesApi, KubernetesAuthProviders, KubernetesAuthProvidersApi, KubernetesBackendClient, KubernetesContent, KubernetesDrawer, KubernetesObjects, PodDrawer, PodNamesWithErrorsContext, PodNamesWithMetricsContext, PodsTable, Router, ServerSideKubernetesAuthProvider, ServicesAccordions, clusterLinksFormatters, detectErrors, formatClusterLink, isKubernetesAvailable, kubernetesApiRef, kubernetesAuthProvidersApiRef, kubernetesPlugin, kubernetesPlugin as plugin, useCustomResources, useKubernetesObjects };