sourcefuse / terraform-aws-eks-ingress-nginx

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

AWS EKS Ingress Nginx Controller Terraform module

Labyrinth Labs logo

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/


Terraform validation pre-commit

Description

A terraform module to deploy an Ingress Nginx Controller.

Related Projects

Check out these related projects.

Examples

See Basic example for further information.

Potential issues with running terraform plan

When deploying with ArgoCD application, Kubernetes terraform provider requires access to Kubernetes cluster API during plan time. This introduces potential issue when you want to deploy the cluster with this addon at the same time, during the same Terraform run.

To overcome this issue, the module deploys the ArgoCD application object using the Helm provider, which does not require API access during plan. If you want to deploy the application using this workaround, you can set the argo_application_use_helm variable to true.

Requirements

Name Version
terraform >= 0.13
aws >= 2.0
helm >= 1.0
utils >= 0.12.0

Modules

No modules.

Resources

Name Type
helm_release.argocd_application resource
helm_release.self resource
kubernetes_manifest.self resource
utils_deep_merge_yaml.argo_application_values data source

Inputs

Name Description Type Default Required
argo_application_enabled If set to true, the module will be deployed as ArgoCD application, otherwise it will be deployed as a Helm release bool false no
argo_application_use_helm If set to true, the ArgoCD Application manifest will be deployed using Kubernetes provider as a Helm release. Otherwise it'll be deployed as a Kubernetes manifest. See Readme for more info bool false no
argo_application_values Value overrides to use when deploying argo application object with helm string "" no
argo_destionation_server Destination server for ArgoCD Application string "https://kubernetes.default.svc" no
argo_info ArgoCD info manifest parameter list
[
{
"name": "terraform",
"value": "true"
}
]
no
argo_namespace Namespace to deploy ArgoCD application CRD to string "argo" no
argo_project ArgoCD Application project string "default" no
argo_sync_policy ArgoCD syncPolicy manifest parameter map {} no
enabled Variable indicating whether deployment is enabled bool true no
helm_chart_name Helm chart name to be installed string "ingress-nginx" no
helm_chart_version Version of the Helm chart string "3.35.0" no
helm_create_namespace Create the namespace if it does not yet exist bool true no
helm_release_name Helm release name string "ingress-nginx" no
helm_repo_url Helm repository string "https://kubernetes.github.io/ingress-nginx" no
k8s_namespace The K8s namespace in which the ingress-nginx has been created string "ingress-controller" no
settings Additional settings which will be passed to the Helm chart values, see https://artifacthub.io/packages/helm/ingress-nginx/ingress-nginx map(any) {} no
values Additional yaml encoded values which will be passed to the Helm chart. string "" no

Outputs

Name Description
helm_release_attributes Helm release attributes

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

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.

About

License:Apache License 2.0


Languages

Language:HCL 77.5%Language:Smarty 22.5%