doit-eks-lens-helm-chart

Repository contains the helm chart templates to install the components required for EKS Lens.

Usage

Helm must be installed to use the charts. Please refer to Helm's documentation to get started.

Once Helm has been set up correctly, add the repo as follows:

helm repo add doit-eks-lens https://doitintl.github.io/doit-eks-lens-helm-chart/

If you had already added this repo earlier, run helm repo update to retrieve the latest versions of the packages. You can then run helm search repo doit-eks-lens to see the charts.

To generate templates:

helm template doit-eks-lens/doit-eks-lens

To install the doit-eks-lens chart with its own kube-state-metrics deployment:

helm upgrade -install doit-eks-lens doit-eks-lens/doit-eks-lens --set region=<EKS-CLUSTER-REGION> \
    --set metricsDeploymentId=<DEPLOYMENT-ID> \
    --set s3_bucket=<S3-BUCKET-NAME> \
    --set s3_prefix=<S3-BUCKET-PREFIX> \
    --set role_arn=<IAM-ROLE-ARN> \
    --namespace doit-eks-metrics \
    --create-namespace

Example:

helm upgrade -install doit-eks-lens doit-eks-lens/doit-eks-lens --set region=us-east-1 \
    --set metricsDeploymentId=2Dw7oXwSkgjwjsXGcSMr \
    --set s3_bucket=doitintl-eks-metrics-410386763839-us-east-1 \
    --set s3_prefix=eks-metrics/410386763839/us-east-1/my_cluster \
    --set role_arn=arn:aws:iam::410386763839:role/doit_eks_us-east-1_public \
    --namespace doit-eks-metrics \
    --create-namespace

To install the doit-eks-lens chart without kube-state-metrics deployment and use an existing kube-state-metrics in the cluster:

helm upgrade -install doit-eks-lens doit-eks-lens/doit-eks-lens --set region=<EKS-CLUSTER-REGION> \
    --set metricsDeploymentId=<DEPLOYMENT-ID> \
    --set s3_bucket=<S3-BUCKET-NAME> \
    --set s3_prefix=<S3-BUCKET-PREFIX> \
    --set role_arn=<IAM-ROLE-ARN> \
    --set kubeStateMetrics.install=false \
    --set collector.otelcol.kubeStateMetrics.endpoint=<KUBE-STATE-METRICS-SERVICE-NAME:PORT> \
    --namespace doit-eks-metrics \
    --create-namespace

Example:

helm upgrade -install doit-eks-lens doit-eks-lens/doit-eks-lens --set region=us-west-2 \
        --set metricsDeploymentId=2Dw7oXwSkgjwjsXGcSMr  \
        --set s3_bucket=doitintl-eks-metrics-317630533282-us-west-2   \
        --set s3_prefix=eks-metrics/317630533282/us-west-2/wonderful-sheepdog-1708421720  \
        --set role_arn=arn:aws:iam::317630533282:role/doit_eks_us-west-2_wonderful-sheepdog-1708421720 \
        --set kubeStateMetrics.install=false \
        --set collector.otelcol.kubeStateMetrics.endpoint="kube-state-metrics.kube-system:8080" \
        --namespace doit-eks-metrics \
        --create-namespace

Make sure you've added these arguments to your existing kube-state-metrics installation.

To install the doit-eks-lens chart in a self-managed EC2 based kubernetes cluster: Ensure the required kubernetes secrets (aws-access-key-id,aws-secret-access-key) are created before installing the helm chart.

helm upgrade -install doit-eks-lens doit-eks-lens/doit-eks-lens --set region=<EKS-CLUSTER-REGION> \
    --set metricsDeploymentId=<DEPLOYMENT-ID> \
    --set s3_bucket=<S3-BUCKET-NAME> \
    --set s3_prefix=<S3-BUCKET-PREFIX> \
    --set k8s_platform=ec2 \
    --namespace doit-eks-metrics \
    --create-namespace

Example:

helm upgrade -install doit-eks-lens . --set region=us-west-2 \
        --set metricsDeploymentId=2Dw7oXwSkgjwjsXGcSMr  \
        --set s3_bucket=doitintl-eks-metrics-317630533282-us-west-2   \
        --set s3_prefix=eks-metrics/317630533282/us-west-2/wonderful-sheepdog-1708421720  \
        --set k8s_platform=ec2 \
        --namespace doit-eks-metrics \
        --create-namespace

To uninstall the chart:

helm delete doit-eks-lens --namespace doit-eks-metrics