apisix-ingress-controller

README

Apache APISIX for Kubernetes

Use Apache APISIX for Kubernetes Ingress.

All configurations in apisix-ingress-controller are defined with Kubernetes CRDs (Custom Resource Definitions). Support configuring plugins, service registration discovery mechanism for upstreams, load balancing and more in Apache APISIX.

apisix-ingress-controller is an Apache APISIX control plane component. Currently it serves for Kubernetes clusters. In the future, we plan to separate the submodule to adapt to more deployment modes, such as virtual machine clusters.

The technical architecture of apisix-ingress-controller:

Status

This project is currently general availability.

Features

• Declarative configuration for Apache APISIX with Custom Resource Definitions(CRDs), using k8s yaml struct with minimum learning curve.
• Hot-reload during yaml apply.
• Native Kubernetes Ingress (both v1 and v1beta1) support.
• Auto register k8s endpoint to upstream (Apache APISIX) node.
• Support load balancing based on pod (upstream nodes).
• Out of box support for node health check.
• Plug-in extension supports hot configuration and immediate effect.
• Support SSL and mTLS for routes.
• Support traffic split and canary deployments.
• Support TCP 4 layer proxy.
• Ingress controller itself as a pluggable hot-reload component.
• Multi-cluster configuration distribution.

More about comparison among multiple Ingress Controllers.

Internal Architecture

Prerequisites

Apisix ingress controller requires Kubernetes version 1.16+. Because we used CustomResourceDefinition v1 stable API. From the version 1.0.0, APISIX-ingress-controller need to work with Apache APISIX version 2.7+.

Apache APISIX Ingress vs. Kubernetes Ingress Nginx

• Hot-reload during yaml apply.
• More convenient canary deployment.
• Verify the correctness of the configuration, safe and reliable.
• Rich plugins and ecology.
• Supports APISIX custom resources and Kubernetes native Ingress resources.
• More active community

Contributor over time

Get started

• How to install

Todos

• Support UDP definition. #116
• Support GRPC definition. #114
• Add a complete demo. #9
• More todos will display in issues

Documents

• Get Started
• SDK doc
• Design introduction

FAQ

• FAQ

User stories

• aispeech: Why we create a new k8s ingress controller?(Chinese)
• Tencent Cloud: Why choose Apache APISIX to implement the k8s ingress controller?(Chinese)

Contributing

We welcome all kinds of contributions from the open-source community, individuals and partners.

• Contributing Guide

Community

• Mailing List: Mail to dev-subscribe@apisix.apache.org, follow the reply to subscribe the mailing list.
• QQ Group - 578997126
• - follow and interact with us using hashtag #ApacheAPISIX
• Bilibili video

Milestone

• Milestone

Terminology

• Ingress APISIX: the whole service that contains the proxy (Apache APISIX) and ingress controller (apisix ingress controller).
• apisix-ingress-controller: the ingress controller component.

License

Apache License 2.0

Documentation

Overview

Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.