Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Azure/application-gateway-kubernetes-ingress

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.
https://github.com/Azure/application-gateway-kubernetes-ingress

agic aks application-gateway azure go ingress ingress-controller kubernetes

Last synced: about 1 month ago
JSON representation

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.

Awesome Lists containing this project

README 

        
# Application Gateway Ingress Controller

![GitHub release (latest by date)](https://img.shields.io/github/v/release/azure/application-gateway-kubernetes-ingress)

[![Build Status](https://dev.azure.com/azure/application-gateway-kubernetes-ingress/_apis/build/status/Merge%20Builds?branchName=master)](https://dev.azure.com/azure/application-gateway-kubernetes-ingress/_build/latest?definitionId=30&branchName=master)

[![Go Report Card](https://goreportcard.com/badge/Azure/application-gateway-kubernetes-ingress)](https://goreportcard.com/report/Azure/application-gateway-kubernetes-ingress)

![GitHub go.mod Go version](https://img.shields.io/github/go-mod/go-version/azure/application-gateway-kubernetes-ingress)



![Staging release (latest by date)](https://img.shields.io/badge/dynamic/yaml?url=https://appgwingress.blob.core.windows.net/ingress-azure-helm-package-staging/index.yaml&label=nightly&query=entries[%22ingress-azure%22][0].appVersion&color=green)



Application Gateway Ingress Controller (AGIC) is a Kubernetes application, which makes it possible for [Azure Kubernetes Service (AKS)](https://azure.microsoft.com/en-us/services/kubernetes-service/) customers to leverage Azure's native [Application Gateway](https://azure.microsoft.com/en-us/services/application-gateway/) L7 load-balancer to expose cloud software to the Internet. AGIC monitors the Kubernetes cluster it is hosted on and continuously updates an App Gateway, so that selected services are exposed to the Internet.



The Ingress Controller runs in its own pod on the customer’s AKS. AGIC monitors a subset of Kubernetes Resources for changes. The state of the AKS cluster is translated to App Gateway  specific configuration and applied to the [Azure Resource Manager (ARM)](https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-overview).



![Azure Application Gateway + AKS](docs/images/architecture.png)



AGIC is configured via the Kubernetes [Ingress resource](http://kubernetes.io/docs/user-guide/ingress/), along with Service and Deployments/Pods. It provides a number of features, leveraging Azure’s native App Gateway L7 load balancer. To name a few:

  - URL routing

  - Cookie-based affinity

  - SSL termination

  - End-to-end SSL

  - Support for public, private, and hybrid web sites

  - Integrated web application firewall



## Changelog

- [Release Notes, Fixes and Known issues](https://github.com/Azure/application-gateway-kubernetes-ingress/blob/master/CHANGELOG)



## Blogs and talks

- [Application Gateway Ingress Controller for Azure Kubernetes Service](https://azure.microsoft.com/en-us/blog/application-gateway-ingress-controller-for-azure-kubernetes-service/)

- [Ignite 2019 - AGIC GA announcement](https://myignite.techcommunity.microsoft.com/sessions/82945)



## Setup



- [**Installation**](docs/setup/install.md): Instructions on installing AGIC.



## Usage



[**Tutorials**](docs/tutorials/tutorial.general.md): Refer to these to understand how you can expose an AKS service over HTTP or HTTPS, to the internet, using an Azure Application Gateway.



[**Features**](docs/features/): List of all available AGIC features.



[**Annotations**](docs/annotations.md): 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 these 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.



[**Helm Values Configuration Options**](docs/helm-values-documenation.md): This document lists the various configuration options available through helm.



[**Upgrade/Rollback AGIC using helm**](docs/how-tos/helm-upgrade.md): This documents explains how to upgrade/rollback AGIC helm installation.



## How-tos

* [Setup E2E SSL](docs/tutorials/tutorial.e2e-ssl.md)

* [Network connectivity when using kubenet or different virtual networks](./docs/how-tos/networking.md)

* [Automate SSL Cert issuance and rotation with Let's Encrypt](docs/how-tos/lets-encrypt.md)

* [Expose a WebSocket server](docs/how-tos/websockets.md)

* [Automate DNS updates](docs/how-tos/dns.md)

* [Upgrade AGIC via Helm](docs/how-tos/helm-upgrade.md)

* [Scale your Applications using Application Gateway Metrics (Beta)](docs/how-tos/scale-applications-using-appgw-metrics.md)

* [Continuous Deployment with AKS and AGIC using Azure Pipelines](docs/how-tos/continuous-deployment.md)

* [Minimizing Downtime During Deployments](./docs/how-tos/minimize-downtime-during-deployments.md)

* [Increase AGIC verbosity level](./docs/logging-levels.md)



## Troubleshooting



For troubleshooting, please refer to this [guide](docs/troubleshootings).



## Frequently asked questions



For FAQ, please refer to this [guide](docs/faq.md).



## 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



* [Developer Guide](docs/developers/developer-guideline.md)

* [Installing the latest nightly build](./docs/developers/nightly.md)



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 .



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](https://opensource.microsoft.com/codeofconduct/).

For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or

contact [[email protected]](mailto:[email protected]) with any additional questions or comments.