Chapter 2. Managing applications that show in the dashboard
2.1. Adding an application to the dashboard
If you have installed an application in your OpenShift Container Platform cluster, you can add a tile for that application to the OpenShift AI dashboard (the Applications
Prerequisites
- You have cluster administrator privileges for your OpenShift Container Platform cluster.
-
The dashboard configuration enablement option is set to
true
(the default). Note that an admin user can disable this ability as described in Preventing users from adding applications to the dashboard.
Procedure
- Log in to the OpenShift Container Platform console as a cluster administrator.
-
In the Administrator perspective, click Home
API Explorer. -
On the API Explorer page, search for the
OdhApplication
kind. -
Click the
OdhApplication
kind to open the resource details page. -
On the OdhApplication details page, select the
redhat-ods-applications
project from the Project list. - Click the Instances tab.
- Click Create OdhApplication.
On the Create OdhApplication page, copy the following code and paste it into the YAML editor.
apiVersion: dashboard.opendatahub.io/v1 kind: OdhApplication metadata: name: examplename namespace: redhat-ods-applications labels: app: odh-dashboard app.kubernetes.io/part-of: odh-dashboard spec: enable: validationConfigMap: examplename-enable img: >- <svg width="24" height="25" viewBox="0 0 24 25" fill="none" xmlns="http://www.w3.org/2000/svg"> <path d="path data" fill="#ee0000"/> </svg> getStartedLink: 'https://example.org/docs/quickstart.html' route: exampleroutename routeNamespace: examplenamespace displayName: Example Name kfdefApplications: [] support: third party support csvName: '' provider: example docsLink: 'https://example.org/docs/index.html' quickStart: '' getStartedMarkDown: >- # Example Enter text for the information panel. description: >- Enter summary text for the tile. category: Self-managed | Partner managed | {org-name} managed
Modify the parameters in the code for your application.
TipTo see example YAML files, click Home
API Explorer, select OdhApplication
, click the Instances tab, select an instance, and then click the YAML tab.- Click Create. The application details page appears.
- Log in to OpenShift AI.
-
In the left menu, click Applications
Explore. - Locate the new tile for your application and click it.
- In the information pane for the application, click Enable.
Verification
-
In the left menu of the OpenShift AI dashboard, click Applications
Enabled and verify that your application is available.
2.2. Preventing users from adding applications to the dashboard
By default, admin users are allowed to add applications to the OpenShift AI dashboard Application
You can disable the ability for admin users to add applications to the dashboard.
Note: The Jupyter tile is enabled by default. To disable it, see Hiding the default Jupyter application.
Prerequisite
- You have cluster administrator privileges for your OpenShift Container Platform cluster.
Procedure
- Log in to the OpenShift Container Platform console as a cluster administrator.
Open the dashboard configuration file:
-
In the Administrator perspective, click Home
API Explorer. -
In the search bar, enter
OdhDashboardConfig
to filter by kind. -
Click the
OdhDashboardConfig
custom resource (CR) to open the resource details page. -
Select the
redhat-ods-applications
project from the Project list. - Click the Instances tab.
-
Click the
odh-dashboard-config
instance to open the details page. - Click the YAML tab.
-
In the Administrator perspective, click Home
-
In the
spec:dashboardConfig
section, set the value ofenablement
tofalse
to disable the ability for dashboard users to add applications to the dashboard. - Click Save to apply your changes and then click Reload to make sure that your changes are synced to the cluster.
Verification
Open the OpenShift AI dashboard Application
2.3. Showing or hiding information about enabled applications
If you have installed another application in your OpenShift Container Platform cluster, you can add a tile for that application to the OpenShift AI dashboard (the Applications
Prerequisites
- You have cluster administrator privileges for your OpenShift Container Platform cluster.
Procedure
- Log in to the OpenShift Container Platform console as a cluster administrator.
-
In the Administrator perspective, click Home
API Explorer. -
On the API Explorer page, search for the
OdhApplication
kind. -
Click the
OdhApplication
kind to open the resource details page. -
On the OdhApplication details page, select the
redhat-ods-applications
project from the Project list. - Click the Instances tab.
- Click Create OdhApplication.
On the Create OdhApplication page, copy the following code and paste it into the YAML editor.
apiVersion: dashboard.opendatahub.io/v1 kind: OdhApplication metadata: name: examplename namespace: redhat-ods-applications labels: app: odh-dashboard app.kubernetes.io/part-of: odh-dashboard spec: enable: validationConfigMap: examplename-enable img: >- <svg width="24" height="25" viewBox="0 0 24 25" fill="none" xmlns="http://www.w3.org/2000/svg"> <path d="path data" fill="#ee0000"/> </svg> getStartedLink: 'https://example.org/docs/quickstart.html' route: exampleroutename routeNamespace: examplenamespace displayName: Example Name kfdefApplications: [] support: third party support csvName: '' provider: example docsLink: 'https://example.org/docs/index.html' quickStart: '' getStartedMarkDown: >- # Example Enter text for the information panel. description: >- Enter summary text for the tile. category: Self-managed | Partner managed | Red Hat managed
Modify the parameters in the code for your application.
TipTo see example YAML files, click Home
API Explorer, select OdhApplication
, click the Instances tab, select an instance, and then click the YAML tab.- Click Create. The application details page appears.
- Log in to OpenShift AI.
-
In the left menu, click Applications
Explore. - Locate the new tile for your application and click it.
- In the information pane for the application, click Enable.
Verification
-
In the left menu of the OpenShift AI dashboard, click Applications
Enabled and verify that your application is available.
2.4. Hiding the default Jupyter application
The OpenShift AI dashboard includes Jupyter as an enabled application by default.
To hide the Jupyter tile from the list of Enabled applications, edit the dashboard configuration file.
Prerequisite
- You have cluster administrator privileges for your OpenShift Container Platform cluster.
Procedure
- Log in to the OpenShift Container Platform console as a cluster administrator.
Open the dashboard configuration file:
-
In the Administrator perspective, click Home
API Explorer. -
In the search bar, enter
OdhDashboardConfig
to filter by kind. -
Click the
OdhDashboardConfig
custom resource (CR) to open the resource details page. -
Select the
redhat-ods-applications
project from the Project list. - Click the Instances tab.
-
Click the
odh-dashboard-config
instance to open the details page. - Click the YAML tab.
-
In the Administrator perspective, click Home
-
In the
spec:notebookController
section, set the value ofenabled
tofalse
to hide the Jupyter tile from the list of Enabled applications. - Click Save to apply your changes and then click Reload to make sure that your changes are synced to the cluster.
Verification
In the OpenShift AI dashboard, select Applications> Enabled. You should not see the Jupyter tile.