Chapter 3. Creating a model registry

Procedure

1. From the OpenShift AI dashboard, click Settings Model resources and operations Model registry settings.

2. Click Create model registry.

   The Create model registry dialog opens.

3. In the Name field, enter a name for the model registry.

4. Optional: Click Edit resource name, and enter a specific resource name for the model registry in the Resource name field. By default, the resource name matches the name of the model registry.

   Important

   Resource names are what your resources are labeled as in OpenShift. Your resource name cannot exceed 253 characters, must consist of lowercase alphanumeric characters or -, and must start and end with an alphanumeric character. Resource names are not editable after creation.

   The resource name must not match the name of any other model registry resource in your OpenShift cluster.

5. Optional: In the Description field, enter a description for the model registry.

6. In the Database section, click one of the following options to select where your model data is stored:

   • Default database (non-production): Use the PostgreSQL database that is enabled by default on your OpenShift cluster.

     Note

     The default database is designed for evaluation, development, and testing purposes only. Red Hat does not support this database for production use cases.

   • External database: Connect an external MySQL or PostgreSQL database designed for production use cases.

7. If you selected External database, enter the details for the external database where your model data is stored:

   • Database type: Select MySQL or PostgreSQL from the list.

   • Host: Enter the database hostname, depending on where the database is running:

     1. In the rhoai-model-registries namespace, enter only the hostname for the database.
     2. In a different namespace from rhoai-model-registries, enter the database hostname details in <hostname>.<namespace>.svc.cluster.local format.
   • Port: Enter the port number for the database. The default port for MySQL is 3306. The default port for PostgreSQL is 5432.
   • Username: Enter the default user name that is connected to the database.
   • Password: Enter the password for the default user account.
   • Database: Enter the database name.

   • Optional: Add CA certificate to secure database connection: Select this option to use a certificate with your database connection and specify one of the following options.

     Important

     If your external database is configured to enforce Transport Layer Security (TLS), you must add a Certificate Authority (CA) certificate.

     1. Click Use cluster-wide CA bundle to use the ca-bundle.crt bundle in the odh-trusted-ca-bundle ConfigMap.
     2. Click Use Red Hat OpenShift AI CA bundle to use the odh-ca-bundle.crt bundle in the odh-trusted-ca-bundle ConfigMap.

     3. Click Choose from existing certificates to select an existing certificate. You can select the key of any ConfigMap or secret in the rhoai-model-registries namespace.

        1. From the Resource list, select a ConfigMap or secret.
        2. From the Key list, select a key.

     4. Click Upload new certificate to upload a new certificate as a ConfigMap.

        1. Drag and drop the PEM file for your certificate into the Certificate field, or click Upload to select a file from your local machine’s file system.

           Note

           Uploading a certificate creates the db-credential ConfigMap with the ca.crt key.

           To upload a certificate as a secret, you must create a secret in the OpenShift rhoai-model-registries namespace, and then select it as an existing certificate when you create your model registry.

           For more information about creating secrets, see Providing sensitive data to pods by using secrets in the OpenShift Container Platform documentation.

8. Click Create.