controller

README

parapet-ingress-controller

Parapet Ingress Controller use parapet framework to create Kubernetes ingress controller.

Deploy

See deploy config at deploy directory.

Usage

Create ingress with an annotation kubernetes.io/ingress.class: parapet

Example

apiVersion: extensions/v1beta1
kind: Ingress
metadata:
  annotations:
    kubernetes.io/ingress.class: parapet
    parapet.moonrhythm.io/hsts: preload
    parapet.moonrhythm.io/redirect: |
      example.com: https://www.example.com
    parapet.moonrhythm.io/redirect-https: "true"
  name: ingress
spec:
  rules:
  - host: www.example.com
    http:
      paths:
      - backend:
          serviceName: example
          servicePort: http
      - path: /assets/
        backend:
          serviceName: gcs
          servicePort: https
  - host: api.example.com
    http:
      paths:
      - backend:
          serviceName: api-example
          servicePort: http
  tls:
  - secretName: tls-www
  - secretName: tls-api

Plugins

Plugins use annotation in ingress to config.

See supported annotations in plugin directory.

Metrics

Parapet ingress controller support prometheus metrics by add prometheus annotations to pod template.

annotations:
  prometheus.io/port: "9187"
  prometheus.io/scrape: "true"

Supported Metrics

Ingress Metrics

• parapet_requests{host, status, method, ingress_name, ingress_namespace, service_type, service_name}
• parapet_backend_connections{backend, service_namespace, service_type, service_name, ingress}
• parapet_backend_network_read_bytes{backend, service_namespace, service_type, service_name, ingress}
• parapet_backend_network_write_bytes{backend, service_namespace, service_type, service_name, ingress}

Metrics directly use from parapet

• parapet_connections{state}
• parapet_network_request_bytes{}
• parapet_network_response_bytes{}

License

MIT

Documentation

Index

• Constants
• type Controller
  • func New(watchNamespace string) *Controller
  • func (ctrl *Controller) GetCertificate(clientHello *tls.ClientHelloInfo) (*tls.Certificate, error)
  • func (ctrl *Controller) Healthz() parapet.Middleware
  • func (ctrl *Controller) Reload()
  • func (ctrl *Controller) ServeHandler(_ http.Handler) http.Handler
  • func (ctrl *Controller) Use(m plugin.Plugin)
  • func (ctrl *Controller) Watch()

Constants

const IngressClass = "parapet"

IngressClass to load ingresses

Types

type Controller

type Controller struct {
	// contains filtered or unexported fields
}

Controller is the parapet ingress controller

func New

func New(watchNamespace string) *Controller

New creates new ingress controller

func (*Controller) GetCertificate

func (ctrl *Controller) GetCertificate(clientHello *tls.ClientHelloInfo) (*tls.Certificate, error)

GetCertificate returns certificate for given client hello information

func (*Controller) Healthz

func (ctrl *Controller) Healthz() parapet.Middleware

Healthz returns health check middleware

func (*Controller) Reload

func (ctrl *Controller) Reload()

Reload reloads ingresses

func (*Controller) ServeHandler

func (ctrl *Controller) ServeHandler(_ http.Handler) http.Handler

ServeHandler implements parapet.Middleware

func (*Controller) Use

func (ctrl *Controller) Use(m plugin.Plugin)

Use appends a plugin

func (*Controller) Watch

func (ctrl *Controller) Watch()

Watch starts watch k8s resource