feat: support onboarding-id for kubernetes (#8692) (#8763)

(cherry picked from commit ce53f33)

Co-authored-by: Panos Koutsovasilis <[email protected]>

Author: mergify[bot]

deploy/helm/elastic-agent/README.md

@@ -63,6 +63,7 @@ The chart built-in [kubernetes integration](https://docs.elastic.co/integrations
 | Key | Type | Default | Description |
 |-----|------|---------|-------------|
 | kubernetes.enabled | bool | `true` | enable Kubernetes integration. |
+| kubernetes.onboardingID | string | `""` | Specify the onboarding ID for a quick start flow. |
 | kubernetes.output | string | `"default"` | name of the output used in kubernetes integration. Note that this output needs to be defined in [outputs](#1-outputs) |
 | kubernetes.namespace | string | `"default"` | kubernetes namespace |
 | kubernetes.hints.enabled | bool | `false` | enable [elastic-agent autodiscovery](https://www.elastic.co/guide/en/fleet/current/elastic-agent-kubernetes-autodiscovery.html) feature |

deploy/helm/elastic-agent/examples/kubernetes-onboarding/README.md

@@ -0,0 +1,57 @@
+# Example: Kubernetes Integration with default chart values and onboarding-id
+
+In this example we install the built-in `kubernetes` integration with the default built-in values and an onboarding-id for quick-start flows .
+
+## Prerequisites:
+1. Build the dependencies of the Helm chart
+    ```console
+    helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
+    helm dependency build ../../
+    ```
+2. A k8s secret that contains the connection details to an Elasticsearch cluster such as the URL and the API key ([Kibana - Creating API Keys](https://www.elastic.co/guide/en/kibana/current/api-keys.html)):
+    ```console
+    kubectl create secret generic es-api-secret \
+       --from-literal=api_key=... \
+       --from-literal=url=...
+    ```
+
+3. `kubernetes` integration assets installed through Kibana ([Kibana - Install and uninstall Elastic Agent integration assets](https://www.elastic.co/guide/en/fleet/current/install-uninstall-integration-assets.html))
+
+## Run:
+
+#### Public image registry:
+```console
+helm install elastic-agent ../../ \
+     --set kubernetes.onboardingID: "my-onboarding-id"
+     --set kubernetes.enabled: true \
+     --set agent.unprivileged: true \
+     --set outputs.default.type=ESSecretAuthAPI \
+     --set outputs.default.secretName=es-api-secret
+```
+
+
+#### Private image registry:
+Create secret with the contents of docker auth config
+```
+kubectl create secret generic regcred --from-file=.dockerconfigjson=<your home folder here>/.docker/config.json --type=kubernetes.io/dockerconfigjson
+```
+
+Install elastic-agent
+```console
+helm install elastic-agent ../../ \
+     --set kubernetes.onboardingID: "my-onboarding-id"
+     --set kubernetes.enabled: true \
+     --set agent.unprivileged: true \
+     --set 'agent.imagePullSecrets[0].name=regcred' \
+     --set outputs.default.type=ESSecretAuthAPI \
+     --set outputs.default.secretName=es-api-secret
+```
+
+## Validate:
+
+1. `kube-state metrics` is installed with this command `kubectl get deployments -n kube-system kube-state-metrics`.
+2. The Kibana `kubernetes`-related dashboards should start showing up the respective info.
+
+## Note:
+
+1. If you want to disable kube-state-metrics installation with the elastic-agent Helm chart, you can set `kube-state-metrics.enabled=false` in the Helm chart. The helm chart will use the value of `kubernetes.state.host` to configure the elastic-agent input.

deploy/helm/elastic-agent/examples/kubernetes-onboarding/agent-kubernetes-values.yaml

@@ -0,0 +1,6 @@
+kubernetes:
+  onboardingID: "my-onboarding-id"
+  enabled: true
+
+agent:
+  unprivileged: true