mziyabo / fargate-eks-sidecar-injector

EKS Fargate sidecar injection webhook

fargate-eks-sidecar-injector

Kubernetes mutating webhook for injecting sidecars into AWS Fargate pods.

Works by inspecting the fargate pod annotation eks.amazonaws.com/fargate-profile and injecting sidecars from a fargate-injector-sidecar-config ConfigMap.

Install

Helm install from repository:

helm repo add mziyabo https://mziyabo.github.io/helm-charts
helm install fargate-sidecar-injector mziyabo/fargate-sidecar-injector 

To build and run the webhook from source:

IMAGE_NAME="fargate-eks-sidecar-injector"
TAG="latest"

docker build . -t $IMAGE_NAME:$TAG

helm install helm/chart/fargate-sidecar-injector  \
    --values helm/chart/fargate-sidecar-injector/values.yaml \
    --generate-name \
    --set image.repository=${IMAGE_NAME} \
    --set image.tag=${TAG}

Uninstall uses the helm uninstall command, however you will have to run kubectl delete mutatingwebhookconfiguration fargate-sidecar-injector after since the MutatingWebhookConfiguration is installed as a helm post-install hook. Helm docs explain the limitation.

This webhook needs to run after 0500-amazon-eks-fargate-mutation.amazonaws.com therefore if you specify .Values.nameOverride make sure to use a name lexicographically greater than the amazon webhook.

Usage

After installing, To trigger sidecar injection, add a ConfigMap named fargate-injector-sidecar-config in the webhook namespace with the below format:

apiVersion: v1
kind: ConfigMap
metadata:
  name: fargate-injector-sidecar-config
data: 
  default: |-  # <- Fargate Profile
    spec:
      volumes:
      - name: log
        emptyDir: {}
      containers:
      - image: busybox
        name: side-man
        args:
        - /bin/sh
        - -c
        - >
          while true; do
            echo "$(date) INFO hello from main-container" >> /var/log/myapp.log ;
            sleep 1;
          done
        volumeMounts:
        - name: log
          mountPath: /var/log

Note the fargate-profile is used to configure which sidecars are injected. The spec for the containers under the fargate profile is exactly the same as podSpec.Containers - which is the same for Volumes.

Triggers on Pod CREATE and UPDATE operations.

Release Notes

WIP, Contributions Welcome

License

Apache License, Version 2.0

Known Issues