zymlabs/kubernetes-endpoint-proxy repository overview

⁠Kubernetes Endpoint Proxy

An HAProxy for load balancing Kubernetes endpoints. Particularly useful for running Kubernetes on Mesos/Mesosphere DCOS. This is because in a Kubernetes cluster the endpoint ports and IP addresses may change for a service.

This proxy will monitor the endpoint for changes in etcd and update HAProxy with the new endpoints.

⁠Getting Started

Given the following service in Kubernetes, we will run the proxy container with the options below.

⁠Environment Variables

• ETCD_SCHEME - etcd connection scheme (http)
• ETCD_HOST - etcd host (leader.mesos)
• ETCD_PORT - etcd port (4001)
• KUBERNETES_ENDPOINT - Kubernetes endpoint id or service id
• HAPROXY_HEALTH_CHECK_PATH - Optional path for checking if an endpoint upstream is available.

⁠Kubernetes Service pandora-nginx

{
    "id": "pandora-nginx",
    "kind": "Service",
    "apiVersion": "v1beta1",
    "port": 80,
    "containerPort": 80,
    "selector": {
        "name": "pandora-nginx"
    },
    "labels": { "name": "pandora-nginx" }
}

⁠Docker Example

docker run -e "ETCD_HOST=leader.mesos" \
           -e "ETCD_PORT=4001" \
           -e "KUBERNETES_ENDPOINT=pandora-nginx" \
           -e "HAPROXY_HEALTH_CHECK_PATH=/robots.txt" \
           -p 80:80 \
           zymlabs/kubernetes-endpoint-proxy

Requests should then be routed through the proxy to the endpoint.