From a9fdea486169328685bb95eb3151252a739a3094 Mon Sep 17 00:00:00 2001 From: Kristof Gyuracz Date: Tue, 13 Feb 2024 10:01:42 +0100 Subject: [PATCH] docs: update readme with installation steps Signed-off-by: Kristof Gyuracz --- README.md | 48 +++++++++++++++++++++++++++++------------------- 1 file changed, 29 insertions(+), 19 deletions(-) diff --git a/README.md b/README.md index 107fafb0..76e8363e 100644 --- a/README.md +++ b/README.md @@ -10,7 +10,7 @@ Telemetry-controller can be configured using Custom Resources to set up an opini - kubectl version v1.11.3+. - Access to a Kubernetes v1.11.3+ cluster. -### To Deploy on the cluster +### Deployment steps for users **Install cert-manager, and opentelemtry-operator:** ```sh @@ -19,6 +19,16 @@ helm upgrade --install --repo https://charts.jetstack.io cert-manager cert-manag kubectl apply -f https://github.com/open-telemetry/opentelemetry-operator/releases/latest/download/opentelemetry-operator.yaml --wait ``` +**Deploy telemetry-controller:** +```sh +kubectl apply -k 'github.com/kube-logging/telemetry-controller/config/default' +``` +**Remove the controller and CRDs from the cluster:** +```sh +kubectl delete -k 'github.com/kube-logging/telemetry-controller/config/default' +``` + +### Deployment steps for contributors **Install the CRDs into the cluster:** ```sh @@ -40,6 +50,24 @@ make deploy IMG=telemetry-controller:tag > **NOTE**: If you encounter RBAC errors, you may need to grant yourself cluster-admin privileges or be logged in as admin. +**Delete the instances (CRs) from the cluster:** + +```sh +kubectl delete -f docs/examples/simple-demo/ +``` + +**Remove the controller from the cluster:** + +```sh +make undeploy +``` + +**Delete the APIs(CRDs) from the cluster:** + +```sh +make uninstall +``` +### Example setup **Create instances of your solution** You can deploy the example configuration provided as part of the docs. This will deploy a demo pipeline with one tenant, two subscriptions, and an OpenObserve instance. Deploying Openobserve is an optional, but recommended step, logs can be forwarded to any OTLP endpoint. Openobserve provides a UI to visualize the ingested logstream. @@ -72,24 +100,6 @@ helm install --wait --create-namespace --namespace example-tenant-ns --generate- **Open the Openobserve UI and inspect the generated log messages** ![Openobserve logs](docs/assets/openobserve-logs.png) -### To Uninstall -**Delete the instances (CRs) from the cluster:** - -```sh -kubectl delete -f docs/examples/simple-demo/ -``` - -**UnDeploy the controller from the cluster:** - -```sh -make undeploy -``` - -**Delete the APIs(CRDs) from the cluster:** - -```sh -make uninstall -``` ## Contributing