AWS EKS ALB Ingress Terraform module
We help companies build, run, deploy and scale software and infrastructure by embracing the right technologies and principles. Check out our website at https://lablabs.io/
Description
A terraform module to deploy an Application Load Balancer (ALB) Ingress Controller on Amazon EKS cluster.
AWS region and VPC discovery
ALB Ingress controller Helm chart may discover AWS region and AWS VPC
automatically if autoDiscoverAwsRegion
and autoDiscoverAwsVpcID
parameters
are set to true
(see settings
input variable). Otherwise, you must set
awsRegion
and awsVpcID
parameters in order to deploy the controller.
Requirements
Name | Version |
---|---|
terraform | >= 0.12.26, < 0.14.0 |
aws | >= 2.0, < 4.0 |
helm | >= 1.0, < 1.4.0 |
local | ~> 1.2 |
null | ~> 2.0 |
Inputs
Name | Description | Type | Default | Required |
---|---|---|---|---|
cluster_identity_oidc_issuer | The OIDC Identity issuer for the cluster | string |
n/a | yes |
cluster_identity_oidc_issuer_arn | The OIDC Identity issuer ARN for the cluster that can be used to associate IAM roles with a service account | string |
n/a | yes |
cluster_name | The name of the cluster | string |
n/a | yes |
enabled | n/a | bool |
n/a | yes |
helm_chart_name | n/a | string |
"aws-alb-ingress-controller" |
no |
helm_chart_version | n/a | string |
"0.1.13" |
no |
helm_release_name | n/a | string |
"aws-alb-ingress-controller" |
no |
helm_repo_url | n/a | string |
"http://storage.googleapis.com/kubernetes-charts-incubator" |
no |
k8s_namespace | The k8s namespace in which the alb-ingress service account has been created | string |
"alb-ingress" |
no |
k8s_service_account_name | The k8s alb-ingress service account name | string |
"aws-alb-ingress-controller" |
no |
mod_dependency | Dependence variable binds all AWS resources allocated by this module, dependent modules reference this variable | any |
null |
no |
settings | Additional settings which will be passed to the Helm chart values, see https://hub.helm.sh/charts/incubator/aws-alb-ingress-controller | map(any) |
{} |
no |
Outputs
No output.
Contributing and reporting issues
Feel free to create an issue in this repository if you have questions, suggestions or feature requests.
Validation, linters and pull-requests
We want to provide high quality code and modules. For this reason we are using several pre-commit hooks and GitHub Actions workflow. A pull-request to the master branch will trigger these validations and lints automatically. Please check your code before you will create pull-requests. See pre-commit documentation and GitHub Actions documentation for further details.
License
See LICENSE for full details.
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
https://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.