第9章 DeploymentConfig [apps.openshift.io/v1]

minReadySeconds

integer

MinReadySeconds は、新しく作成された Pod が使用可能であると見なされるために、コンテナーがクラッシュすることなく準備ができる最小秒数。デフォルトは 0 です (Pod は準備ができ次第利用可能と見なされます)

paused

boolean

Paused は、デプロイメント設定が一時停止され、テンプレートの変更または他のトリガーにより引き起こされたテンプレートの変更に新しいデプロイメントが発生しないことを示します。

replicas

integer

レプリカは、必要なレプリカの数です。

revisionHistoryLimit

integer

RevisionHistoryLimit は、ロールバックを可能にするために保持する古い ReplicationController の数です。このフィールドは、明示的なゼロと、指定されていないものを区別できるようにするためのポインターです。デフォルトは 10 です。(これは、レガシーリソースではなく、新しいグループの API リソースを介して作成された DeploymentConfig にのみ適用されます。)

selector

object (string)

Selector は、Replicas 数と一致する必要がある Pod に対するラベルクエリーです。

strategy

object

DeploymentStrategy は、デプロイメントを実行する方法を説明します。

template

PodTemplateSpec

テンプレートは、不十分なレプリカが検出された場合に作成される Pod を説明するオブジェクトです。

test

boolean

テストでは、デプロイメントの実行中を除いて、このデプロイメント設定のレプリカがゼロであることを確認します。これにより、デプロイメント設定を継続的なデプロイメントテストとして使用できます。つまり、イメージでトリガーし、デプロイメントを実行してから、成功または失敗します。ポストストラテジーフックと After アクションを使用して、デプロイメントの成功をアクションと統合できます。

triggers

array

トリガーは、DeploymentConfig の更新によって新しいデプロイメントがどのように発生するかを決定します。トリガーが定義されていない場合、新しいデプロイメントは、新しい LatestVersion を使用した DeploymentConfig への明示的なクライアント更新の結果としてのみ発生します。null の場合、デフォルトで設定変更トリガーが設定されます。

triggers[]

object

DeploymentTriggerPolicy は、新しいデプロイメントをもたらす単一のトリガーのポリシーを記述します。

activeDeadlineSeconds

integer

ActiveDeadlineSeconds は、システムがアクティブに終了を試みる前に、このデプロイメント設定のデプロイヤー Pod がノード上でアクティブになる可能性がある秒単位の期間です。

annotations

object (string)

Annotations は、カスタムデプロイヤーとライフサイクルのプレ/ポストフック Pod に追加されるキーと値のペアのセットです。

customParams

object

CustomDeploymentStrategyParams は、カスタムデプロイメント戦略への入力です。

labels

object (string)

ラベルは、カスタムデプロイヤーとライフサイクルのプレ/ポストフック Pod に追加されるキーと値のペアのセットです。

recreateParams

object

RecreateDeploymentStrategyParams は、Recreate デプロイメント戦略への入力です。

resources

ResourceRequirements

リソースには、デプロイメントおよびフックを実行するためのリソース要件が含まれています。

rollingParams

object

RollingDeploymentStrategyParams は、Rolling デプロイメント戦略への入力です。

type

string

タイプは、デプロイメント戦略の名前です。

command

array (string)

Command は任意であり、コンテナーイメージの CMD を上書きします。

environment

array (EnvVar)

環境は、イメージのコンテナーに与えられる環境を保持します。

image

string

イメージは、デプロイメントを実行できるコンテナーイメージを指定します。

mid

object

LifecycleHook は、特定のデプロイメントライフサイクルアクションを定義します。一度に指定できるアクションのタイプは 1 つだけです。

post

object

LifecycleHook は、特定のデプロイメントライフサイクルアクションを定義します。一度に指定できるアクションのタイプは 1 つだけです。

pre

object

LifecycleHook は、特定のデプロイメントライフサイクルアクションを定義します。一度に指定できるアクションのタイプは 1 つだけです。

timeoutSeconds

integer

TimeoutSeconds は、更新を待ってからあきらめるまでの時間です。値が nil の場合は、デフォルトが使用されます。

execNewPod

object

ExecNewPodHook は、デプロイメントテンプレートの一部であると想定される指定されたコンテナーに基づいて、新しい Pod でコマンドを実行するフック実装です。

failurePolicy

string

FailurePolicy は、フックが失敗した場合に実行するアクションを指定します。

tagImages

array

TagImages は、コンテナーの下で参照されている現在のイメージをイメージストリームタグにタグ付けするようにデプロイヤ－に指示します。

tagImages[]

object

TagImageHook は、特定のコンテナー内のイメージを ImageStreamTag にタグ付けするリクエストです。

command

array (string)

コマンドは、アクションコマンドおよびその引数です。

containerName

string

ContainerName は、デプロイメント Pod テンプレート内のコンテナーの名前であり、そのコンテナーイメージはフック Pod のコンテナーに使用されます。

env

array (EnvVar)

Env は、フック Pod のコンテナーに提供する環境変数のセットです。

volumes

array (string)

ボリュームは、フック Pod にコピーする必要がある Pod テンプレートからの名前付きボリュームのリストです。Pod 仕様にないボリューム名は無視されます。空のリストは、ボリュームがコピーされないことを意味します。

containerName

string

ContainerName は、イメージ値がタグのソースとして使用されるデプロイメント設定内のコンテナーの名前です。コンテナーが 1 つしかない場合、この値はデフォルトでそのコンテナーの名前になります。

to

ObjectReference

To は、コンテナーのイメージを設定するターゲット ImageStreamTag です。

execNewPod

object

ExecNewPodHook は、デプロイメントテンプレートの一部であると想定される指定されたコンテナーに基づいて、新しい Pod でコマンドを実行するフック実装です。

failurePolicy

string

FailurePolicy は、フックが失敗した場合に実行するアクションを指定します。

tagImages

array

TagImages は、コンテナーの下で参照されている現在のイメージをイメージストリームタグにタグ付けするようにデプロイヤ－に指示します。

tagImages[]

object

TagImageHook は、特定のコンテナー内のイメージを ImageStreamTag にタグ付けするリクエストです。

command

array (string)

コマンドは、アクションコマンドおよびその引数です。

containerName

string

ContainerName は、デプロイメント Pod テンプレート内のコンテナーの名前であり、そのコンテナーイメージはフック Pod のコンテナーに使用されます。

env

array (EnvVar)

Env は、フック Pod のコンテナーに提供する環境変数のセットです。

volumes

array (string)

ボリュームは、フック Pod にコピーする必要がある Pod テンプレートからの名前付きボリュームのリストです。Pod 仕様にないボリューム名は無視されます。空のリストは、ボリュームがコピーされないことを意味します。

containerName

string

ContainerName は、イメージ値がタグのソースとして使用されるデプロイメント設定内のコンテナーの名前です。コンテナーが 1 つしかない場合、この値はデフォルトでそのコンテナーの名前になります。

to

ObjectReference

To は、コンテナーのイメージを設定するターゲット ImageStreamTag です。

execNewPod

object

ExecNewPodHook は、デプロイメントテンプレートの一部であると想定される指定されたコンテナーに基づいて、新しい Pod でコマンドを実行するフック実装です。

failurePolicy

string

FailurePolicy は、フックが失敗した場合に実行するアクションを指定します。

tagImages

array

TagImages は、コンテナーの下で参照されている現在のイメージをイメージストリームタグにタグ付けするようにデプロイヤ－に指示します。

tagImages[]

object

TagImageHook は、特定のコンテナー内のイメージを ImageStreamTag にタグ付けするリクエストです。

command

array (string)

コマンドは、アクションコマンドおよびその引数です。

containerName

string

ContainerName は、デプロイメント Pod テンプレート内のコンテナーの名前であり、そのコンテナーイメージはフック Pod のコンテナーに使用されます。

env

array (EnvVar)

Env は、フック Pod のコンテナーに提供する環境変数のセットです。

volumes

array (string)

ボリュームは、フック Pod にコピーする必要がある Pod テンプレートからの名前付きボリュームのリストです。Pod 仕様にないボリューム名は無視されます。空のリストは、ボリュームがコピーされないことを意味します。

containerName

string

ContainerName は、イメージ値がタグのソースとして使用されるデプロイメント設定内のコンテナーの名前です。コンテナーが 1 つしかない場合、この値はデフォルトでそのコンテナーの名前になります。

to

ObjectReference

To は、コンテナーのイメージを設定するターゲット ImageStreamTag です。

intervalSeconds

integer

IntervalSeconds は、更新後のデプロイメントステータスのポーリングの間に待機する時間です。値が nil の場合は、デフォルトが使用されます。

maxSurge

IntOrString

MaxSurge は、元の Pod 数を超えてスケジュールできる Pod の最大数です。値は、絶対数 (例: 5) または更新開始時の Pod 全体のパーセンテージ (例: 10%) にすることができます。絶対数は、端数を切り上げてパーセンテージから計算されます。

MaxUnavailable が 0 の場合は、これを 0 にすることができません。デフォルトでは、25% が使用されます。

例: これが 30% に設定されている場合は、ローリング更新が開始するとすぐに新しい RC を 30% スケールアップできます。古い Pod が強制的に終了されると、新しい RC をさらにスケールアップして、更新中にいつでも実行されている Pod の総数が元の Pod の最大 130% になるようにすることができます。

maxUnavailable

IntOrString

MaxUnavailable は、更新中に使用できなくなる可能性のある Pod の最大数です。値は、絶対数 (例: 5) または更新開始時の Pod 全体のパーセンテージ (例: 10%) にすることができます。絶対数は、端数を切り捨ててパーセンテージから計算されます。

MaxSurge が 0 の場合は、これを 0 にすることはできません。デフォルトでは、25% が使用されます。

例: これが 30% に設定されている場合は、ローリング更新が開始されるとすぐに古い RC を 30% 縮小できます。新しい Pod の準備ができたら、古い RC をさらにスケールダウンしてから、新しい RC をスケールアップして、更新中に常に元の Pod 数の 70% 以上を使用できるようにします。

post

object

LifecycleHook は、特定のデプロイメントライフサイクルアクションを定義します。一度に指定できるアクションのタイプは 1 つだけです。

pre

object

LifecycleHook は、特定のデプロイメントライフサイクルアクションを定義します。一度に指定できるアクションのタイプは 1 つだけです。

timeoutSeconds

integer

TimeoutSeconds は、更新を待ってからあきらめるまでの時間です。値が nil の場合は、デフォルトが使用されます。

updatePeriodSeconds

integer

UpdatePeriodSeconds は、個々の Pod の更新の間に待機する時間です。値が nil の場合は、デフォルトが使用されます。

execNewPod

object

ExecNewPodHook は、デプロイメントテンプレートの一部であると想定される指定されたコンテナーに基づいて、新しい Pod でコマンドを実行するフック実装です。

failurePolicy

string

FailurePolicy は、フックが失敗した場合に実行するアクションを指定します。

tagImages

array

TagImages は、コンテナーの下で参照されている現在のイメージをイメージストリームタグにタグ付けするようにデプロイヤ－に指示します。

tagImages[]

object

TagImageHook は、特定のコンテナー内のイメージを ImageStreamTag にタグ付けするリクエストです。

command

array (string)

コマンドは、アクションコマンドおよびその引数です。

containerName

string

ContainerName は、デプロイメント Pod テンプレート内のコンテナーの名前であり、そのコンテナーイメージはフック Pod のコンテナーに使用されます。

env

array (EnvVar)

Env は、フック Pod のコンテナーに提供する環境変数のセットです。

volumes

array (string)

ボリュームは、フック Pod にコピーする必要がある Pod テンプレートからの名前付きボリュームのリストです。Pod 仕様にないボリューム名は無視されます。空のリストは、ボリュームがコピーされないことを意味します。

containerName

string

ContainerName は、イメージ値がタグのソースとして使用されるデプロイメント設定内のコンテナーの名前です。コンテナーが 1 つしかない場合、この値はデフォルトでそのコンテナーの名前になります。

to

ObjectReference

To は、コンテナーのイメージを設定するターゲット ImageStreamTag です。

execNewPod

object

ExecNewPodHook は、デプロイメントテンプレートの一部であると想定される指定されたコンテナーに基づいて、新しい Pod でコマンドを実行するフック実装です。

failurePolicy

string

FailurePolicy は、フックが失敗した場合に実行するアクションを指定します。

tagImages

array

TagImages は、コンテナーの下で参照されている現在のイメージをイメージストリームタグにタグ付けするようにデプロイヤ－に指示します。

tagImages[]

object

TagImageHook は、特定のコンテナー内のイメージを ImageStreamTag にタグ付けするリクエストです。

command

array (string)

コマンドは、アクションコマンドおよびその引数です。

containerName

string

ContainerName は、デプロイメント Pod テンプレート内のコンテナーの名前であり、そのコンテナーイメージはフック Pod のコンテナーに使用されます。

env

array (EnvVar)

Env は、フック Pod のコンテナーに提供する環境変数のセットです。

volumes

array (string)

ボリュームは、フック Pod にコピーする必要がある Pod テンプレートからの名前付きボリュームのリストです。Pod 仕様にないボリューム名は無視されます。空のリストは、ボリュームがコピーされないことを意味します。

containerName

string

ContainerName は、イメージ値がタグのソースとして使用されるデプロイメント設定内のコンテナーの名前です。コンテナーが 1 つしかない場合、この値はデフォルトでそのコンテナーの名前になります。

to

ObjectReference

To は、コンテナーのイメージを設定するターゲット ImageStreamTag です。

imageChangeParams

object

DeploymentTriggerImageChangeParams は、ImageChange トリガーへのパラメーターを表します。

type

string

トリガーの種類

自動

boolean

自動とは、新しいタグ値を検出すると、Pod テンプレート内のイメージが更新されることを意味します。

containerNames

array (string)

ContainerNames は、タグの更新を Pod 内の指定されたコンテナー名のセットに制限するために使用されます。複数のトリガーが同じコンテナーを指している場合、結果の動作は未定義です。将来の API バージョンでは、これは検証エラーになります。ContainerNames が有効なコンテナーを指していない場合、トリガーは無視されます。将来の API バージョンでは、これは検証エラーになります。

from

ObjectReference

From は、変更を監視するためのイメージストリームタグへの参照です。From.Name が唯一の必須サブフィールドです。- From.Namespace が空白の場合、現在のデプロイメントトリガーの namespace が使用されます。

lastTriggeredImage

string

LastTriggeredImage は、トリガーされる最後のイメージです。

availableReplicas

integer

AvailableReplicas は、このデプロイメント設定の対象となる使用可能な Pod の総数です。

conditions

array

条件は、デプロイメント設定の現在の状態について利用可能な最新の観測値を表します。

conditions[]

object

DeploymentCondition は、特定の時点でのデプロイメント設定の状態を記述します。

詳細

object

DeploymentDetails は、デプロイメントの原因に関する情報をキャプチャーします。

latestVersion

integer

LatestVersion は、デプロイメント設定に関連付けられている現在のデプロイメントが同期していないかどうかを判別するのに使用されます。

observedGeneration

integer

ObservedGeneration は、デプロイメント設定コントローラーによって観察された最新の世代です。

readyReplicas

integer

このデプロイメントの対象となる準備ができている Pod の総数。

replicas

integer

レプリカは、このデプロイメント設定の対象となる Pod の総数です。

unavailableReplicas

integer

UnavailableReplicas は、このデプロイメント設定の対象となる使用できない Pod の総数です。

updatedReplicas

integer

UpdatedReplicas は、目的のテンプレート仕様を持つ、このデプロイメント設定の対象となる非終了 Pod の総数です。

lastTransitionTime

time

最後にある状態から別の状態に遷移した時間。

lastUpdateTime

time

この状態が最後に更新された時刻。

message

string

遷移の詳細を示す人が判読できるメッセージ。

reason

string

条件の最後の遷移の理由。

status

string

状態のステータス、True、False、Unknown のいずれか。

type

string

デプロイメント条件のタイプ。

causes

array

原因は、新しいデプロイメントを作成するためのすべての原因に関連付けられた拡張データです

causes[]

object

DeploymentCause は、デプロイメントの特定の原因に関する情報をキャプチャーします。

message

string

このデプロイメントがユーザーによって手動でトリガーされた場合、メッセージはユーザー指定の変更メッセージです

imageTrigger

object

DeploymentCauseImageTrigger は、イメージ変更トリガーに起因するデプロイメントの原因に関する詳細を表します

type

string

新しいデプロイメントの作成につながったトリガーのタイプ

from

ObjectReference

From は、デプロイメントをトリガーした変更されたオブジェクトへの参照です。フィールドには、DockerImage、ImageStreamTag、または ImageStreamImage の種類があります。