Questo contenuto non è disponibile nella lingua selezionata.

Chapter 1. Installing OpenShift Lightspeed


Enable OpenShift Lightspeed in your cluster by installing the OpenShift Lightspeed Operator and configuring the Service to interact with a large language model (LLM) provider.

1.1. Large language model (LLM) overview

Learn how the OpenShift Lightspeed Service uses large language models (LLMs) to generate intelligent, context-aware answers to your questions about OpenShift Container Platform.

You can configure Red Hat Enterprise Linux AI or Red Hat OpenShift AI as the LLM provider for the OpenShift Lightspeed Service. Either LLM provider can use a server or inference service that processes inference queries.

Alternatively, you can connect the OpenShift Lightspeed Service to a publicly available LLM provider, such as IBM watsonx, OpenAI, or Microsoft Azure OpenAI.

Note

Installing the OpenShift Lightspeed Operator does not install an LLM provider. You must have an LLM provider available for use before you install the OpenShift Lightspeed Operator.

1.1.1. Red Hat Enterprise Linux AI with OpenShift Lightspeed

You can use Red Hat Enterprise Linux AI to host an LLM.

For more information, see Generating a custom LLM by using RHEL AI.

1.1.2. Red Hat OpenShift AI with OpenShift Lightspeed

You can use Red Hat OpenShift AI to host an LLM.

For more information, see About model serving.

1.1.3. IBM watsonx with OpenShift Lightspeed

To configure IBM watsonx as the LLM provider, you need an IBM Cloud project with access to IBM watsonx. You also need your IBM watsonx API key.

For more information, see the official IBM watsonx product documentation.

1.1.4. OpenAI with OpenShift Lightspeed

To configure OpenAI as the LLM provider with OpenShift Lightspeed, you need either the OpenAI API key or the OpenAI project name during the configuration process.

The OpenAI Service has a feature for projects and service accounts. You can use a service account in a dedicated project so that you can precisely track OpenShift Lightspeed usage.

For more information, see the official OpenAI product documentation.

1.1.5. Microsoft Azure OpenAI with OpenShift Lightspeed

To configure Microsoft Azure OpenAI as the LLM provider, you need a Microsoft Azure OpenAI Service instance. You must have at least one model deployment in Microsoft Azure OpenAI Studio for that instance.

For more information, see the official Microsoft Azure OpenAI product documentation.

1.2. Supported product subscriptions

Review the supported OpenShift Container Platform product subscriptions and account requirements necessary to activate and use the OpenShift Lightspeed Service in your environment.

Red Hat OpenShift Lightspeed requires a valid and active subscription to one of the listed products.

  • Red Hat OpenShift Kubernetes Engine
  • Red Hat OpenShift Virtualization Engine
  • OpenShift Container Platform
  • Red Hat OpenShift Platform Plus

1.3. How Operators are installed on a cluster

Use the software catalog or OperatorHub to install Operators on your OpenShift Container Platform cluster. These tools use the Operator Lifecycle Manager (OLM) to manage your software.

1.3.1. Installing the OpenShift Lightspeed Operator from the OperatorHub

Install the OpenShift Lightspeed Operator so that you can configure the OpenShift Lightspeed Service.

Prerequisites

  • You have deployed OpenShift Container Platform 4.16 and later.
  • You have logged in to the OpenShift Container Platform web console as a user with the cluster-admin role.
  • You have successfully configured your large language model (LLM) provider so that OpenShift Lightspeed can communicate with it.

Procedure

  1. In the OpenShift Container Platform web console, navigate to the Operators OperatorHub page.
  2. Search for OpenShift Lightspeed.
  3. Locate the OpenShift Lightspeed Operator, and click to select it.
  4. When the prompt that discusses the community operator displays, click Continue.
  5. Click Install.
  6. Use the default installation settings presented, and click Install to continue.
  7. Click Operators Installed Operators to verify the OpenShift Lightspeed Operator installation. Succeeded displays in the Status column.

1.3.2. Installing the OpenShift Lightspeed Operator from the software catalog

Install the OpenShift Lightspeed Operator so that you can configure the OpenShift Lightspeed Service.

Prerequisites

  • You have deployed OpenShift Container Platform 4.20 or later.
  • You have logged in to the OpenShift Container Platform web console as a user with the cluster-admin role.
  • You have successfully configured your large language model (LLM) provider so that OpenShift Lightspeed can communicate with it.

Procedure

  1. In the OpenShift Container Platform web console, navigate to the Ecosystem Software Catalog page.
  2. Click the Project drop-down list, and enable the toggle switch to show default projects.
  3. Enter openshift-marketplace in the search field.
  4. Click to select openshift-marketplace.
  5. Search for OpenShift Lightspeed.
  6. Locate the OpenShift Lightspeed Operator, and click to select it.
  7. When the prompt that discusses the OpenShift Lightspeed Operator displays, click Install.
  8. Use the default installation settings presented, and click Install to continue.
  9. Click Ecosystem Installed Operators to verify the OpenShift Lightspeed Operator installation. Succeeded displays in the Status column.

1.3.3. Installing the OpenShift Lightspeed Operator by using the CLI

As an alternative to the web console, you can install the OpenShift Lightspeed Operator from the command line. The OpenShift Lightspeed Operator v2.0 bundles both the OpenShift Lightspeed intelligent assistant and OpenShift Lightspeed autonomous agents into a single Operator installation.

Prerequisites

  • You have deployed OpenShift Container Platform 4.16 and later with cluster-admin access. OpenShift Lightspeed autonomous agents require OpenShift Container Platform 5.0 and later.
  • You have installed the OpenShift CLI (oc) and logged in to the cluster.

Procedure

  1. Create the Namespace, OperatorGroup, and Subscription resources by running the following command:

    $ oc apply -f - <<'EOF'
    apiVersion: v1
    kind: Namespace
    metadata:
      name: openshift-lightspeed
    ---
    apiVersion: operators.coreos.com/v1
    kind: OperatorGroup
    metadata:
      name: openshift-lightspeed
      namespace: openshift-lightspeed
    spec:
      targetNamespaces:
        - openshift-lightspeed
      upgradeStrategy: Default
    ---
    apiVersion: operators.coreos.com/v1alpha1
    kind: Subscription
    metadata:
      name: lightspeed-operator
      namespace: openshift-lightspeed
    spec:
      channel: stable
      name: lightspeed-operator
      source: redhat-operators
      sourceNamespace: openshift-marketplace
      installPlanApproval: Automatic
    EOF
  2. Wait for the cluster service version (CSV) to succeed by running the following command:

    $ oc wait --for=jsonpath='{.status.phase}'=Succeeded csv -n openshift-lightspeed \
      -l operators.coreos.com/lightspeed-operator.openshift-lightspeed \
      --timeout=300s

Verification

  • Verify that both controllers are running by running the following command:

    $ oc get deploy -n openshift-lightspeed

    Example output

    lightspeed-operator-controller-manager         1/1
    lightspeed-agentic-operator-controller-manager 1/1

Important

Enabling OpenShift Lightspeed autonomous agents, including the agent RBAC and the agentic Operator, is supported only on OpenShift Container Platform 5.0. For more information, see Configuring and deploying OpenShift Lightspeed.

1.4. Verifying the OpenShift Lightspeed installation

After you install the OpenShift Lightspeed Operator and configure the Service, verify that all of the expected workloads are deployed and that the custom resources (CRs) are in place.

Prerequisites

  • You have installed the OpenShift Lightspeed Operator.
  • You have configured the OpenShift Lightspeed intelligent assistant, autonomous agents, or both.
  • You have installed the OpenShift CLI (oc) and logged in to the cluster.

Procedure

  1. Verify that all of the expected deployments are ready by running the following command:

    $ oc get deploy -n openshift-lightspeed

    Depending on your configuration, the following deployments are expected to be ready:

    • lightspeed-operator-controller-manager
    • lightspeed-agentic-operator-controller-manager
    • lightspeed-app-server
    • lightspeed-agentic-console-plugin
    • lightspeed-console-plugin
    • lightspeed-otel-collector
    • lightspeed-postgres-server
    • lightspeed-rhokp
    • openshift-mcp-server
    Note

    The OpenShift Lightspeed autonomous agents deployments, such as lightspeed-agentic-operator-controller-manager and lightspeed-agentic-console-plugin, are present only when you configure OpenShift Lightspeed autonomous agents on OpenShift Container Platform 5.0.

  2. Verify that the custom resources are in place by running the following commands:

    $ oc get olsconfig cluster

    If you configured OpenShift Lightspeed autonomous agents, also confirm the agentic custom resources by running the following commands:

    $ oc get llmprovider -n openshift-lightspeed
    $ oc get agent -n openshift-lightspeed
Red Hat logoGithubRedditYoutubeTwitter

Formazione

Prova, acquista e vendi

Community

Informazioni su Red Hat

Forniamo soluzioni consolidate che rendono più semplice per le aziende lavorare su piattaforme e ambienti diversi, dal datacenter centrale all'edge della rete.

Rendiamo l’open source più inclusivo

Red Hat si impegna a sostituire il linguaggio problematico nel codice, nella documentazione e nelle proprietà web. Per maggiori dettagli, visita il Blog di Red Hat.

Informazioni sulla documentazione di Red Hat

Legal Notice

Theme

© 2026 Red Hat
Torna in cima