Kubernetes Deployment Manifest

External

• https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.19/#deployment-v1-apps

Internal

• Kubernetes Deployments
• Common Manifest Elements

Example

apiVersion: apps/v1
kind: Deployment
metadata:
  name: archaeopteryx
  labels:
    color: blue
spec:
  replicas: 1
  selector:
    matchLabels:
      function: builder
  strategy:
  revisionHistoryLimit:
  progressDeadlineSeconds:
  template:
    metadata:
      labels:
        function: builder
      # see pod manifest
      ...
    spec:
      # see pod manifest
      ...

.spec Elements

replicas

Specifies the number of desired pods. Defaults to 1.

0 is a valid value, it indicates that the deployment should be created but no pods should be started at the time of the deployment creation. The deployment can be scaled later with kubectl scale.

selector

Specifies the label selector for pods. Existing ReplicaSets whose pods are selected by this will be the ones affected by this deployment. It must match the pod template's labels.

Selector Concepts

strategy

Specifies the deployment strategy to use to replace existing pods with new ones.

https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.14/#deploymentstrategy-v1-apps

revisionHistoryLimit

The number of old ReplicaSets to retain to allow rollback. Defaults to 10.

progressDeadlineSeconds

The maximum time in seconds for a deployment to make progress before it is considered to be failed. The deployment controller will continue to process failed deployments and a condition with a ProgressDeadlineExceeded reason will be surfaced in the deployment status. Note that progress will not be estimated during the time a deployment is paused. Defaults to 600s.

template

The template describes the pods that will be created. Its structure is similar to that of a pod manifest.

Pod Names

See:

Deployments | Pod Name

Pod Manifest

Pod Manifest