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 Copia collegamentoCollegamento copiato negli appunti!
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.
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 Copia collegamentoCollegamento copiato negli appunti!
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 Copia collegamentoCollegamento copiato negli appunti!
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 Copia collegamentoCollegamento copiato negli appunti!
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 Copia collegamentoCollegamento copiato negli appunti!
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 Copia collegamentoCollegamento copiato negli appunti!
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 Copia collegamentoCollegamento copiato negli appunti!
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 Copia collegamentoCollegamento copiato negli appunti!
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 Copia collegamentoCollegamento copiato negli appunti!
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-adminrole. - You have successfully configured your large language model (LLM) provider so that OpenShift Lightspeed can communicate with it.
Procedure
-
In the OpenShift Container Platform web console, navigate to the Operators
OperatorHub page. - Search for OpenShift Lightspeed.
- Locate the OpenShift Lightspeed Operator, and click to select it.
- When the prompt that discusses the community operator displays, click Continue.
- Click Install.
- Use the default installation settings presented, and click Install to continue.
-
Click Operators
Installed Operators to verify the OpenShift Lightspeed Operator installation. Succeededdisplays in the Status column.
1.3.2. Installing the OpenShift Lightspeed Operator from the software catalog Copia collegamentoCollegamento copiato negli appunti!
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-adminrole. - You have successfully configured your large language model (LLM) provider so that OpenShift Lightspeed can communicate with it.
Procedure
-
In the OpenShift Container Platform web console, navigate to the Ecosystem
Software Catalog page. - Click the Project drop-down list, and enable the toggle switch to show default projects.
-
Enter
openshift-marketplacein the search field. -
Click to select
openshift-marketplace. - Search for OpenShift Lightspeed.
- Locate the OpenShift Lightspeed Operator, and click to select it.
- When the prompt that discusses the OpenShift Lightspeed Operator displays, click Install.
- Use the default installation settings presented, and click Install to continue.
-
Click Ecosystem
Installed Operators to verify the OpenShift Lightspeed Operator installation. Succeededdisplays in the Status column.
1.3.3. Installing the OpenShift Lightspeed Operator by using the CLI Copia collegamentoCollegamento copiato negli appunti!
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-adminaccess. 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
Create the
Namespace,OperatorGroup, andSubscriptionresources 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 EOFWait 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-lightspeedExample output
lightspeed-operator-controller-manager 1/1 lightspeed-agentic-operator-controller-manager 1/1
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 Copia collegamentoCollegamento copiato negli appunti!
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
Verify that all of the expected deployments are ready by running the following command:
$ oc get deploy -n openshift-lightspeedDepending 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
NoteThe OpenShift Lightspeed autonomous agents deployments, such as
lightspeed-agentic-operator-controller-managerandlightspeed-agentic-console-plugin, are present only when you configure OpenShift Lightspeed autonomous agents on OpenShift Container Platform 5.0.-
Verify that the custom resources are in place by running the following commands:
$ oc get olsconfig clusterIf 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