From c58f8b4d8661e64d4c08c8c22d96c50eb5c2bfc0 Mon Sep 17 00:00:00 2001 From: Alex Jones Date: Thu, 18 May 2023 10:58:06 +0100 Subject: [PATCH] chore: readme (#107) Signed-off-by: Alex Jones --- README.md | 68 ++++++++++++++++++++++++++++++++++++------------------- 1 file changed, 45 insertions(+), 23 deletions(-) diff --git a/README.md b/README.md index 3904547c..727b56dd 100644 --- a/README.md +++ b/README.md @@ -9,6 +9,7 @@ This Operator is designed to enable [K8sGPT](https://github.com/k8sgpt-ai/k8sgpt/) within a Kubernetes cluster. It will allow you to create a custom resource that defines the behaviour and scope of a managed K8sGPT workload. Analysis and outputs will also be configurable to enable integration into existing workflows. + ## Installation @@ -19,8 +20,6 @@ helm install release k8sgpt/k8sgpt-operator -n k8sgpt-operator-system --create-n ## Run the example - - 1. Install the operator from the [Installation](#installation) section. 2. Create secret: @@ -62,19 +61,52 @@ you will be able to see the Results objects of the analysis after some minutes ( { "apiVersion": "core.k8sgpt.ai/v1alpha1", "kind": "Result", - "metadata": { - "creationTimestamp": "2023-04-26T09:45:02Z", - "generation": 1, - "name": "placementoperatorsystemplacementoperatorcontrollermanagermetricsservice", - "namespace": "default", - "resourceVersion": "108371", - "uid": "f0edd4de-92b6-4de2-ac86-5bb2b2da9736" - }, "spec": { "details": "The error message means that the service in Kubernetes doesn't have any associated endpoints, which should have been labeled with \"control-plane=controller-manager\". \n\nTo solve this issue, you need to add the \"control-plane=controller-manager\" label to the endpoint that matches the service. Once the endpoint is labeled correctly, Kubernetes can associate it with the service, and the error should be resolved.", ``` -## LocalAI Example +## Other AI Backend Examples + +
+ +AzureOpenAI + +1. Install the operator from the [Installation](#installation) section. + +2. Create secret: +```sh +kubectl create secret generic k8sgpt-sample-secret --from-literal=azure-api-key=$AZURE_TOKEN -n k8sgpt- +operator-system +``` + +3. Apply the K8sGPT configuration object: +``` +kubectl apply -f - << EOF +apiVersion: core.k8sgpt.ai/v1alpha1 +kind: K8sGPT +metadata: + name: k8sgpt-sample + namespace: k8sgpt-operator-system +spec: + model: gpt-35-turbo + backend: azureopenai + baseUrl: https://k8sgpt.openai.azure.com/ + engine: llm + noCache: false + version: v0.3.2 + enableAI: true + secret: + name: k8sgpt-sample-secret + key: azure-api-key +EOF +``` + +
+ +
+ +LocalAI + 1. Install the operator from the [Installation](#installation) section. @@ -99,18 +131,8 @@ EOF 4. Same as step 4. in the example above. -## Architecture - - +
## Helm values -Here is an example of some of the values that can be configured. -For more details please see [here](chart/values.yaml) -| Parameter | Description | Default | -| --------- | ----------- | ------- | -| `serviceMonitor.enabled` | Enable Prometheus Operator ServiceMonitor | `false` | -| `controllerManager.manager.image.repository` | Image repository | `k8sgpt/k8sgpt-operator` | -| `controllerManager.manager.image.pullPolicy` | Image pull policy | `IfNotPresent` | -| `controllerManager.manager.imagePullSecrets` | Image pull secrets | `[]` | - +For details please see [here](chart/values.yaml)