Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 2. Configuring the model registry component

To configure the model registry feature for your data scientists to use in OpenShift AI, you must install the following Operators in OpenShift, and then enable the modelregistry component in OpenShift AI.

  • Red Hat Authorino Operator (Technical Preview)
  • Red Hat OpenShift Serverless Operator
  • Red Hat OpenShift Service Mesh Operator
  • Red Hat OpenShift AI Operator version 2.14+
Important

You should install the Red Hat OpenShift AI Operator only after the other listed Operators are installed and in a running state.

For more information about installing Operators in OpenShift, see Adding Operators to a cluster.

For more information about installing the Red Hat OpenShift AI Operator, see Installing the Red Hat OpenShift AI Operator.

After you install the Operators, you can use the following steps to enable the modelregistry component.

Prerequisites

  • You have cluster administrator privileges for your OpenShift cluster.
  • You have access to the data science cluster.
  • You have installed the Red Hat OpenShift AI Operator on your OpenShift cluster.
  • You have installed the Red Hat Authorino, Red Hat OpenShift Serverless, Red Hat OpenShift Service Mesh, and Red Hat OpenShift AI Operators.
  • You have sufficient resources. For more information about the minimum resources required to use OpenShift AI, see Installing and deploying OpenShift AI (for disconnected environments, see Deploying OpenShift AI in a disconnected environment).

Procedure

  1. In the OpenShift console, click Operators Installed Operators.
  2. Search for the Red Hat OpenShift AI Operator version 2.14+, and then click the Operator name to open the Operator details page.
  3. Click the Data Science Cluster tab.
  4. Click the default instance name (for example, default-dsc) to open the instance details page.
  5. Click the YAML tab to show the instance specifications.

  6. Find the spec.components section, and then add or update it to include the following modelregistry component entry, with the managementState field set to Managed, and the registriesNamespace field set to rhoai-model-registries:

    Copy to Clipboard Toggle word wrap 
     modelregistry:
    managementState: Managed
    registriesNamespace: rhoai-model-registries
  7. Click Save.

Verification

  • Confirm that the model registry namespace was created successfully:

    1. In the OpenShift console, click Home Projects.
    2. Confirm that the rhoai-model-registries namespace appears in the Projects drop-down list.

  • Check the status of the model-registry-operator-controller-manager pod:

    1. In the OpenShift console, from the Project list, select redhat-ods-applications.
    2. Click Workloads Deployments.
    3. Search for the model-registry-operator-controller-manager deployment.

    4. Check the status:

      1. Click the deployment name to open the deployment details page.
      2. Click the Pods tab.

      3. View the pod status.

        When the status of the model-registry-operator-controller-manager-<pod-id> pod is Running, the pod is ready to use.

Next step

OpenShift AI administrators can create, delete, and manage permissions for model registries. For more information, see Managing model registries.

Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat, Inc.