title: Getting started keywords:
import Tabs from ‘@theme/Tabs’; import TabItem from ‘@theme/TabItem’;
APISIX ingress controller is a Kubernetes ingress controller using Apache APISIX as the high performance reverse proxy.
APISIX ingress controller can be configured using native Kubernetes ingress resources as well as a declarative and easy to use custom resources provided by APISIX. The APISIX ingress controller converts these resources to APISIX configuration.
The examples below show how these differ. Both the examples configure a Route in APISIX that routes to an httpbin service as the Upstream.
<Tabs groupId=“resources” defaultValue=“apisix” values={[ {label: ‘APISIX Ingress custom resource’, value: ‘apisix’}, {label: ‘Kubernetes ingress resource’, value: ‘kubernetes’}, ]}>
apiVersion: apisix.apache.org/v2 kind: ApisixRoute metadata: name: httpbin-route spec: http: - name: route-1 match: hosts: - local.httpbin.org paths: - /* backends: - serviceName: httpbin servicePort: 80
apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: httpbin-route spec: ingressClassName: apisix rules: - host: local.httpbin.org http: paths: - backend: service: name: httpbin port: number: 80 path: / pathType: Prefix
APISIX ingress controller defines the CRDs ApisixRoute, ApisixUpstream, ApisixTls, and ApisixClusterConfig.
APISIX also supports service discovery through Kubernetes service abstraction.
See Design to learn more about how APISIX ingress controller works under the hood.
To summarize, APISIX ingress controller has the following features:
You can contribute to the development of APISIX ingress controller. See Development guide for instructions on setting up the project locally.
See the Contribute to APISIX section for details on the contributing flow.
The table below shows the compatibility between APISIX ingress controller and the APISIX proxy.
APISIX ingress controller | Supported APISIX versions | Recommended APISIX version |
---|---|---|
master | >= 2.15 | 2.15 |
1.5.0 | >= 2.7 | 2.15 |
1.4.0 | >= 2.7 | 2.11 |
1.3.0 | >= 2.7 | 2.10 |
1.2.0 | >= 2.7 | 2.8 |
1.1.0 | >= 2.7 | 2.7 |
1.1.0 | >= 2.7 | 2.7 |
1.0.0 | >= 2.7 | 2.7 |
0.6 | >= 2.6 | 2.6 |
0.5 | >= 2.4 | 2.5 |
0.4 | >= 2.4 |