beta API version · group apps

apps/v1beta2

Removed in 1.16

No Kubernetes release since 1.16 serves apiVersion: apps/v1beta2. 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 apps/v1beta2

Kind	Introduced	Deprecated	Stops being served	Use instead
ControllerRevision	1.8	1.9	1.16	apps/v1
DaemonSet	1.8	1.9	1.16	apps/v1
Deployment	1.8	1.9	1.16	apps/v1
ReplicaSet	1.8	1.9	1.16	apps/v1
Scale	1.8	1.9	1.16	autoscaling/v1
StatefulSet	1.8	1.9	1.16	apps/v1

Served in which releases

Kind162025303537

ControllerRevision

DaemonSet

Deployment

ReplicaSet

Scale

StatefulSet

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

Migrating off apps/v1beta2

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: apps/v1beta2
+ 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: apps/v1beta2
+ apiVersion: apps/v1
  kind: Deployment

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

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: apps/v1beta2
+ apiVersion: apps/v1
  kind: ReplicaSet

StatefulSet 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
spec.updateStrategy.type now defaults to RollingUpdate (the default in apps/v1beta1 was OnDelete)

- apiVersion: apps/v1beta2
+ apiVersion: apps/v1
  kind: StatefulSet

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

Other versions of apps

apps/v1 Stable apps/v1beta1 Removed in 1.16

Check your manifests for apps/v1beta2 and other removed versions →