beta API version · group extensions

extensions/v1beta1

Removed in 1.22

No Kubernetes release since 1.22 serves apiVersion: extensions/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 extensions/v1beta1

Kind	Introduced	Deprecated	Stops being served	Use instead
DaemonSet	1.1	1.8	1.16	apps/v1
Deployment	1.1	1.8	1.16	apps/v1
DeploymentRollback	1.2	1.8	1.16	—
Ingress	1.1	1.14	1.22	networking.k8s.io/v1
NetworkPolicy	1.3	1.9	1.16	networking.k8s.io/v1
PodSecurityPolicy	—	—	1.16	Pod Security Admission (no API replacement)
ReplicaSet	1.2	1.8	1.16	apps/v1
Scale	1.1	1.2	1.16	—

Served in which releases

Kind162025303537

DaemonSet

Deployment

DeploymentRollback

Ingress

NetworkPolicy

PodSecurityPolicy

ReplicaSet

Scale

served served, deprecated exists but off by default not served · 1.16 to 1.37; release of introduction unknown for kinds removed from the source, treated as served before removal

Migrating off extensions/v1beta1

DaemonSet removed in 1.16

Move to apps/v1, served since 1.9. Existing objects stay readable through the new version.

What changes:

spec.templateGeneration is removed
spec.selector is now required and immutable after creation; use the existing template labels as the selector for seamless upgrades
spec.updateStrategy.type now defaults to RollingUpdate (the default in extensions/v1beta1 was OnDelete)

- apiVersion: extensions/v1beta1
+ apiVersion: apps/v1
  kind: DaemonSet

From the Kubernetes Deprecated API Migration Guide, © The Kubernetes Authors, CC BY 4.0.

Deployment removed in 1.16

Move to apps/v1, served since 1.9. Existing objects stay readable through the new version.

What changes:

spec.rollbackTo is removed
spec.selector is now required and immutable after creation; use the existing template labels as the selector for seamless upgrades
spec.progressDeadlineSeconds now defaults to 600 seconds (the default in extensions/v1beta1 was no deadline)
spec.revisionHistoryLimit now defaults to 10 (the default in apps/v1beta1 was 2, the default in extensions/v1beta1 was to retain all)
maxSurge and maxUnavailable now default to 25% (the default in extensions/v1beta1 was 1)

- apiVersion: extensions/v1beta1
+ apiVersion: apps/v1
  kind: Deployment

From the Kubernetes Deprecated API Migration Guide, © The Kubernetes Authors, CC BY 4.0.

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: extensions/v1beta1
+ apiVersion: networking.k8s.io/v1
  kind: Ingress

From the Kubernetes Deprecated API Migration Guide, © The Kubernetes Authors, CC BY 4.0.

NetworkPolicy removed in 1.16

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

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

PodSecurityPolicy removed in 1.16

Move to policy/v1beta1, served since 1.10. Existing objects stay readable through the new version.

- apiVersion: extensions/v1beta1
+ apiVersion: policy/v1beta1
  kind: PodSecurityPolicy

ReplicaSet removed in 1.16

Move to apps/v1, served since 1.9. Existing objects stay readable through the new version.

What changes:

spec.selector is now required and immutable after creation; use the existing template labels as the selector for seamless upgrades

- apiVersion: extensions/v1beta1
+ apiVersion: apps/v1
  kind: ReplicaSet

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

Check your manifests for extensions/v1beta1 and other removed versions →