Chapter 2. Creating a model registry
You can create a model registry to store, share, version, deploy, and track your models.
Prerequisites
- You have logged in to OpenShift AI as a user with OpenShift AI administrator privileges.
- A cluster administrator has configured and enabled the model registry component in your OpenShift AI deployment. For more information, see Configuring the model registry component.
- The model registry component is enabled for your OpenShift AI deployment.
- You have access to an external MySQL database which uses at least MySQL version 5.x. However, Red Hat recommends that you use MySQL version 8.x.
Procedure
-
From the OpenShift AI dashboard, click Settings
Model registry settings. Click Create model registry.
The Create model registry page opens.
- In the Name field, enter a name for the model registry.
Optional: In the Resource Name field, enter a specific resource name for the model registry. By default, the resource name will match the name of the model registry.
ImportantResource names are what your resources are labeled as in OpenShift. Your resource name 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.
- Optional: In the Description field, enter a description for the model registry.
In the Connect to external MySQL database section, enter the information for the external database where your model data is stored.
In the Host field, enter the database’s host name.
-
If the database is running in the
rhoai-model-registriesnamespace, enter only the hostname for the database. -
If the database is running in a different namespace from
rhoai-model-registries, enter the database hostname details in<host name>.<namespace>.svc.cluster.localformat.
-
If the database is running in the
- In the Port field, enter the port number for the database.
- In the Username field, enter the default user name that is connected to the database.
- In the Password field, enter the password for the default user account.
- In the Database field, enter the database name.
- Click Create.
To find the resource name or type of a model registry, click the help icon
beside the registry name. Resource names and types are used to find your resources in OpenShift.
Verification
- The new model registry appears on the Model Registry Settings page.
- You can view the database configuration for the model registry by clicking the action menu (⋮) beside it, and then clicking View database configuration.
- You can register a model with the model registry from the Model Registry tab. For more information about working with model registries, see Working with model registries.
