在庫および有望サービス グループの共通サーバー プロパティ

グループ名、レプリカ数、リソース、その他のサーバープロパティなどのプロパティを使用して、 IVServiceGroupそしてPromisingServiceGroup

以下の表で、サーバーの共通プロパティーについて説明します。
プロパティー デフォルト値 値タイプ 必須 説明
active はい ブール値 いいえ このフラグは、デフォルトでは true に設定され、サーバーまたはサーバーのグループを活動化します。 非アクティブ化するには、 falseに設定します。 無効化の詳細については、アクティブサーバーを非アクティブ化する
affinityAndTolerations ストリング いいえ SIPEnvironmentで定義されている affinityAndTolerations の名前を使用します。 デフォルトでは、サーバーで定義されている affinityAndTolerations が、個々のサービス・グループで定義されている affinityAndTolerations よりも優先されます。
horizontalPodAutoscaler ストリング いいえ 使用する定義済みの Horizontal Pod Autoscaler の名前を指定します。 詳しくは、 horizontalPodAutoscalers パラメータを参照。
image.tag   ストリング いいえ このプロパティを指定して、個々のサーバーの画像タグを定義します。 設定されていない場合、サービスグループまたはグローバル設定のSIPEnvironmentで定義されているタグが使用される。 これにより、各サーバーインスタンスで使用されるイメージバージョンを正確に制御することができます。
image.pullPolicy   ストリング いいえ このプロパティを指定して、個々のサーバーの画像プルポリシーを定義します。 それが設定されていない場合、SIPEnvironmentのサービスグループまたはグローバルコンフィギュレーションで定義されたポリシーが使用される。 これはサーバーインスタンスの画像プル動作を制御します。
logLevel INFO 整数 いいえ 個々のサーバー・レベルでログ・レベルを上書きするには、このプロパティを指定します。 利用可能なオプションは OFF, FATAL, ERROR, WARN, INFO, DEBUG, TRACE, ALL です。 個々のサーバーレベルで設定されていない場合、サービスグループレベルで定義されているログレベルが使用されます。 サービスグループのログレベルも定義されていない場合、SIPEnvironmentのグローバル設定が使用される。 これらのいずれも設定されていない場合、デフォルトのログレベルはINFOとなります。 これにより、各サーバーインスタンスのロギングをカスタマイズして制御できる。
groupName グループ名は、サーバーごとに事前定義されています。 ストリング はい これは、サービスに含まれるサーバー (アプリケーション・サーバー、バックエンド・サーバー、または logstash サーバー) のグループ名です。 必要に応じてグループ名を変更できます。

Kubernetesでは、ラベル値の文字数制限が63文字であるため、長いリソース名でデプロイエラーが発生することが多い。 エラーを回避するために、グループ名を使用して配置を識別することで、柔軟で整 理された配置管理が可能になります。 詳しくは、長いリソース名によるエラーを回避するためのグループ名の使用を参照してください。

pod.podAnnotations   オブジェクト いいえ ポッドまたはデプロイメントに関する追加のアノテーションを、キーと値のペアとして指定します。
pod.podLabels   オブジェクト いいえ ポッドまたはデプロイメントの追加ラベルをキーと値のペアで指定します。
覚えておいてください: 以下の3つのラベルは、オペレーターが内部的に使用するものであるため、上書きしないでください。
  • app
  • type
  • internal.sip.ibm.com/apps
names   アレイ はい これは、サービスに組み込まれているサーバーの名前のリストです。 約束の場合、このプロパティーは単一のアプリケーション・サーバーにのみ適用されます。 バックエンド・サーバーの場合、これはスレッド数を持つサーバーのリストです。
replicaCount dev の場合: 1

実動の場合: 2

整数 いいえ サーバーのレプリカの数を指定します。
resources 開発の場合:
制限:
CPU= 1
メモリー = 1536Mi
要求:
CPU= 100m
メモリー = 1Gi
実動の場合、クラスター構成に基づいて CPU とメモリーの制限と要求を指定します。
  いいえ サーバーの CPU およびメモリーのリソース要求と制限を指定します。
property.envVars ストリング いいえ 属性 serverProperties.envVars[].groupName または serverProperties.envVars[].derivatives[].groupNameの envVars の名前を使用します。
property.jvmArgs ストリング いいえ 属性 serverProperties.jvmArgs[].groupName または serverProperties.jvmArgs[].derivatives[].groupNameの jvmArgs の名前を使用します。
topology アレイ いいえ サーバーに使用するTopology Spread Constraintsの名前を指定する。 例えば、 topology: [constraint1, constraint2]

サーバーまたはジョブで定義されたトポロジーは、個々のサービスグループで定義されたものよりも優先されます。

詳細については、 サーバーからTopology Spread Constraintsを呼び出す例を参照してください。

職種固有のプロパティ

プロパティー デフォルト値 値タイプ 必須 説明
name   アレイ はい サービスに含まれる仕事名のリストである。
affinityAndTolerations ストリング いいえ SIPEnvironmentで定義されている affinityAndTolerations の名前を使用します。 デフォルトでは、サーバーで定義されている affinityAndTolerations が、個々のサービス・グループで定義されている affinityAndTolerations よりも優先されます。
horizontalPodAutoscaler   ストリング いいえ 使用する定義済みの Horizontal Pod Autoscaler の名前を指定します。 詳細については、 horizontalPodAutoscalers パラメータを参照してください。
logLevel INFO 整数 いいえ 個々のサーバー・レベルでログ・レベルを上書きするには、このプロパティを指定します。 利用可能なオプションは OFF, FATAL, ERROR, WARN, INFO, DEBUG, TRACE, ALL です。 個々のサーバーレベルで設定されていない場合、サービスグループレベルで定義されているログレベルが使用されます。 サービスグループのログレベルも定義されていない場合、SIPEnvironmentのグローバル設定が使用される。 これらのいずれも設定されていない場合、デフォルトのログレベルはINFOとなります。 これにより、各サーバーインスタンスのロギングをカスタマイズして制御できる。
jobBackoffLimit 4 整数 いいえ 連続したポッドの失敗の後、ジョブを失敗としてマークするまでの再試行回数を指定します。
pod.podAnnotations   オブジェクト いいえ ポッドまたはデプロイメントに関する追加のアノテーションを、キーと値のペアとして指定します。
pod.podLabels   オブジェクト いいえ ポッドまたはデプロイメントの追加ラベルをキーと値のペアで指定します。
覚えておいてください: 以下の3つのラベルは、オペレーターが内部的に使用するものであるため、上書きしないでください。
  • app
  • type
  • internal.sip.ibm.com/apps
resources 開発の場合:
制限:
CPU= 1
メモリー = 1536Mi
要求:
CPU= 100m
メモリー = 1Gi
実動の場合、クラスター構成に基づいて CPU とメモリーの制限と要求を指定します。
  いいえ サーバーの CPU およびメモリーのリソース要求と制限を指定します。
property.envVars ストリング いいえ 属性 serverProperties.envVars[].groupName または serverProperties.envVars[].derivatives[].groupNameの envVars の名前を使用します。
property.jvmArgs ストリング いいえ 属性 serverProperties.jvmArgs[].groupName または serverProperties.jvmArgs[].derivatives[].groupNameの jvmArgs の名前を使用します。
topology アレイ いいえ サーバーに使用するTopology Spread Constraintsの名前を指定する。 例えば、 topology: [constraint1, constraint2]

サーバーまたはジョブで定義されたトポロジーは、個々のサービスグループで定義されたものよりも優先されます。

詳細については、 サーバーからTopology Spread Constraintsを呼び出す例を参照してください。

アクティブ・サーバーの非アクティブ化

active フラグを false に変更してアクティブ・サーバーを非アクティブ化し、そのサーバーに関連付けられているデプロイメントが削除されるようにします。 サーバーをグループ化する場合は、 active フラグを使用してグループ全体を非アクティブ化します。

長いリソース名によるエラーを避けるためにグループ名を使用する

ラベルやセレクタに「metadata.labels」や「spec.selector.matchLabels」など、63 文字の制限を超える可能性のある長い配置名を直接使用する代わりに、配置を表す簡潔なグループ名を割り当てます。 このアプローチにより、ラベル管理がよりシンプルになり、グループ内で特定の配備コンフィギュレーションが整理される。

例:
promisingServiceGroup:
  - active: true
    groupName: <deployment-name>
    names:
      - "iv-supply-breakup-snapshot-source-stream-flatten:4"
    replicaCount: 4