diff --git a/README.md b/README.md index 2a530822a9..df4c9f3d85 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,16 @@ This repo contains all required resources to collect data from Kubernetes cluste # Installation -Detailed instructions are available in our [Installation Guide](./deploy/README.md). +Detailed instructions are available in our Installation Guides below. + +Sumo Logic Helm Chart Version +|:-------- +[0.14.0](https://github.com/SumoLogic/sumologic-kubernetes-collection/blob/v0.14.0/deploy/README.md) +[0.13.0](https://github.com/SumoLogic/sumologic-kubernetes-collection/blob/v0.13.0/deploy/README.md) +[0.12.0](https://github.com/SumoLogic/sumologic-kubernetes-collection/blob/v0.12.0/deploy/README.md) +[0.11.0](https://github.com/SumoLogic/sumologic-kubernetes-collection/blob/v0.11.0/deploy/README.md) +[0.10.0](https://github.com/SumoLogic/sumologic-kubernetes-collection/blob/v0.10.0/deploy/README.md) +[0.9.0](https://github.com/SumoLogic/sumologic-kubernetes-collection/blob/v0.9.0/deploy/README.md) # License diff --git a/deploy/README.md b/deploy/README.md index d982ccbef4..750a161f0c 100644 --- a/deploy/README.md +++ b/deploy/README.md @@ -60,7 +60,8 @@ The following matrix displays the tested package versions for our Helm chart. Sumo Logic Helm Chart | Prometheus Operator | Fluent Bit | Falco | Metrics Server |:-------- |:-------- |:-------- |:-------- |:-------- -0.13.0 - Latest | 8.2.0 | 2.8.1 | 1.0.11 | 2.7.0 +0.14.0 - Latest | 8.2.0 | 2.8.1 | 1.1.1 | 2.7.0 +0.13.0 | 8.2.0 | 2.8.1 | 1.0.11 | 2.7.0 0.12.0 | 8.2.0 | 2.8.1 | 1.0.9 | - 0.9.0 - 0.11.0 | 6.2.1 | 2.4.4 | 1.0.8 | - 0.6.0 - 0.8.0 | 6.2.1 | 2.4.4 | 1.0.5 | - diff --git a/deploy/docs/Helm3.md b/deploy/docs/Helm3.md index c7ca93a780..e13e4a9966 100644 --- a/deploy/docs/Helm3.md +++ b/deploy/docs/Helm3.md @@ -42,7 +42,7 @@ manifest_sorter.go:175: info: skipping unknown hook: "crd-install" NOTE: If you need to install the chart with a different release name or namespace you will need to override some configuration fields for both Prometheus and fluent-bit. We recommend using an override file due to the number of fields that need to be overridden. In the following command, replace the `` and `` variables with your values and then run it to download the override file with your replaced values: ```bash -curl https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.13.0/deploy/helm/sumologic/values.yaml | \ +curl https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.14.0/deploy/helm/sumologic/values.yaml | \ sed 's/\-sumologic.sumologic'"/-sumologic./g" | \ sed 's/\- sumologic'"/- /g" | \ sed 's/\collection'"//g" > values.yaml @@ -50,7 +50,7 @@ sed 's/\collection'"//g" > values.yaml For example, if your release name is `my-release` and namespace is `my-namespace`: ```bash -curl https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.13.0/deploy/helm/sumologic/values.yaml | \ +curl https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.14.0/deploy/helm/sumologic/values.yaml | \ sed 's/\-sumologic.sumologic'"/-sumologic.my-namespace/g" | \ sed 's/\collection'"/my-release/g" > values.yaml ``` diff --git a/deploy/docs/Installation_with_Helm.md b/deploy/docs/Installation_with_Helm.md index 1fa42f8c48..1d3a80f88d 100644 --- a/deploy/docs/Installation_with_Helm.md +++ b/deploy/docs/Installation_with_Helm.md @@ -66,13 +66,13 @@ ebpf: To customize your configuration, download the values.yaml file by running ```bash -curl https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.13.0/deploy/helm/sumologic/values.yaml +curl https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.14.0/deploy/helm/sumologic/values.yaml ``` NOTE: If you need to install the chart with a different release name or namespace you will need to override some configuration fields for both Prometheus and fluent-bit. We recommend using an override file due to the number of fields that need to be overridden. In the following command, replace the `` and `` variables with your values and then run it to download the override file with your replaced values: ```bash -curl https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.13.0/deploy/helm/sumologic/values.yaml | \ +curl https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.14.0/deploy/helm/sumologic/values.yaml | \ sed 's/\-sumologic.sumologic'"/-sumologic./g" | \ sed 's/\- sumologic'"/- /g" | \ sed 's/\collection'"//g" > values.yaml @@ -80,7 +80,7 @@ sed 's/\collection'"//g" > values.yaml For example, if your release name is `my-release` and namespace is `my-namespace`: ```bash -curl https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.13.0/deploy/helm/sumologic/values.yaml | \ +curl https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.14.0/deploy/helm/sumologic/values.yaml | \ sed 's/\-sumologic.sumologic'"/-sumologic.my-namespace/g" | \ sed 's/\collection'"/my-release/g" > values.yaml ``` diff --git a/deploy/docs/Non_Helm_Installation.md b/deploy/docs/Non_Helm_Installation.md index 70aa1c3bde..6304bfad9e 100644 --- a/deploy/docs/Non_Helm_Installation.md +++ b/deploy/docs/Non_Helm_Installation.md @@ -72,7 +72,7 @@ kubectl create namespace sumologic Run the following command to download and apply the YAML file containing all the Kubernetes resources. Replace the ``, ``, ``, `` and `` variables with your values. ```sh -curl -s https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.13.0/deploy/kubernetes/setup-sumologic.yaml.tmpl | \ +curl -s https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.14.0/deploy/kubernetes/setup-sumologic.yaml.tmpl | \ sed 's/\$NAMESPACE'"//g" | \ sed 's/\$SUMOLOGIC_ACCESSID'"//g" | \ sed 's/\$SUMOLOGIC_ACCESSKEY'"//g" | \ @@ -153,7 +153,7 @@ In this step you will deploy Fluentd using a Sumo-provided .yaml manifest. If you don't need to customize the configuration apply the `fluentd-sumologic.yaml` manifest with the following command: ```sh -curl https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.13.0/deploy/kubernetes/fluentd-sumologic.yaml.tmpl | \ +curl https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.14.0/deploy/kubernetes/fluentd-sumologic.yaml.tmpl | \ sed 's/\$NAMESPACE'"/sumologic/g" | \ kubectl -n sumologic apply -f - ``` @@ -163,7 +163,7 @@ kubectl -n sumologic apply -f - If you need to customize the configuration there are two commands to run. First, get the `fluentd-sumologic.yaml` manifest with following command: ```sh -curl https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.13.0/deploy/kubernetes/fluentd-sumologic.yaml.tmpl | \ +curl https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.14.0/deploy/kubernetes/fluentd-sumologic.yaml.tmpl | \ sed 's/\$NAMESPACE'"/sumologic/g" >> fluentd-sumologic.yaml ``` @@ -191,7 +191,7 @@ In this step, you will configure the Prometheus server to write metrics to Fluen Download the Prometheus Operator `prometheus-overrides.yaml` by running ```bash -$ curl -LJO https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.13.0/deploy/helm/prometheus-overrides.yaml +$ curl -LJO https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.14.0/deploy/helm/prometheus-overrides.yaml ``` Before installing `prometheus-operator`, edit `prometheus-overrides.yaml` to define a unique cluster identifier. The default value of the `cluster` field in the `externalLabels` section of `prometheus-overrides.yaml` is `kubernetes`. If you will be deploying the metric collection solution on multiple Kubernetes clusters, you will want to use a unique identifier for each. For example, you might use “Dev”, “Prod”, and so on. @@ -247,7 +247,7 @@ In this step, you will deploy FluentBit to forward logs to Fluentd. Run the following commands to download the FluentBit `fluent-bit-overrides.yaml` file and install `fluent-bit` ```bash -$ curl -LJO https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.13.0/deploy/helm/fluent-bit-overrides.yaml +$ curl -LJO https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.14.0/deploy/helm/fluent-bit-overrides.yaml $ helm fetch stable/fluent-bit --version 2.8.1 $ helm template fluent-bit-2.8.1.tgz --name fluent-bit --namespace=sumologic -f fluent-bit-overrides.yaml > fluent-bit.yaml $ kubectl apply -f fluent-bit.yaml @@ -262,7 +262,7 @@ In this step, you will deploy [Falco](https://falco.org/) to detect anomalous ac Download the file `falco-overrides.yaml` from GitHub: ```bash -$ curl -LJO https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.13.0/deploy/helm/falco-overrides.yaml +$ curl -LJO https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.14.0/deploy/helm/falco-overrides.yaml $ helm fetch stable/falco --version 1.0.9 $ helm template falco-1.0.9.tgz --name falco --namespace=sumologic -f falco-overrides.yaml > falco.yaml $ kubectl apply -f falco.yaml diff --git a/deploy/docs/existingPrometheusDoc.md b/deploy/docs/existingPrometheusDoc.md index 6f4df13c13..13a43062ec 100644 --- a/deploy/docs/existingPrometheusDoc.md +++ b/deploy/docs/existingPrometheusDoc.md @@ -13,7 +13,7 @@ Run the following to download the `values.yaml` file ```bash -curl -LJO https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.13.0/deploy/helm/sumologic/values.yaml +curl -LJO https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.14.0/deploy/helm/sumologic/values.yaml ``` Edit the `values.yaml` file to `prometheus-operator.enabled = false`, and run @@ -27,7 +27,7 @@ helm install sumologic/sumologic --name collection --namespace sumologic -f valu If you have not already customized your [remote write configuration](https://prometheus.io/docs/prometheus/latest/configuration/configuration/#remote_write), run the following to update the [remote write configuration](https://prometheus.io/docs/prometheus/latest/configuration/configuration/#remote_write) of the prometheus operator by installing with the prometheus overrides file we provide below. ```bash -curl -LJO https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.13.0/deploy/helm/prometheus-overrides.yaml +curl -LJO https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/v0.14.0/deploy/helm/prometheus-overrides.yaml ``` Then run diff --git a/deploy/helm/sumologic/Chart.yaml b/deploy/helm/sumologic/Chart.yaml index 4ca5359ea6..f354ba3d3b 100644 --- a/deploy/helm/sumologic/Chart.yaml +++ b/deploy/helm/sumologic/Chart.yaml @@ -1,7 +1,7 @@ apiVersion: v1 name: sumologic -version: 0.13.0 -appVersion: 0.13.0 +version: 0.14.0 +appVersion: 0.14.0 description: A Helm chart for collecting Kubernetes logs, metrics and events into Sumo Logic. keywords: - monitoring diff --git a/deploy/helm/sumologic/values.yaml b/deploy/helm/sumologic/values.yaml index 5ee46763ec..0c37a50e43 100644 --- a/deploy/helm/sumologic/values.yaml +++ b/deploy/helm/sumologic/values.yaml @@ -1,6 +1,6 @@ image: repository: sumologic/kubernetes-fluentd - tag: 0.13.0 + tag: 0.14.0 pullPolicy: IfNotPresent nameOverride: "" diff --git a/deploy/kubernetes/fluentd-sumologic.yaml.tmpl b/deploy/kubernetes/fluentd-sumologic.yaml.tmpl index 7a3e3fadcb..c86815479b 100644 --- a/deploy/kubernetes/fluentd-sumologic.yaml.tmpl +++ b/deploy/kubernetes/fluentd-sumologic.yaml.tmpl @@ -506,7 +506,7 @@ spec: name: collection-sumologic containers: - name: fluentd - image: sumologic/kubernetes-fluentd:0.13.0 + image: sumologic/kubernetes-fluentd:0.14.0 imagePullPolicy: IfNotPresent resources: limits: @@ -665,7 +665,7 @@ spec: name: collection-sumologic-events containers: - name: fluentd-events - image: sumologic/kubernetes-fluentd:0.13.0 + image: sumologic/kubernetes-fluentd:0.14.0 imagePullPolicy: IfNotPresent resources: limits: diff --git a/deploy/kubernetes/setup-sumologic.yaml.tmpl b/deploy/kubernetes/setup-sumologic.yaml.tmpl index f50c82de26..da0ad2fd43 100644 --- a/deploy/kubernetes/setup-sumologic.yaml.tmpl +++ b/deploy/kubernetes/setup-sumologic.yaml.tmpl @@ -250,7 +250,7 @@ spec: defaultMode: 0777 containers: - name: setup - image: sumologic/kubernetes-fluentd:0.13.0 + image: sumologic/kubernetes-fluentd:0.14.0 imagePullPolicy: IfNotPresent command: ["/etc/terraform/setup.sh"] volumeMounts: