The kubernetes/ingress-nginx project is an Ingress controller for Kubernetes using NGINX as a reverse proxy and load balancer. It provides a robust and feature-rich solution for managing external access to HTTP and HTTPS services in a Kubernetes cluster, offering advanced traffic routing, SSL/TLS termination, and various customization options.

Pros

• Highly configurable and flexible, supporting a wide range of use cases
• Excellent performance and scalability, suitable for high-traffic environments
• Active community support and regular updates
• Extensive documentation and integration with Kubernetes ecosystem

Cons

• Steeper learning curve compared to some simpler Ingress controllers
• Resource-intensive for large-scale deployments
• Configuration complexity can lead to potential misconfigurations
• May require additional setup for certain advanced features

Code Examples

1. Basic Ingress resource:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: example-ingress
  annotations:
    kubernetes.io/ingress.class: nginx
spec:
  rules:
  - host: example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: example-service
            port: 
              number: 80

This example defines a basic Ingress resource that routes traffic for example.com to an example-service on port 80.

2. Configuring SSL/TLS:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: tls-example-ingress
  annotations:
    kubernetes.io/ingress.class: nginx
spec:
  tls:
  - hosts:
    - secure.example.com
    secretName: tls-secret
  rules:
  - host: secure.example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: secure-service
            port: 
              number: 443

This example shows how to configure SSL/TLS for an Ingress resource using a secret containing the certificate and key.

3. Rate limiting configuration:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: rate-limit-example
  annotations:
    kubernetes.io/ingress.class: nginx
    nginx.ingress.kubernetes.io/limit-rps: "10"
spec:
  rules:
  - host: api.example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: api-service
            port: 
              number: 8080

This example demonstrates how to apply rate limiting to an Ingress resource, limiting requests to 10 per second.

Getting Started

1. Install the NGINX Ingress Controller:

kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v1.8.1/deploy/static/provider/cloud/deploy.yaml

2. Create an Ingress resource:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: minimal-ingress
  annotations:
    kubernetes.io/ingress.class: nginx
spec:
  rules:
  - http:
      paths:
      - path: /testpath
        pathType: Prefix
        backend:
          service:
            name: test
            port: 
              number: 80

3. Apply the Ingress resource:

kubectl apply -f ingress.yaml

4. Verify the Ingress is working:

kubectl get ingress