7.5. Dynamic plugin example

Procedure

1. Visit the console-plugin-template repository containing a template for creating plugins in a new tab.

   重要

   Custom plugin code is not supported by Red Hat. Only Cooperative community support is available for your plugin.

2. Create a GitHub repository for the template by clicking Use this template Create new repository.
3. Rename the new repository with the name of your plugin.
4. Clone the new repository to your local machine so you can edit the code.

5. Edit the package.json file, adding your plugin’s metadata to the consolePlugin declaration. For example:

   "consolePlugin": {
     "name": "my-plugin",
     "version": "0.0.1",
     "displayName": "My Plugin",
     "description": "Enjoy this shiny, new console plugin!",
     "exposedModules": {
       "ExamplePage": "./components/ExamplePage"
     },
     "dependencies": {
       "@console/pluginAPI": "/*"
     }
   }

   where:

   consolePlugin.name.my-plugin

   Update the name of your plugin.

   consolePlugin.version.0.0.1

   Update the version.

   consolePlugin.displayName.My Plugin

   Update the display name for your plugin.

   consolePlugin.description.Enjoy this shiny, new console plugin!

   Update the description with a synopsis about your plugin.

6. Add the following to the console-extensions.json file:

   {
     "type": "console.tab/horizontalNav",
     "properties": {
       "page": {
         "name": "Example Tab",
         "href": "example"
       },
       "model": {
         "group": "core",
         "version": "v1",
         "kind": "Pod"
       },
       "component": { "$codeRef": "ExampleTab" }
     }
   }

7. Edit the package.json file to include the following changes:

           "exposedModules": {
               "ExamplePage": "./components/ExamplePage",
               "ExampleTab": "./components/ExampleTab"
           }

8. Write a message to display on a new custom tab on the Pods page by creating a new file src/components/ExampleTab.tsx and adding the following script:

   import * as React from 'react';
   
   export default function ExampleTab() {
       return (
           <p>This is a custom tab added to a resource using a dynamic plugin.</p>
       );
   }

9. Install a Helm chart with the name of the plugin as the Helm release name into a new namespace or an existing namespace as specified by the -n command-line option to deploy your plugin on a cluster. Provide the location of the image within the plugin.image parameter by using the following command:

   $ helm upgrade -i  my-plugin charts/openshift-console-plugin -n my-plugin-namespace --create-namespace --set plugin.image=my-plugin-image-location

   注意

   For more information on deploying your plugin on a cluster, see "Deploy your plugin on a cluster".