beta API version · group networking.k8s.io

networking.k8s.io/v1beta1

Removed in 1.37

No Kubernetes release since 1.37 serves apiVersion: networking.k8s.io/v1beta1. Objects that were stored through it are still in etcd and readable through the replacement version; only manifests and clients that name this version break.

Kinds in networking.k8s.io/v1beta1

Kind	Introduced	Deprecated	Stops being served	Use instead
IPAddress beta · off by default	1.31	1.34	1.37	networking.k8s.io/v1
Ingress	1.14	1.19	1.22	networking.k8s.io/v1
IngressClass	1.18	1.19	1.22	networking.k8s.io/v1
ServiceCIDR beta · off by default	1.31	1.34	1.37	networking.k8s.io/v1

Served in which releases

Kind162025303537

IPAddress

Ingress

IngressClass

ServiceCIDR

served served, deprecated exists but off by default not served · 1.16 to 1.37

Migrating off networking.k8s.io/v1beta1

Ingress removed in 1.22

Move to networking.k8s.io/v1, served since 1.19. Existing objects stay readable through the new version.

What changes:

spec.backend is renamed to spec.defaultBackend
The backend serviceName field is renamed to service.name
Numeric backend servicePort fields are renamed to service.port.number
String backend servicePort fields are renamed to service.port.name
pathType is now required for each specified path. Options are Prefix, Exact, and ImplementationSpecific. To match the undefined v1beta1 behavior, use ImplementationSpecific.

- apiVersion: networking.k8s.io/v1beta1
+ apiVersion: networking.k8s.io/v1
  kind: Ingress

IngressClass removed in 1.22

Move to networking.k8s.io/v1, served since 1.19. Existing objects stay readable through the new version.

- apiVersion: networking.k8s.io/v1beta1
+ apiVersion: networking.k8s.io/v1
  kind: IngressClass

To convert files mechanically: kubectl convert -f old.yaml --output-version networking.k8s.io/v1 (the kubectl-convert plugin, installed separately). Review defaults it fills in.

Other versions of networking.k8s.io

networking.k8s.io/v1 Stable

Check your manifests for networking.k8s.io/v1beta1 and other removed versions →