第21章 MachineConfiguration [operator.openshift.io/v1]

failedRevisionLimit

integer

failedRevisionLimit は、ディスク上に保持するために失敗した静的 Pod インストーラーリビジョンの数であり、API では -1 =無制限、0 または未設定= 5(デフォルト)

forceRedeploymentReason

string

forceRedeploymentReason を使用すると、一意の文字列を指定して、オペランドの再デプロイを強制できます。これにより、以前に失敗したデプロイメントを開始するメカニズムが提供され、同じ設定で再度失敗するのではなく、今回は機能すると思われる理由が提供されます。

logLevel

string

logLevel は、コンポーネント全体のインテントベースのログです。きめ細かい制御はできませんが、Operator がオペランドに対して解釈する必要のある粗いロギングの選択を管理する簡単な方法です。有効な値は、"Normal"、"Debug"、"Trace"、"TraceAll" です。Defaults to "Normal".

managedBootImages

object

managedBootImages を使用すると、クラスター内にあるマシンリソースのブートイメージの管理を設定できます。これを設定すると、クラスターのアップグレード中に最新のブートイメージに更新する必要があるリソースをユーザーが選択できるため、新しいマシンを常に現在のクラスターバージョンのブートイメージで起動できるようになります。省略すると、ブートイメージは更新されません。

managementState

string

managementState は、Operator がコンポーネントを管理する必要があるかどうか、およびその方法を示します

nodeDisruptionPolicy

object

nodeDisruptionPolicy を使用すると、管理者は、ドレイン、サービスのリロードなど、MachineConfig ベースの更新に対する詳細なノード停止アクションを設定できます。これを指定すると、クラスターに対して軽微な設定更新を実行するときのダウンタイムが短縮されます。これを設定しても、クラスターのアップグレードには影響しませんが、必要な場合にはノードが停止されます。

observedConfig

``

observedConfig は、コントローラーがクラスター状態から監視したスパース設定を保持します。Operator のレベルへの入力であるため、仕様に存在します

operatorLogLevel

string

operatorLogLevel は、Operator 自体のインテントベースのログです。きめ細かい制御はできませんが、Operator が自分で解釈しなければならない粗いロギングの選択を管理する簡単な方法です。有効な値は、"Normal"、"Debug"、"Trace"、"TraceAll" です。Defaults to "Normal".

succeededRevisionLimit

integer

successedRevisionLimit は、ディスク上に保持する成功した静的 Pod インストーラーリビジョンの数であり、API では -1 =無制限、0 または未設定= 5(デフォルト)

unsupportedConfigOverrides

``

unsupportedConfigOverrides は、Operator によって計算された最終設定をオーバーライドします。Red Hat はこのフィールドの使用をサポートしていません。このフィールドを誤って使用すると、予期しない動作が発生したり、他の設定オプションと競合したりする可能性があります。このフィールドを使用する前に、Red Hat サポートに問い合わせてください。このプロパティーを使用すると、クラスターのアップグレードがブロックされます。クラスターをアップグレードする前に、このプロパティーを削除する必要があります。

machineManagers

array

machineManagers は、ブートイメージの更新用のマシン管理リソースを登録するために使用できます。Machine Config Operator がこのリストの変更を監視します。マシン管理リソースの種類ごとに 1 つのエントリーのみが許可されます。

machineManagers[]

object

MachineManager は、ブートイメージの更新用に登録されているターゲットマシンリソースを表します。リソースのタイプやリソースの API グループなどの識別情報を格納します。また、選択フィールドを介して詳細な制御も提供します。

apiGroup

string

apiGroup は、マシン管理リソースが属する APIGroup の名前です。現在有効な値は machine.openshift.io のみです。machine.openshift.io の場合、マシンマネージャーによって、OpenShift machine API グループに属するリソースだけが登録されます。

resource

string

resource は、マシン管理リソースのタイプです。現在有効な値は machinesets のみです。machinesets の場合、マシンマネージャーによって、種類が MachineSet のリソースだけが登録されます。

selection

object

selection を使用すると、ブートイメージの更新用に登録するマシン管理リソースを細かく制御できます。

mode

string

mode は、更新用のマシンマネージャーを選択する方法を決定します。有効な値は All と Partial です。All の場合、マシンマネージャーによって照合されたすべてのリソースが更新されます。Partial の場合、セレクターの指定が必要であり、マシンマネージャーで照合されたリソースのうち、どのリソースを更新するかをカスタマイズできます。

partial

object

partial は、マシン管理リソースを照合するために使用できるラベルセレクターを指定します。mode が "Partial" に設定されている場合にのみ許可されます。

machineResourceSelector

object

machineResourceSelector は、MachineSets などのマシンリソースを選択するために使用できるラベルセレクターです。

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

値

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

files

array

files は、MachineConfig ファイルの定義と、そのパスの変更に対して実行するアクションのリストです。このリストは最大 50 個のエントリーをサポートしています。

files[]

object

NodeDisruptionPolicySpecFile は、ファイルのエントリーとそれに対応するアクションであり、NodeDisruptionPolicyConfig オブジェクトで使用されます。

sshkey

object

sshkey は、MachineConfig オブジェクトの ignition.sshkeys フィールドにマップされます。これに対する定義とアクションは、クラスター内のすべて sshkey の変更に適用されます。

units

array

units は、MachineConfig ユニットの定義と、そのサービスの変更時に実行するアクションのリストです。このリストは最大 50 個のエントリーをサポートしています。

units[]

object

NodeDisruptionPolicySpecUnit は、systemd ユニット名とそれに対応するアクションであり、NodeDisruptionPolicyConfig オブジェクトで使用されます。

actions

array

actions は、対応するファイルパスにあるファイルへの変更時に実行する一連のコマンドを表します。アクションは、このリストに設定されている順序で適用されます。同じ更新内の他の MachineConfig エントリーに、再起動を必要とするその他の変更がある場合、これらのアクションよりも再起動が優先されます。有効なアクションは、Reboot、Drain、Reload、DaemonReload、None です。Reboot アクションと None アクションは、他のアクションと組み合わせて使用できません。このリストは最大 10 個のエントリーをサポートします。

actions[]

object

path

string

path は、MachineConfig を通じて管理されるファイルの場所です。ポリシー内のアクションは、このパスにあるファイルへの変更に対して適用されます。

reload

object

reload は、リロードするサービスを指定します。type が reload の場合にのみ有効です。

restart

object

restart は、再起動するサービスを指定します。type が restart の場合にのみ有効です。

type

string

type は、この NodeDisruptionPolicySpecActionType が実行された場合に実行されるコマンドを表します。有効な値は、Reboot、Drain、Reload、Restart、DaemonReload、および None です。Reload/Restart には、対応するサービスターゲットを reload/restart フィールドで指定する必要があります。その他の値には、追加の設定は必要ありません。

serviceName

string

serviceName は、リロードするサービスの完全な名前 (例: crio.service) です。サービス名は、${NAME}${SERVICETYPE} の形式で、最大 255 文字の長さにすることができます。${NAME} は、1 文字以上の長さで、アルファベット、数字、":"、"-"、"_"、"."、"\" のみで構成する必要があります。${SERVICETYPE} は、".service"、".socket"、".device"、".mount"、".automount"、".swap"、".target"、".path"、".timer"、".snapshot"、".slice"、".scope" のいずれかである必要があります。

serviceName

string

serviceName は、再起動するサービスの完全な名前 (例: crio.service) です。サービス名は、${NAME}${SERVICETYPE} の形式で、最大 255 文字の長さにすることができます。${NAME} は、1 文字以上の長さで、アルファベット、数字、":"、"-"、"_"、"."、"\" のみで構成する必要があります。${SERVICETYPE} は、".service"、".socket"、".device"、".mount"、".automount"、".swap"、".target"、".path"、".timer"、".snapshot"、".slice"、".scope" のいずれかである必要があります。

actions

array

actions は、対応するファイルパスにあるファイルへの変更時に実行する一連のコマンドを表します。アクションは、このリストに設定されている順序で適用されます。同じ更新内の他の MachineConfig エントリーに、再起動を必要とするその他の変更がある場合、これらのアクションよりも再起動が優先されます。有効なアクションは、Reboot、Drain、Reload、DaemonReload、None です。Reboot アクションと None アクションは、他のアクションと組み合わせて使用できません。このリストは最大 10 個のエントリーをサポートします。

actions[]

object

reload

object

reload は、リロードするサービスを指定します。type が reload の場合にのみ有効です。

restart

object

restart は、再起動するサービスを指定します。type が restart の場合にのみ有効です。

type

string

type は、この NodeDisruptionPolicySpecActionType が実行された場合に実行されるコマンドを表します。有効な値は、Reboot、Drain、Reload、Restart、DaemonReload、および None です。Reload/Restart には、対応するサービスターゲットを reload/restart フィールドで指定する必要があります。その他の値には、追加の設定は必要ありません。

serviceName

string

serviceName は、リロードするサービスの完全な名前 (例: crio.service) です。サービス名は、${NAME}${SERVICETYPE} の形式で、最大 255 文字の長さにすることができます。${NAME} は、1 文字以上の長さで、アルファベット、数字、":"、"-"、"_"、"."、"\" のみで構成する必要があります。${SERVICETYPE} は、".service"、".socket"、".device"、".mount"、".automount"、".swap"、".target"、".path"、".timer"、".snapshot"、".slice"、".scope" のいずれかである必要があります。

serviceName

string

serviceName は、再起動するサービスの完全な名前 (例: crio.service) です。サービス名は、${NAME}${SERVICETYPE} の形式で、最大 255 文字の長さにすることができます。${NAME} は、1 文字以上の長さで、アルファベット、数字、":"、"-"、"_"、"."、"\" のみで構成する必要があります。${SERVICETYPE} は、".service"、".socket"、".device"、".mount"、".automount"、".swap"、".target"、".path"、".timer"、".snapshot"、".slice"、".scope" のいずれかである必要があります。

actions

array

actions は、対応するファイルパスにあるファイルへの変更時に実行する一連のコマンドを表します。アクションは、このリストに設定されている順序で適用されます。同じ更新内の他の MachineConfig エントリーに、再起動を必要とするその他の変更がある場合、これらのアクションよりも再起動が優先されます。有効なアクションは、Reboot、Drain、Reload、DaemonReload、None です。Reboot アクションと None アクションは、他のアクションと組み合わせて使用できません。このリストは最大 10 個のエントリーをサポートします。

actions[]

object

name

string

name は、MachineConfig を通じて管理される systemd サービスのサービス名を表します。指定されたアクションが、名前付きサービスへの変更に適用されます。サービス名は、${NAME}${SERVICETYPE} の形式で、最大 255 文字の長さにすることができます。${NAME} は、1 文字以上の長さで、アルファベット、数字、":"、"-"、"_"、"."、"\" のみで構成する必要があります。${SERVICETYPE} は、".service"、".socket"、".device"、".mount"、".automount"、".swap"、".target"、".path"、".timer"、".snapshot"、".slice"、".scope" のいずれかである必要があります。

reload

object

reload は、リロードするサービスを指定します。type が reload の場合にのみ有効です。

restart

object

restart は、再起動するサービスを指定します。type が restart の場合にのみ有効です。

type

string

type は、この NodeDisruptionPolicySpecActionType が実行された場合に実行されるコマンドを表します。有効な値は、Reboot、Drain、Reload、Restart、DaemonReload、および None です。Reload/Restart には、対応するサービスターゲットを reload/restart フィールドで指定する必要があります。その他の値には、追加の設定は必要ありません。

serviceName

string

serviceName は、リロードするサービスの完全な名前 (例: crio.service) です。サービス名は、${NAME}${SERVICETYPE} の形式で、最大 255 文字の長さにすることができます。${NAME} は、1 文字以上の長さで、アルファベット、数字、":"、"-"、"_"、"."、"\" のみで構成する必要があります。${SERVICETYPE} は、".service"、".socket"、".device"、".mount"、".automount"、".swap"、".target"、".path"、".timer"、".snapshot"、".slice"、".scope" のいずれかである必要があります。

serviceName

string

serviceName は、再起動するサービスの完全な名前 (例: crio.service) です。サービス名は、${NAME}${SERVICETYPE} の形式で、最大 255 文字の長さにすることができます。${NAME} は、1 文字以上の長さで、アルファベット、数字、":"、"-"、"_"、"."、"\" のみで構成する必要があります。${SERVICETYPE} は、".service"、".socket"、".device"、".mount"、".automount"、".swap"、".target"、".path"、".timer"、".snapshot"、".slice"、".scope" のいずれかである必要があります。

conditions

array

conditions は、状態とそのステータスのリストです。

conditions[]

object

条件には、この API リソースの現在の状態の 1 つの側面の詳細が含まれています。--- この構造体は、フィールドパスの .status.conditions で配列として直接使用することを目的としています。たとえば、次のように入力します。FooStatus struct{ // Represents the observations of a foo’s current state. // Known .status.conditions.type are: "Available", "Progressing", and "Degraded" // +patchMergeKey=type // +patchStrategy=merge // +listType=map // +listMapKey=type Conditions []metav1.Condition json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type" protobuf:"bytes,1,rep,name=conditions" // other fields }

nodeDisruptionPolicyStatus

object

nodeDisruptionPolicyStatus ステータスは、クラスターによって検証された最新のポリシーを反映し、将来のノード更新時に Machine Config Daemon によって使用されます。

observedGeneration

integer

observedGeneration はあなたが扱った最後の世代の変更です

lastTransitionTime

string

lastTransitionTime は、ある状態から別の状態に最後に遷移した時間です。これは、基本的な条件が変更された時点となります。不明な場合には、API フィールドが変更された時点を使用することも可能です。

message

string

message は、遷移の詳細を示す人が判読できるメッセージです。空の文字列の場合もあります。

observedGeneration

integer

observedGeneration は、それをベースに条件が設定された .metadata.generation を表します。たとえば、.metadata.generation が現在 12 で、.status.conditions[x].observedGeneration が 9 の場合、インスタンスの現在の状態に対して条件が古くなっています。

reason

string

reason には、条件の最後の遷移の理由を示すプログラムによる識別子が含まれます。特定の条件タイプのプロデューサーは、このフィールドの期待値と意味、および値が保証された API と見なされるかどうかを定義できます。値は CamelCase 文字列である必要があります。このフィールドには空白を指定できません。

status

string

条件のステータス、True、False、Unknown のいずれか。

type

string

CamelCase または foo.example.com/CamelCase の条件のタイプ。--- 多くの.condition.type 値は、Available などのリソース全体で一貫していますが、任意の条件が役立つ可能性があるため (.node.status.conditions を参照)、競合を解消する機能が重要です。一致する正規表現は (dns1123SubdomainFmt/)?(qualifiedNameFmt) です。

clusterPolicies

object

clusterPolicies は、クラスターのデフォルトとユーザーが提供するノード停止ポリシーを統合したものです。

files

array

files は、MachineConfig ファイルの定義と、そのパスの変更に対して実行するアクションのリストです。

files[]

object

NodeDisruptionPolicyStatusFile は、ファイルのエントリーとそれに対応するアクションであり、NodeDisruptionPolicyClusterStatus オブジェクトで使用されます。

sshkey

object

sshkey は、全体的な sshkey MachineConfig の定義です。

units

array

units は、MachineConfig ユニットの定義と、そのサービスの変更時に実行するアクションのリストです。

units[]

object

NodeDisruptionPolicyStatusUnit は、systemd ユニット名とそれに対応するアクションであり、NodeDisruptionPolicyClusterStatus オブジェクトで使用されます。

actions

array

actions は、対応するファイルパスにあるファイルへの変更時に実行する一連のコマンドを表します。アクションは、このリストに設定されている順序で適用されます。同じ更新内の他の MachineConfig エントリーに、再起動を必要とするその他の変更がある場合、これらのアクションよりも再起動が優先されます。有効なアクションは、Reboot、Drain、Reload、DaemonReload、None です。Reboot アクションと None アクションは、他のアクションと組み合わせて使用できません。このリストは最大 10 個のエントリーをサポートします。

actions[]

object

path

string

path は、MachineConfig を通じて管理されるファイルの場所です。ポリシー内のアクションは、このパスにあるファイルへの変更に対して適用されます。

reload

object

reload は、リロードするサービスを指定します。type が reload の場合にのみ有効です。

restart

object

restart は、再起動するサービスを指定します。type が restart の場合にのみ有効です。

type

string

type は、この NodeDisruptionPolicyStatusActionType が実行された場合に実行されるコマンドを表します。有効な値は、Reboot、Drain、Reload、Restart、DaemonReload、None、および Special です。Reload/Restart には、対応するサービスターゲットを reload/restart フィールドで指定する必要があります。その他の値には、追加の設定は必要ありません。

serviceName

string

serviceName は、リロードするサービスの完全な名前 (例: crio.service) です。サービス名は、${NAME}${SERVICETYPE} の形式で、最大 255 文字の長さにすることができます。${NAME} は、1 文字以上の長さで、アルファベット、数字、":"、"-"、"_"、"."、"\" のみで構成する必要があります。${SERVICETYPE} は、".service"、".socket"、".device"、".mount"、".automount"、".swap"、".target"、".path"、".timer"、".snapshot"、".slice"、".scope" のいずれかである必要があります。

serviceName

string

serviceName は、再起動するサービスの完全な名前 (例: crio.service) です。サービス名は、${NAME}${SERVICETYPE} の形式で、最大 255 文字の長さにすることができます。${NAME} は、1 文字以上の長さで、アルファベット、数字、":"、"-"、"_"、"."、"\" のみで構成する必要があります。${SERVICETYPE} は、".service"、".socket"、".device"、".mount"、".automount"、".swap"、".target"、".path"、".timer"、".snapshot"、".slice"、".scope" のいずれかである必要があります。

actions

array

actions は、対応するファイルパスにあるファイルへの変更時に実行する一連のコマンドを表します。アクションは、このリストに設定されている順序で適用されます。同じ更新内の他の MachineConfig エントリーに、再起動を必要とするその他の変更がある場合、これらのアクションよりも再起動が優先されます。有効なアクションは、Reboot、Drain、Reload、DaemonReload、None です。Reboot アクションと None アクションは、他のアクションと組み合わせて使用できません。このリストは最大 10 個のエントリーをサポートします。

actions[]

object

reload

object

reload は、リロードするサービスを指定します。type が reload の場合にのみ有効です。

restart

object

restart は、再起動するサービスを指定します。type が restart の場合にのみ有効です。

type

string

type は、この NodeDisruptionPolicyStatusActionType が実行された場合に実行されるコマンドを表します。有効な値は、Reboot、Drain、Reload、Restart、DaemonReload、None、および Special です。Reload/Restart には、対応するサービスターゲットを reload/restart フィールドで指定する必要があります。その他の値には、追加の設定は必要ありません。

serviceName

string

serviceName は、リロードするサービスの完全な名前 (例: crio.service) です。サービス名は、${NAME}${SERVICETYPE} の形式で、最大 255 文字の長さにすることができます。${NAME} は、1 文字以上の長さで、アルファベット、数字、":"、"-"、"_"、"."、"\" のみで構成する必要があります。${SERVICETYPE} は、".service"、".socket"、".device"、".mount"、".automount"、".swap"、".target"、".path"、".timer"、".snapshot"、".slice"、".scope" のいずれかである必要があります。

serviceName

string

serviceName は、再起動するサービスの完全な名前 (例: crio.service) です。サービス名は、${NAME}${SERVICETYPE} の形式で、最大 255 文字の長さにすることができます。${NAME} は、1 文字以上の長さで、アルファベット、数字、":"、"-"、"_"、"."、"\" のみで構成する必要があります。${SERVICETYPE} は、".service"、".socket"、".device"、".mount"、".automount"、".swap"、".target"、".path"、".timer"、".snapshot"、".slice"、".scope" のいずれかである必要があります。

actions

array

actions は、対応するファイルパスにあるファイルへの変更時に実行する一連のコマンドを表します。アクションは、このリストに設定されている順序で適用されます。同じ更新内の他の MachineConfig エントリーに、再起動を必要とするその他の変更がある場合、これらのアクションよりも再起動が優先されます。有効なアクションは、Reboot、Drain、Reload、DaemonReload、None です。Reboot アクションと None アクションは、他のアクションと組み合わせて使用できません。このリストは最大 10 個のエントリーをサポートします。

actions[]

object

name

string

name は、MachineConfig を通じて管理される systemd サービスのサービス名を表します。指定されたアクションが、名前付きサービスへの変更に適用されます。サービス名は、${NAME}${SERVICETYPE} の形式で、最大 255 文字の長さにすることができます。${NAME} は、1 文字以上の長さで、アルファベット、数字、":"、"-"、"_"、"."、"\" のみで構成する必要があります。${SERVICETYPE} は、".service"、".socket"、".device"、".mount"、".automount"、".swap"、".target"、".path"、".timer"、".snapshot"、".slice"、".scope" のいずれかである必要があります。

reload

object

reload は、リロードするサービスを指定します。type が reload の場合にのみ有効です。

restart

object

restart は、再起動するサービスを指定します。type が restart の場合にのみ有効です。

type

string

type は、この NodeDisruptionPolicyStatusActionType が実行された場合に実行されるコマンドを表します。有効な値は、Reboot、Drain、Reload、Restart、DaemonReload、None、および Special です。Reload/Restart には、対応するサービスターゲットを reload/restart フィールドで指定する必要があります。その他の値には、追加の設定は必要ありません。

serviceName

string

serviceName は、リロードするサービスの完全な名前 (例: crio.service) です。サービス名は、${NAME}${SERVICETYPE} の形式で、最大 255 文字の長さにすることができます。${NAME} は、1 文字以上の長さで、アルファベット、数字、":"、"-"、"_"、"."、"\" のみで構成する必要があります。${SERVICETYPE} は、".service"、".socket"、".device"、".mount"、".automount"、".swap"、".target"、".path"、".timer"、".snapshot"、".slice"、".scope" のいずれかである必要があります。

serviceName

string

serviceName は、再起動するサービスの完全な名前 (例: crio.service) です。サービス名は、${NAME}${SERVICETYPE} の形式で、最大 255 文字の長さにすることができます。${NAME} は、1 文字以上の長さで、アルファベット、数字、":"、"-"、"_"、"."、"\" のみで構成する必要があります。${SERVICETYPE} は、".service"、".socket"、".device"、".mount"、".automount"、".swap"、".target"、".path"、".timer"、".snapshot"、".slice"、".scope" のいずれかである必要があります。