Skip to content
This is an ingress controller that can be run on Azure Kubernetes Service (AKS) to allow an Azure Application Gateway to act as the ingress for an AKS cluster.
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Added a Feature request template. Sep 20, 2018
cmd/appgw-ingress chore: Split Validation into FatalValidateOnExistingConfig, PreBuildV… Jun 14, 2019
crds Adding AzureIngressManagedTarget, AzureIngressProhibitedTarget (#268) Jun 13, 2019
deploy Tag App Gateway with managed-by-k8s-ingress (#174) May 14, 2019
dockerfiles Use 'go mod vendor' in lieu of glide Apr 30, 2019
docs More LetsEncrypt.org documentation (#274) Jun 14, 2019
helm added option for namespaced annotation on AzureIdentity (#173) Jun 13, 2019
pkg chore: Split Validation into FatalValidateOnExistingConfig, PreBuildV… Jun 14, 2019
proposals chore: Rename ...Location to ...Target (#272) Jun 13, 2019
scripts dev: Adding a runner script to scripts/start.sh; Update documentation ( Jun 13, 2019
tests/data Adding dummy key and cert for TLS tests. Apr 2, 2019
vendor Carve out annotation parsing and add errors package, carved out backe… May 30, 2019
.env.example dev: Adding a runner script to scripts/start.sh; Update documentation ( Jun 13, 2019
.gitattributes Removed *.md files from `.gitattributes` so that GIT behaves properly… Oct 31, 2018
.gitignore dev: Adding a runner script to scripts/start.sh; Update documentation ( Jun 13, 2019
.travis.yml Fixed deploy stage for travis-CI. (#64) Oct 31, 2018
CMakeLists.txt cmake: Combine Go test targets; Test all packages May 3, 2019
LICENSE Initial commit Aug 29, 2018
README.md Adding Go Report Card badge (#189) May 17, 2019
_config.yml Changing the markdown rendrer used for Github pages Mar 15, 2019
azure-pipelines.yml Adding build pipeline for Azure DevOps (#157) May 16, 2019
go.mod Carve out annotation parsing and add errors package, carved out backe… May 30, 2019
go.sum Carve out annotation parsing and add errors package, carved out backe… May 30, 2019

README.md

Ingress Controller - Status Build Status Go Report Card

The Application Gateway Ingress Controller allows the Azure Application Gateway to be used as the ingress for an Azure Kubernetes Service aka AKS cluster. As shown in the figure below, the ingress controller runs as a pod within the AKS cluster. It consumes Kubernetes Ingress Resources and converts them to an Azure Application Gateway configuration which allows the gateway to load-balance traffic to Kubernetes pods.

Azure Application Gateway + AKS

Setup

  • Greenfield Deployment: If you are starting from scratch, refer to these installation instructions which outlines steps to deploy an AKS cluster with Application Gateway and install application gateway ingress controller on the AKS cluster.
  • Brownfield Deployment: If you have an existing AKS cluster and Application Gateway, refer to these installation instructions to install application gateway ingress controller on the AKS cluster.

Usage

Refer to the tutorials to understand how you can expose an AKS service over HTTP or HTTPS, to the internet, using an Azure Application Gateway.

Annotations

The Kubernetes Ingress specification does not allow all features of Application Gateway to be exposed through the ingress resource. Therefore we have introduced application gateway ingress controller specific annotations to expose application gateway features through an ingress resource. Please refer to the annotations to understand the various annotations supported by the ingress controller, and the corresponding features that can be turned on in the application gateway for a given annotation.

Reporting Issues

The best way to report an issue is to create a Github Issue for the project. Please include the following information when creating the issue:

  • Subscription ID for AKS cluster.
  • Subscription ID for Application Gateway.
  • AKS cluster name/ARM Resource ID.
  • Application Gateway name/ARM Resource ID.
  • Ingress resource definition that might causing the problem.
  • The Helm configuration used to install the ingress controller.

Contributing

This is a Golang project. You can find the build instructions of the project in the Developer Guide.

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

You can’t perform that action at this time.