deprecated-helm-charts/incubator/fluentd-cloudwatch

Fluentd CloudWatch

• Installs Fluentd Cloudwatch log forwarder.

TL;DR;

$ helm install incubator/fluentd-cloudwatch

Introduction

This chart bootstraps a Fluentd Cloudwatch deployment on a Kubernetes cluster using the Helm package manager.

Prerequisites

• Kubernetes 1.4+ with Beta APIs enabled
• kube2iam installed to used the awsRole config option

Installing the Chart

To install the chart with the release name my-release:

$ # edit secrets/aws_access_key_id and secrets/aws_access_key_id with the key/password of a AWS user with a policy to access  Cloudwatch
$ helm install --name my-release incubator/fluentd-cloudwatch
$ # or add a role to aws with the correct policy to add to cloud watch
$ helm install --name my-release incubator/fluentd-cloudwatch --set awsRole=roll_name_here

The command deploys Fluentd Cloudwatch on the Kubernetes cluster in the default configuration. The configuration section lists the parameters that can be configured during installation.

Uninstalling the Chart

To uninstall/delete the my-release deployment:

$ helm delete my-release

The command removes all the Kubernetes components associated with the chart and deletes the release.

Configuration

The following table lists the configurable parameters of the Fluentd Cloudwatch chart and their default values.

Parameter	Description	Default
image.repository	Image repository	fluent/fluentd-kubernetes-daemonset
image.tag	Image tag	v0.12.43-cloudwatch
image.pullPolicy	Image pull policy	IfNotPresent
resources.limits.cpu	CPU limit	100m
resources.limits.memory	Memory limit	200Mi
resources.requests.cpu	CPU request	100m
resources.requests.memory	Memory request	200Mi
hostNetwork	Host network	false
annotations (removed for now)	Annotations	nil
awsRegion	AWS Cloudwatch region	us-east-1
awsRole	AWS IAM Role To Use	nil
fluentdConfig	Fluentd configuration	example configuration
logGroupName	AWS Cloudwatch log group	kubernetes
rbac.create	If true, create & use RBAC resources	false
rbac.serviceAccountName	existing ServiceAccount to use (ignored if rbac.create=true)	default
tolerations	Add tolerations	[]
extraVars	Add pod environment variables (must be specified as a single line object)	[]

Starting with fluentd-kubernetes-daemonset v0.12.43-cloudwatch, the container runs as user fluentd. To be able to write pos files to the host system, you'll need to run fluentd as root. Add the following extraVars value to run as root.

"{ name: FLUENT_UID, value: '0' }"

Specify each parameter using the --set key=value[,key=value] argument to helm install. For example,

$ helm install --name my-release \
  --set awsRegion=us-east-1 \
    incubator/fluentd-cloudwatch

Alternatively, a YAML file that specifies the values for the above parameters can be provided while installing the chart. For example,

$ helm install --name my-release -f values.yaml incubator/fluentd-cloudwatch