@backstage/plugin-kubernetes 0.12.17-next.2 → 0.12.17

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @backstage/plugin-kubernetes
 
+## 0.12.17
+
+### Patch Changes
+
+- 538c985: Updated installation documentation to use feature discovery as the default.
+- 0be2541: Promoted the plugin's translation ref to the stable package entry point. It was previously only available through the alpha entry point.
+- Updated dependencies
+  - @backstage/plugin-catalog-react@2.1.0
+  - @backstage/core-plugin-api@1.12.4
+  - @backstage/core-components@0.18.8
+  - @backstage/frontend-plugin-api@0.15.0
+  - @backstage/plugin-permission-react@0.4.41
+  - @backstage/plugin-kubernetes-react@0.5.17
+  - @backstage/catalog-model@1.7.7
+
 ## 0.12.17-next.2
 
 ### Patch Changes

package/README.md

@@ -8,15 +8,20 @@ It will elevate the visibility of errors where identified, and provide drill dow
 
 It directly interfaces with the [Kubernetes Backend Plugin (`@backstage-plugin-kubernetes-backend`)](https://github.com/backstage/backstage/tree/master/plugins/kubernetes-backend).
 
-_This plugin was created through the Backstage CLI_
-
 ## Introduction
 
 See our announcement blog post [New Backstage feature: Kubernetes for Service Owners](https://backstage.io/blog/2021/01/12/new-backstage-feature-kubernetes-for-service-owners) to learn more about the motivation behind developing the plugin.
 
 ## Setup & Configuration
 
-This plugin must be explicitly added to a Backstage app, along with it's peer backend plugin.
+This plugin must be installed in a Backstage app, along with its peer backend plugin.
+
+```bash
+# From your Backstage root directory
+yarn --cwd packages/app add @backstage/plugin-kubernetes
+```
+
+Once installed, the plugin is automatically available in your app through the default feature discovery. For more details and alternative installation methods, see [installing plugins](https://backstage.io/docs/frontend-system/building-apps/installing-plugins).
 
 It requires configuration in the Backstage `app-config.yaml` to connect to a Kubernetes API control plane.
 
@@ -24,35 +29,9 @@ In addition, configuration of an entity's `catalog-info.yaml` helps identify whi
 
 For more information, see the [formal documentation about the Kubernetes feature in Backstage](https://backstage.io/docs/features/kubernetes/overview).
 
-## Getting started
-
-Your plugin has been added to the example app in this repository, meaning you'll be able to access it by running `yarn start` in the root directory, and then navigating to [/kubernetes](http://localhost:3000/catalog/default/component/:component-name/kubernetes).
-
-You can also serve the plugin in isolation by running `yarn start` in the plugin directory.
-This method of serving the plugin provides quicker iteration speed and a faster startup and hot reloads.
-It is only meant for local development, and the setup for it can be found inside the [/dev](./dev) directory.
-
-### Integrating with `EntityPage` (New Frontend System)
-
-Follow this section if you are using Backstage's [new frontend system](https://backstage.io/docs/frontend-system/).
+### Enabling the entity content tab
 
-1. Import `kubernetesPlugin` in your `App.tsx` and add it to your app's `features` array:
-
-```typescript
-import kubernetesPlugin from '@backstage/plugin-kubernetes/alpha';
-
-// ...
-
-export const app = createApp({
-  features: [
-    // ...
-    kubernetesPlugin,
-    // ...
-  ],
-});
-```
-
-2. Next, enable your desired extensions in `app-config.yaml`.
+Enable the Kubernetes entity content extension in your `app-config.yaml`:
 
 ```yaml
 app:
@@ -77,3 +56,11 @@ app:
                 - resource
                 - system
 ```
+
+## Getting started
+
+Your plugin has been added to the example app in this repository, meaning you'll be able to access it by running `yarn start` in the root directory, and then navigating to [/kubernetes](http://localhost:3000/catalog/default/component/:component-name/kubernetes).
+
+You can also serve the plugin in isolation by running `yarn start` in the plugin directory.
+This method of serving the plugin provides quicker iteration speed and a faster startup and hot reloads.
+It is only meant for local development, and the setup for it can be found inside the [/dev](./dev) directory.

package/dist/alpha/index.esm.js

@@ -0,0 +1,7 @@
+import { kubernetesTranslationRef as kubernetesTranslationRef$1 } from './translation.esm.js';
+export { default } from './plugin.esm.js';
+
+const kubernetesTranslationRef = kubernetesTranslationRef$1;
+
+export { kubernetesTranslationRef };
+//# sourceMappingURL=index.esm.js.map

package/dist/alpha/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../../src/alpha/index.ts"],"sourcesContent":["/*\n * Copyright 2023 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { kubernetesTranslationRef as _kubernetesTranslationRef } from './translation';\n\n/**\n * @alpha\n * @deprecated Import from `@backstage/plugin-kubernetes` instead.\n */\nexport const kubernetesTranslationRef = _kubernetesTranslationRef;\nexport { default } from './plugin';\n"],"names":["_kubernetesTranslationRef"],"mappings":";;;AAqBO,MAAM,wBAAA,GAA2BA;;;;"}

package/dist/alpha/translation.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"translation.esm.js","sources":["../../src/alpha/translation.ts"],"sourcesContent":["/*\n * Copyright 2025 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { createTranslationRef } from '@backstage/core-plugin-api/alpha';\n\n/** @alpha */\nexport const kubernetesTranslationRef = createTranslationRef({\n  id: 'kubernetes',\n  messages: {\n    kubernetesContentPage: {\n      permissionAlert: {\n        title: 'Permission required',\n        message:\n          \"To view Kubernetes objects, contact your portal administrator to give you the 'kubernetes.clusters.read' and 'kubernetes.resources.read' permission.\",\n      },\n      title: 'Your Clusters',\n      emptyState: {\n        title: 'No Kubernetes resources',\n        description: 'No resources on any known clusters for {{entityName}}',\n      },\n    },\n    entityContent: {\n      title: 'Kubernetes',\n    },\n  },\n});\n"],"names":[],"mappings":";;AAkBO,MAAM,2BAA2B,oBAAA,CAAqB;AAAA,EAC3D,EAAA,EAAI,YAAA;AAAA,EACJ,QAAA,EAAU;AAAA,IACR,qBAAA,EAAuB;AAAA,MACrB,eAAA,EAAiB;AAAA,QACf,KAAA,EAAO,qBAAA;AAAA,QACP,OAAA,EACE;AAAA,OACJ;AAAA,MACA,KAAA,EAAO,eAAA;AAAA,MACP,UAAA,EAAY;AAAA,QACV,KAAA,EAAO,yBAAA;AAAA,QACP,WAAA,EAAa;AAAA;AACf,KACF;AAAA,IACA,aAAA,EAAe;AAAA,MACb,KAAA,EAAO;AAAA;AACT;AAEJ,CAAC;;;;"}
+{"version":3,"file":"translation.esm.js","sources":["../../src/alpha/translation.ts"],"sourcesContent":["/*\n * Copyright 2025 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { createTranslationRef } from '@backstage/core-plugin-api/alpha';\n\n/** @public */\nexport const kubernetesTranslationRef = createTranslationRef({\n  id: 'kubernetes',\n  messages: {\n    kubernetesContentPage: {\n      permissionAlert: {\n        title: 'Permission required',\n        message:\n          \"To view Kubernetes objects, contact your portal administrator to give you the 'kubernetes.clusters.read' and 'kubernetes.resources.read' permission.\",\n      },\n      title: 'Your Clusters',\n      emptyState: {\n        title: 'No Kubernetes resources',\n        description: 'No resources on any known clusters for {{entityName}}',\n      },\n    },\n    entityContent: {\n      title: 'Kubernetes',\n    },\n  },\n});\n"],"names":[],"mappings":";;AAkBO,MAAM,2BAA2B,oBAAA,CAAqB;AAAA,EAC3D,EAAA,EAAI,YAAA;AAAA,EACJ,QAAA,EAAU;AAAA,IACR,qBAAA,EAAuB;AAAA,MACrB,eAAA,EAAiB;AAAA,QACf,KAAA,EAAO,qBAAA;AAAA,QACP,OAAA,EACE;AAAA,OACJ;AAAA,MACA,KAAA,EAAO,eAAA;AAAA,MACP,UAAA,EAAY;AAAA,QACV,KAAA,EAAO,yBAAA;AAAA,QACP,WAAA,EAAa;AAAA;AACf,KACF;AAAA,IACA,aAAA,EAAe;AAAA,MACb,KAAA,EAAO;AAAA;AACT;AAEJ,CAAC;;;;"}

package/dist/alpha.d.ts

@@ -5,16 +5,6 @@ import * as react from 'react';
 import * as _backstage_filter_predicates from '@backstage/filter-predicates';
 import * as _backstage_core_plugin_api from '@backstage/core-plugin-api';
 
-/** @alpha */
-declare const kubernetesTranslationRef: _backstage_frontend_plugin_api.TranslationRef<"kubernetes", {
-    readonly "entityContent.title": "Kubernetes";
-    readonly "kubernetesContentPage.title": "Your Clusters";
-    readonly "kubernetesContentPage.emptyState.title": "No Kubernetes resources";
-    readonly "kubernetesContentPage.emptyState.description": "No resources on any known clusters for {{entityName}}";
-    readonly "kubernetesContentPage.permissionAlert.message": "To view Kubernetes objects, contact your portal administrator to give you the 'kubernetes.clusters.read' and 'kubernetes.resources.read' permission.";
-    readonly "kubernetesContentPage.permissionAlert.title": "Permission required";
-}>;
-
 declare const _default: _backstage_frontend_plugin_api.OverridableFrontendPlugin<{
     kubernetes: _backstage_core_plugin_api.RouteRef<undefined>;
 }, {}, {
@@ -138,4 +128,17 @@ declare const _default: _backstage_frontend_plugin_api.OverridableFrontendPlugin
     }>;
 }>;
 
+/**
+ * @alpha
+ * @deprecated Import from `@backstage/plugin-kubernetes` instead.
+ */
+declare const kubernetesTranslationRef: _backstage_frontend_plugin_api.TranslationRef<"kubernetes", {
+    readonly "entityContent.title": "Kubernetes";
+    readonly "kubernetesContentPage.title": "Your Clusters";
+    readonly "kubernetesContentPage.emptyState.title": "No Kubernetes resources";
+    readonly "kubernetesContentPage.emptyState.description": "No resources on any known clusters for {{entityName}}";
+    readonly "kubernetesContentPage.permissionAlert.message": "To view Kubernetes objects, contact your portal administrator to give you the 'kubernetes.clusters.read' and 'kubernetes.resources.read' permission.";
+    readonly "kubernetesContentPage.permissionAlert.title": "Permission required";
+}>;
+
 export { _default as default, kubernetesTranslationRef };

package/dist/alpha.esm.js

@@ -1,3 +1,3 @@
-export { kubernetesTranslationRef } from './alpha/translation.esm.js';
+export { kubernetesTranslationRef } from './alpha/index.esm.js';
 export { default } from './alpha/plugin.esm.js';
 //# sourceMappingURL=alpha.esm.js.map

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import * as _backstage_core_plugin_api from '@backstage/core-plugin-api';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Entity } from '@backstage/catalog-model';
 export * from '@backstage/plugin-kubernetes-react';
+import * as _backstage_frontend_plugin_api from '@backstage/frontend-plugin-api';
 
 declare const kubernetesPlugin: _backstage_core_plugin_api.BackstagePlugin<{
     entityContent: _backstage_core_plugin_api.RouteRef<undefined>;
@@ -24,5 +25,15 @@ declare const Router: (props: {
     refreshIntervalMs?: number;
 }) => react_jsx_runtime.JSX.Element;
 
-export { EntityKubernetesContent, Router, isKubernetesAvailable, kubernetesPlugin, kubernetesPlugin as plugin };
+/** @public */
+declare const kubernetesTranslationRef: _backstage_frontend_plugin_api.TranslationRef<"kubernetes", {
+    readonly "entityContent.title": "Kubernetes";
+    readonly "kubernetesContentPage.title": "Your Clusters";
+    readonly "kubernetesContentPage.emptyState.title": "No Kubernetes resources";
+    readonly "kubernetesContentPage.emptyState.description": "No resources on any known clusters for {{entityName}}";
+    readonly "kubernetesContentPage.permissionAlert.message": "To view Kubernetes objects, contact your portal administrator to give you the 'kubernetes.clusters.read' and 'kubernetes.resources.read' permission.";
+    readonly "kubernetesContentPage.permissionAlert.title": "Permission required";
+}>;
+
+export { EntityKubernetesContent, Router, isKubernetesAvailable, kubernetesPlugin, kubernetesTranslationRef, kubernetesPlugin as plugin };
 export type { EntityKubernetesContentProps };

package/dist/index.esm.js

@@ -1,4 +1,5 @@
 export { EntityKubernetesContent, kubernetesPlugin, kubernetesPlugin as plugin } from './plugin.esm.js';
 export { Router, isKubernetesAvailable } from './Router.esm.js';
 export * from '@backstage/plugin-kubernetes-react';
+export { kubernetesTranslationRef } from './alpha/translation.esm.js';
 //# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}
+{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}

package/dist/package.json.esm.js

@@ -1,5 +1,5 @@
 var name = "@backstage/plugin-kubernetes";
-var version = "0.12.17-next.2";
+var version = "0.12.17";
 var description = "A Backstage plugin that integrates towards Kubernetes";
 var backstage = {
 	role: "frontend-plugin",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/plugin-kubernetes",
-  "version": "0.12.17-next.2",
+  "version": "0.12.17",
   "description": "A Backstage plugin that integrates towards Kubernetes",
   "backstage": {
     "role": "frontend-plugin",
@@ -70,20 +70,20 @@
     "test": "backstage-cli package test"
   },
   "dependencies": {
-    "@backstage/catalog-model": "1.7.6",
-    "@backstage/core-components": "0.18.8-next.1",
-    "@backstage/core-plugin-api": "1.12.4-next.1",
-    "@backstage/frontend-plugin-api": "0.15.0-next.1",
-    "@backstage/plugin-catalog-react": "2.1.0-next.2",
-    "@backstage/plugin-kubernetes-common": "0.9.10",
-    "@backstage/plugin-kubernetes-react": "0.5.17-next.0",
-    "@backstage/plugin-permission-react": "0.4.41-next.0",
+    "@backstage/catalog-model": "^1.7.7",
+    "@backstage/core-components": "^0.18.8",
+    "@backstage/core-plugin-api": "^1.12.4",
+    "@backstage/frontend-plugin-api": "^0.15.0",
+    "@backstage/plugin-catalog-react": "^2.1.0",
+    "@backstage/plugin-kubernetes-common": "^0.9.10",
+    "@backstage/plugin-kubernetes-react": "^0.5.17",
+    "@backstage/plugin-permission-react": "^0.4.41",
     "@material-ui/core": "^4.12.2"
   },
   "devDependencies": {
-    "@backstage/cli": "0.36.0-next.2",
-    "@backstage/dev-utils": "1.1.21-next.1",
-    "@backstage/test-utils": "1.7.16-next.0",
+    "@backstage/cli": "^0.36.0",
+    "@backstage/dev-utils": "^1.1.21",
+    "@backstage/test-utils": "^1.7.16",
     "@testing-library/dom": "^10.0.0",
     "@testing-library/jest-dom": "^6.0.0",
     "@testing-library/react": "^16.0.0",