Repository files navigation

This repository contains the Knative Ingress and Certificate CRDs, as well astheir conformance tests. These are our extension points to plugin differentIngress plugins (Ambassador, Contour, Gloo, Istio, Kong and Kourier), as well asdifferent ExternalDomainTLS plugins (CertManager and Knative's own HTTP01 challengesolver).

The Knative Ingress CRD is based on the Kubernetes Ingress CRD, with thefollowing additions:

1. Traffic splitting
2. Header modification applied to requests based on the traffic split they areassigned to.
3. Host header rewrite
4. Traffic redirection predicates based on a regexp based condition on headers.

In addition to these, we previously added Timeout and Retry settings but nolonger used them and may deprecate these parts in future versions.

Seehttps://knative.dev/docs/install/yaml-install/serving/install-serving-with-yaml/#install-a-networking-layerfor a list of the current supported KIngress implementations.

Check out:

• pkg/apis/networking/v1alpha1/ingress_types.gofor more information about the KIngress API spec.
• pkg/apis/networking/v1alpha1/ingress_validation.gofor more information about the validation logic for KIngress API spec.
• test/conformance/ingress/README.md forthe conformance tests and how to run them.

See also:

• http://github.com/knative-extensions/net-contour for the Contour-basedimplementation of KIngress.
• http://github.com/knative-extensions/net-kourier for a dependency-freeimplementation of KIngress based on Envoy proxy.
• http://github.com/knative-extensions/net-istio For the Istio-based implementationof KIngress.

Knative Certificate CRD is a Knative abstraction for various SSL certificateprovisioning solutions (such as cert-manager or self-signed SSL certificate).

Check out:

• pkg/apis/networking/v1alpha1/certificate_types.gofor more information about the Certificate API spec.
• pkg/apis/networking/v1alpha1/certificate_validation.gofor more information about the validation logic for Certificate API spec.

If you would like to contribute to Knative, take a look atCLOTRIBUTORfor a list of help wanted issues across the project.