apiVersion: apps/v1
kind: Deployment
metadata:
name: nginx-deployment
labels:
app: nginx
spec:
replicas: 3
selector:
matchLabels:
app: nginx
template:
metadata:
labels:
app: nginx
spec:
containers:
- name: nginx
image: nginx:1.14.2
ports:
- containerPort: 80
.spec.selector.matchLabelsフィールドは{key,value}ペアのマップです。
matchLabelsマップ内の単一の{key,value}は、keyフィールドの値が"key"、operatorが"In"、values配列には"value"のみを含むmatchExpressionsの要素と等しくなります。
条件に一致させるためには、matchLabelsとmatchExpressionsの両方の要件を満たす必要があります。Deploymentに対して適切なセレクターとPodテンプレートのラベルを設定する必要があります(このケースではapp: nginx)。
ラベルやセレクターを他のコントローラーと重複させないでください(他のDeploymentやStatefulSetを含む)。 Kubernetesはユーザーがラベルを重複させることを阻止しないため、複数のコントローラーでセレクターの重複が発生すると、コントローラー間で衝突し予期せぬふるまいをすることになります。
.spec.template)が変更された場合にのみトリガーされます。
例えばテンプレートのラベルもしくはコンテナイメージが更新された場合です。
Deploymentのスケールのような更新では、ロールアウトはトリガーされません。availableReplicasの数を計算する際に、終了中(terminating)のPodをカウントしません。
availableReplicasの数は、replicas - maxUnavailableからreplicas + maxSurgeの間でなければなりません。
その結果、ロールアウト中に予想よりも多くのPodが存在することに気づくことがあります。
また、終了中のPodのterminationGracePeriodSecondsが経過するまで、Deploymentが消費するリソースの合計がreplicas + maxSurgeよりも多くなることがあります。.spec.template)が変更されたとき、例えばテンプレートのラベルやコンテナイメージを更新したときにのみ、新しいリビジョンが作成されることを意味します。
Deploymentのスケーリングなど、他の種類の更新ではDeploymentのリビジョンは作成されません。
これは手動もしくはオートスケーリングを同時に行うことができるようにするためです。
これは過去のリビジョンにロールバックするとき、DeploymentのPodテンプレートの箇所のみロールバックされることを意味します。maxUnavailable)に依存します。
デフォルトではKubernetesがこの値を25%に設定します。--recordフラグを使用してCHANGE-CAUSEフィールドを自動的に設定できました。
このフラグは非推奨であり、将来のリリースで削除される予定です。reason: ProgressDeadlineExceededのステータス状態を報告する以外に、停止状態のDeploymentに対して何のアクションも実行しません。
上位レベルのオーケストレーターはこれを利用して、状態に応じて行動できます。
例えば、前のバージョンへのDeploymentのロールバックが挙げられます。apiVersion: apps/v1
kind: Deployment
metadata:
name: nginx-deployment
labels:
app: nginx
spec:
replicas: 3
selector:
matchLabels:
app: nginx
template:
metadata:
labels:
app: nginx
spec:
containers:
- name: nginx
image: nginx:1.14.2
ports:
- containerPort: 80
strategy:
type: RollingUpdate
rollingUpdate:
maxUnavailable: 1
apiVersion: apps/v1
kind: Deployment
metadata:
name: nginx-deployment
labels:
app: nginx
spec:
replicas: 3
selector:
matchLabels:
app: nginx
template:
metadata:
labels:
app: nginx
spec:
containers:
- name: nginx
image: nginx:1.14.2
ports:
- containerPort: 80
strategy:
type: RollingUpdate
rollingUpdate:
maxSurge: 1
apiVersion: apps/v1
kind: Deployment
metadata:
name: nginx-deployment
labels:
app: nginx
spec:
replicas: 3
selector:
matchLabels:
app: nginx
template:
metadata:
labels:
app: nginx
spec:
containers:
- name: nginx
image: nginx:1.14.2
ports:
- containerPort: 80
strategy:
type: RollingUpdate
rollingUpdate:
maxSurge: 1
maxUnavailable: 1
Kubernetes v1.35 [beta](デフォルトで有効)