Chapter 2. Importing a custom workbench image

Procedure

1. From the OpenShift AI dashboard, click Settings Workbench images.

   The Workbench images page appears. Previously imported images are displayed. To enable or disable a previously imported image, on the row containing the relevant image, click the toggle in the Enable column.

2. Optional: If you want to associate an accelerator and you have not already created a hardware profile, click Create profile on the row containing the image and complete the relevant fields. If the image does not contain an accelerator identifier, you must manually configure one before creating an associated hardware profile.

3. Click Import new image. Alternatively, if no previously imported images were found, click Import image.

   The Import workbench image dialog appears.

4. In the Image location field, enter the URL of the repository containing the image. For example: quay.io/my-repo/my-image:tag, quay.io/my-repo/my-image@sha256:xxxxxxxxxxxxx, or docker.io/my-repo/my-image:tag.
5. In the Name field, enter an appropriate name for the image.
6. Optional: In the Description field, enter a description for the image.
7. Optional: From the Accelerator identifier list, select an identifier to set its accelerator as recommended with the image. If the image contains only one accelerator identifier, the identifier name displays by default.

8. Optional: Add software to the image. After the import has completed, the software is added to the image’s meta-data and displayed on the workbench creation page.

   1. Click the Software tab.
   2. Click the Add software button.
   3. Click Edit ( ).
   4. Enter the Software name.
   5. Enter the software Version.
   6. Click Confirm ( ) to confirm your entry.
   7. To add additional software, click Add software, complete the relevant fields, and confirm your entry.

9. Optional: Add packages to the workbench images. After the import has completed, the packages are added to the image’s meta-data and displayed on the workbench creation page.

   1. Click the Packages tab.
   2. Click the Add package button.
   3. Click Edit ( ).
   4. Enter the Package name. For example, if you want to include data science pipeline V2 automatically, as a runtime configuration, type odh-elyra.
   5. Enter the package Version. For example, type 3.16.7.
   6. Click Confirm ( ) to confirm your entry.
   7. To add an additional package, click Add package, complete the relevant fields, and confirm your entry.
10. Click Import.