Install Nginx Ingress Controller ( Ansible )

You can use this role to install Nginx Ingress for Kubernetes.

For the sake of clarity, there are two versions of Nginx Ingress controller:

• Community version – Found in the kubernetes/ingress-nginx repo on GitHub, the community Ingress controller is based on Nginx Open Source with docs on Kubernetes.io. It is maintained by the Kubernetes community with a commitment from F5 Nginx to help manage the project
• Nginx version – Found in the nginxinc/kubernetes-ingress repo on GitHub, Nginx Ingress Controller is developed and maintained by F5 Nginx with docs on docs.nginx.com. It is available in two editions:
  • Nginx Open Source‑based (free and open source option)
  • Nginx Plus-based (commercial option)

A ❤ for community

How-to

First you need instal the role:

• Clone this role:

  git clone [email protected]:hatamiarash7/Ansible-Install-Nginx-Ingress.git install_nginx_ingress
  

• Or you can install using galaxy:

  ansible-galaxy install hatamiarash7.install_nginx_ingress
  

Then, Include role in Playbook:

- hosts: all
    roles:
        - hatamiarash7.install_nginx_ingress

Dependencies

This role will use Helm to install Nginx ingress. Also you need Docker & Kubernetes. Take a look at these roles too:

• install_docker
• install_kubernetes
• install_helm

Usage

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
    name: documentation
    annotations:
        kubernetes.io/ingress.class: nginx
spec:
    rules:
        - host: docs.domain.ir
          http:
              paths:
                  - path: /
                    pathType: Prefix
                    backend:
                        service:
                            name: documentation
                            port:
                                number: 3000

Note : The default configuration was changed to work with kubeadm managed clusters.

Support 💛

Contributing 🤝

Don't be shy and reach out to us if you want to contribute 😉

1. Fork it !
2. Create your feature branch : git checkout -b my-new-feature
3. Commit your changes : git commit -am 'Add some feature'
4. Push to the branch : git push origin my-new-feature
5. Submit a pull request

Issues

Each project may have many problems. Contributing to the better development of this project by reporting them. 👍