Update Ingress APIVersion to networking.k8s.io/v1 (#2433)

Author: johngmyers

apis/elbv2/v1alpha1/zz_generated.deepcopy.go

@@ -76,15 +76,15 @@ webhooks:
       service:
         name: webhook-service
         namespace: system
-        path: /validate-networking-v1beta1-ingress
+        path: /validate-networking-v1-ingress
     failurePolicy: Fail
     matchPolicy: Equivalent
     name: vingress.elbv2.k8s.aws
     rules:
       - apiGroups:
           - networking.k8s.io
         apiVersions:
-          - v1beta1
+          - v1
         operations:
           - CREATE
           - UPDATE

apis/elbv2/v1beta1/zz_generated.deepcopy.go

@@ -3,7 +3,7 @@ package eventhandlers
 import (
 	"context"
 	"github.com/go-logr/logr"
-	networking "k8s.io/api/networking/v1beta1"
+	networking "k8s.io/api/networking/v1"
 	"k8s.io/apimachinery/pkg/api/equality"
 	"k8s.io/client-go/tools/record"
 	"k8s.io/client-go/util/workqueue"

config/webhook/manifests.yaml

@@ -3,7 +3,7 @@ package eventhandlers
 import (
 	"context"
 	"github.com/go-logr/logr"
-	networking "k8s.io/api/networking/v1beta1"
+	networking "k8s.io/api/networking/v1"
 	"k8s.io/apimachinery/pkg/api/equality"
 	"k8s.io/client-go/tools/record"
 	"k8s.io/client-go/util/workqueue"

controllers/ingress/eventhandlers/ingress_class_events.go

@@ -5,7 +5,7 @@ import (
 	"fmt"
 	"github.com/go-logr/logr"
 	corev1 "k8s.io/api/core/v1"
-	networking "k8s.io/api/networking/v1beta1"
+	networking "k8s.io/api/networking/v1"
 	"k8s.io/apimachinery/pkg/api/equality"
 	"k8s.io/client-go/tools/record"
 	"k8s.io/client-go/util/workqueue"

controllers/ingress/eventhandlers/ingress_class_params_events.go

@@ -4,7 +4,7 @@ import (
 	"context"
 	"github.com/go-logr/logr"
 	corev1 "k8s.io/api/core/v1"
-	networking "k8s.io/api/networking/v1beta1"
+	networking "k8s.io/api/networking/v1"
 	"k8s.io/apimachinery/pkg/api/equality"
 	"k8s.io/client-go/tools/record"
 	"k8s.io/client-go/util/workqueue"

controllers/ingress/eventhandlers/ingress_events.go

@@ -4,7 +4,7 @@ import (
 	"context"
 	"github.com/go-logr/logr"
 	corev1 "k8s.io/api/core/v1"
-	networking "k8s.io/api/networking/v1beta1"
+	networking "k8s.io/api/networking/v1"
 	"k8s.io/apimachinery/pkg/api/equality"
 	"k8s.io/client-go/tools/record"
 	"k8s.io/client-go/util/workqueue"

controllers/ingress/eventhandlers/secret_events.go

@@ -6,7 +6,7 @@ import (
 	"github.com/go-logr/logr"
 	"github.com/pkg/errors"
 	corev1 "k8s.io/api/core/v1"
-	networking "k8s.io/api/networking/v1beta1"
+	networking "k8s.io/api/networking/v1"
 	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
 	"k8s.io/client-go/kubernetes"
 	"k8s.io/client-go/tools/record"
@@ -36,7 +36,7 @@ const (
 	controllerName   = "ingress"
 
 	// the groupVersion of used Ingress & IngressClass resource.
-	ingressResourcesGroupVersion = "networking.k8s.io/v1beta1"
+	ingressResourcesGroupVersion = "networking.k8s.io/v1"
 	ingressClassKind             = "IngressClass"
 )
 

controllers/ingress/eventhandlers/service_events.go

@@ -18,7 +18,7 @@ Refer to the [installation guide](installation.md) for installing the controller
 You can limit the ingresses ALB ingress controller controls by combining following two approaches:
 
 ### Limiting ingress class
-Setting the `--ingress-class` argument constrains the controller's scope to ingresses with matching `kubernetes.io/ingress.class` annotation.
+Setting the `--ingress-class` argument constrains the controller's scope to ingresses with matching `ingressClassName` field.
 
 An example of the container spec portion of the controller, only listening for resources with the class "alb", would be as follows.
 
@@ -29,18 +29,17 @@ spec:
     - --ingress-class=alb
 ```
 
-Now, only ingress resources with the appropriate annotation are picked up, as seen below.
+Now, only ingress resources with the appropriate class are picked up, as seen below.
 
 ```yaml
-apiVersion: extensions/v1beta1
+apiVersion: networking.k8s.io/v1
 kind: Ingress
 metadata:
   name: echoserver
   namespace: echoserver
-  annotations:
-    kubernetes.io/ingress.class: "alb"
 spec:
-    ...
+  ingressClassName: alb
+  ...
 ```
 
 If the ingress class is not specified, the controller will reconcile Ingress objects without the ingress class specified or ingress class `alb`.

controllers/ingress/group_controller.go

@@ -2,7 +2,8 @@
 
 ## Kubernetes version requirements
 * AWS Load Balancer Controller v2.0.0~v2.1.3 requires Kubernetes 1.15+
-* AWS Load Balancer Controller v2.2.0+ requires Kubernetes 1.16+
+* AWS Load Balancer Controller v2.2.0~v2.3.1 requires Kubernetes 1.16-1.21
+* AWS Load Balancer Controller v2.4.0+ requires Kubernetes 1.19+
 
 !!!warning "Existing AWS ALB Ingress Controller users"
     AWS ALB Ingress controller must be uninstalled before installing AWS Load Balancer controller.

docs/deploy/configurations.md

@@ -20,7 +20,7 @@ spec:
         app.kubernetes.io/name: app-2048
     spec:
       containers:
-      - image: alexwhen/docker-2048
+      - image: public.ecr.aws/l6m2t8p7/docker-2048:latest
         imagePullPolicy: Always
         name: app-2048
         ports:
@@ -40,20 +40,23 @@ spec:
   selector:
     app.kubernetes.io/name: app-2048
 ---
-apiVersion: networking.k8s.io/v1beta1
+apiVersion: networking.k8s.io/v1
 kind: Ingress
 metadata:
   namespace: game-2048
   name: ingress-2048
   annotations:
-    kubernetes.io/ingress.class: alb
     alb.ingress.kubernetes.io/scheme: internet-facing
     alb.ingress.kubernetes.io/target-type: ip
 spec:
+  ingressClassName: alb
   rules:
     - http:
         paths:
-          - path: /*
-            backend:
-              serviceName: service-2048
-              servicePort: 80
+        - path: /
+          pathType: Prefix
+          backend:
+            service:
+              name: service-2048
+              port:
+                number: 80

docs/deploy/installation.md

@@ -17,13 +17,12 @@
 #    - Related Kubernetes service/application
 #
 
-apiVersion: extensions/v1beta1
+apiVersion: networking.k8s.io/v1
 kind: Ingress
 metadata:
   name: <ingress-name>  # app.example.com
   namespace: <placement-namespace>  # default
   annotations:
-    kubernetes.io/ingress.class: alb
     alb.ingress.kubernetes.io/scheme: internet-facing
     alb.ingress.kubernetes.io/tags: Environment=<environment-name>,Owner=<your-name>
     # For each `listen-ports` object defined an ALB lister is created
@@ -50,18 +49,25 @@ metadata:
     # ACM certificate ARN for your SSL domain
     alb.ingress.kubernetes.io/certificate-arn: arn:aws:acm:<region>:<account-id>:certificate/<certificate-id>
 spec:
+  ingressClassName: alb
   rules:
     # If you are using ExternalDNS, this will become your applications FQDN
     - host: <FQDN>
       http:
         paths:
           # This first path should perform an ssl-redirect as below
-          - path: /*
+          - path: /
+            pathType: Prefix
             backend:
-              serviceName: ssl-redirect
-              # Configured via the redirect settings in the annotations
-              servicePort: use-annotation
+              service:
+                name: ssl-redirect
+                # Configured via the redirect settings in the annotations
+                port:
+                  name: use-annotation
           - path: <html-path>
+            pathType: Prefix
             backend:
-              serviceName: <service-name>
-              servicePort: <service-port>
+              service:
+                name: <service-name>
+                port:
+                  number: <service-port>

docs/examples/2048/2048_full.yaml

@@ -131,7 +131,7 @@ In this walkthrough, you'll
         ```
 
         ```yaml
-        apiVersion: extensions/v1beta1
+        apiVersion: networking.k8s.io/v1
         kind: Ingress
         metadata:
             name: echoserver

docs/examples/2048/2048_full_latest.yaml

@@ -1,18 +1,21 @@
-apiVersion: networking.k8s.io/v1beta1
+apiVersion: networking.k8s.io/v1
 kind: Ingress
 metadata:
   name: echoserver
   namespace: echoserver
   annotations:
-    kubernetes.io/ingress.class: alb
     alb.ingress.kubernetes.io/scheme: internet-facing
     alb.ingress.kubernetes.io/tags: Environment=dev,Team=test
 spec:
+  ingressClassName: alb
   rules:
     - host: echoserver.example.com
       http:
         paths:
           - path: /
+            pathType: Exact
             backend:
-              serviceName: echoserver
-              servicePort: 80
+              service:
+                name: echoserver
+                port:
+                  number: 80

docs/examples/cognito-ingress-template.yaml

@@ -1,4 +1,4 @@
-apiVersion: networking.k8s.io/v1beta1
+apiVersion: networking.k8s.io/v1
 kind: Ingress
 metadata:
   annotations:
@@ -8,22 +8,28 @@ metadata:
     alb.ingress.kubernetes.io/listen-ports: '[{"HTTP": 80}, {"HTTPS":443}]'
     alb.ingress.kubernetes.io/scheme: internet-facing
     alb.ingress.kubernetes.io/target-type: ip
-    kubernetes.io/ingress.class: alb
   labels:
     app: grpcserver
     environment: dev
   name: grpcserver
   namespace: grpcserver
 spec:
+  ingressClassName: alb
   rules:
   - host: grpcserver.example.com
     http:
       paths:
       - backend:
-          serviceName: ssl-redirect
-          servicePort: use-annotation
-        path: /*
+          service:
+            name: ssl-redirect
+            port:
+              name: use-annotation
+        path: /
+        pathType: Prefix
       - backend:
-          serviceName: grpcserver
-          servicePort: 50051
-        path: /helloworld.Greeter/*
+          service:
+            name: grpcserver
+            port:
+              number: 50051
+        path: /helloworld.Greeter
+        pathType: Prefix