Enterprise Distributed Application Service:Kubernetes クラスターで toolkit-maven-plugin を使用してカナリアリリースを実行する

ヘルスチェック

liveness プローブと readiness プローブを設定して、コンテナとアプリケーションのヘルス状態をモニターします。各プローブに対して exec、tcpSocket、または httpGet のいずれかを指定します。

liveness チェックに失敗したコンテナは再起動されます。readiness チェックに複数回失敗したコンテナは停止してから再起動され、Server Load Balancer (SLB) インスタンスからのトラフィックを受信しなくなります。

  liveness:
    exec:
      command:
        - cat
        - /tmp/healthy
    tcpSocket:
      host: "192.168.1.109"  # (任意) デフォルトは Pod の IP アドレス
      port: "8080"
    httpGet:
      path: "/health"
      port: "8080"
      host: "192.168.1.109"  # (任意) デフォルトは Pod の IP アドレス
      scheme: "HTTP"       # HTTP または HTTPS
      httpHeaders:
        - name: "Custom-Header"
          value: "value"
    initialDelaySeconds: 5   # 最初のチェックまでの秒数
    timeoutSeconds: 11       # チェックがタイムアウトするまでの秒数
    periodSeconds: 5         # チェック間の秒数
    successThreshold: 1      # liveness プローブでは 1 である必要があります
    failureThreshold: 3      # アクションが実行されるまでの連続失敗回数

  readiness:
    exec:
      command:
        - cat
        - /tmp/healthy
    tcpSocket:
      host: "192.168.1.109"  # (任意) デフォルトは Pod の IP アドレス
      port: "8080"
    httpGet:
      path: "/health"
      port: "8080"
      host: "192.168.1.109"  # (任意) デフォルトは Pod の IP アドレス
      scheme: "HTTP"
      httpHeaders:
        - name: "Custom-Header"
          value: "value"
    initialDelaySeconds: 5
    timeoutSeconds: 11
    periodSeconds: 5
    successThreshold: 2
    failureThreshold: 3

ライフサイクルフック

  preStop:          # コンテナが終了する前に実行
    exec:
      command:
        - /bin/bash
        - -c
        - "sleep 30"
    httpGet:
      host: "192.168.1.109"  # (任意) デフォルトは Pod の IP アドレス
      path: "/shutdown"
      port: "8080"
      scheme: "HTTP"         # HTTP または HTTPS
      httpHeaders:
        - name: "Custom-Header"
          value: "value"

  postStart:        # コンテナが開始した後に実行
    exec:
      command:
        - /bin/bash
        - -c
        - "echo started"
    httpGet:
      host: "192.168.1.109"  # (任意) デフォルトは Pod の IP アドレス
      path: "/initialize"
      port: "8080"
      scheme: "HTTP"         # HTTP または HTTPS
      httpHeaders:
        - name: "Custom-Header"
          value: "value"

設定のマウント

ConfigMap または Secret リソースをコンテナにマウントします。

  configMountDescs:
    - type: "ConfigMap"           # ConfigMap または Secret
      name: "my-config"
      mountPath: "/home/admin"    # マウントディレクトリ
      mountItems:                 # 個別のファイルとしてマウント
        - key: "config-key"
          path: "config-file"
      useSubPath: true            # true: 既存のファイルを保持、false: 上書き

Java 起動パラメーター

  javaStartUpConfig:
    initialHeapSize:             # -Xms (初期ヒープサイズ、MB)
      original: 1000
      startup: "-Xms1000m"
    maxHeapSize:                 # -Xmx (最大ヒープサイズ、MB)
      original: 1000
      startup: "-Xmx1000m"
    newSize:                     # -XX:NewSize (若い世代の初期サイズ、MB)
      original: 200
      startup: "-XX:NewSize=200m"
    maxNewSize:                  # -XX:MaxNewSize (若い世代の最大サイズ、MB)
      original: 200
      startup: "-XX:MaxNewSize=200m"
    survivorRatio:               # -XX:SurvivorRatio (Eden 領域と Survivor 領域の比率)
      original: 2
      startup: "-XX:SurvivorRatio=2"
    newRatio:                    # -XX:NewRatio (古い世代と若い世代の比率)
      original: 8
      startup: "-XX:NewRatio=8"
    permSize:                    # -XX:PermSize (Permanent 世代、MB)
      original: 512
      startup: "-XX:PermSize=512m"
    maxPermSize:                 # -XX:MaxPermSize (Permanent 世代の最大サイズ、MB)
      original: 512
      startup: "-XX:MaxPermSize=200m"
    maxDirectMemorySize:         # -XX:MaxDirectMemorySize (MB)
      original: 100
      startup: "-XX:MaxDirectMemorySize=100m"
    threadStackSize:             # -XX:ThreadStackSize
      original: 500
      startup: "-XX:ThreadStackSize=500"
    hsfserverPort:               # HSF サーバーポート
      original: 12200
      startup: "-Dhsf.server.port=12200"
    hsfserverMinPoolSize:        # HSF 最小スレッドプールサイズ
      original: 50
      startup: "-Dhsf.server.min.poolsize=50"
    hsfserverMaxPoolSize:        # HSF 最大スレッドプールサイズ
      original: 720
      startup: "-Dhsf.server.max.poolsize=720"
    youngGarbageCollector:       # 若い世代の GC ポリシー
      original: "UseSerialGC"   # UseSerialGC、UseG1GC、UseParNewGC、または UseParallelGC
      startup: "-XX:+UseSerialGC"
    oldGarbageCollector:         # 古い世代の GC ポリシー
      original: "UseConcMarkSweepGC"   # UseConcMarkSweepGC、UseSerialGC、UseG1GC、UseParNewGC、UseParallelOldGC、または UseParallelGC
      startup: "-XX:+UseConcMarkSweepGC"
    concGCThreads:               # コンカレント GC スレッド数
      original: 5
      startup: "-XX:ConcGCThreads=5"
    parallelGCThreads:           # パラレル GC スレッド数
      original: 5
      startup: "-XX:ParallelGCThreads=5"
    g1HeapRegionSize:            # G1 リージョンサイズ (MB)
      original: 50
      startup: "-XX:G1HeapRegionSize=50m"
    gclogFilePath:               # GC ログディレクトリ
      original: "/tmp/"
      startup: "-Xloggc:/tmp/"
    useGCLogFileRotation:        # GC ログローテーションの有効化
      original: true
      startup: "-XX:+UseGCLogFileRotation"
    numberOfGCLogFiles:          # GC ログファイル数
      original: 5
      startup: "-XX:NumberOfGCLogFiles=5"
    gclogFileSize:               # GC ログファイルサイズ (MB)
      original: 100
      startup: "-XX:GCLogFileSize=100m"
    heapDumpOnOutOfMemoryError:  # メモリ不足 (OOM) 時のヒープダンプの有効化
      original: true
      startup: "-XX:+HeapDumpOnOutOfMemoryError"
    heapDumpPath:                # OOM ダンプファイルのパス
      original: "/tmp/dumpfile"
      startup: "-XX:HeapDumpPath=/tmp/dumpfile"
    customParams:                # カスタム JVM パラメーター
      original: "-Dtest=true"
      startup: "-Dtest=true"

スケジューリングルール

  deployAcrossZones: "true"    # Pod をアベイラビリティゾーンにまたがってデプロイ (推奨)
  deployAcrossNodes: "true"    # Pod をノードにまたがってデプロイ (推奨)

  customTolerations:           # Kubernetes スケジューリングの Toleration
    - key: my-key
      operator: Exists         # Exists または Equal
      effect: NoSchedule       # NoSchedule または NoExecute
    - key: another-key
      operator: Equal
      value: "my-value"
      effect: "NoExecute"
      tolerationSeconds: 300

  customAffinity:
    nodeAffinity:              # ノードラベルに基づいて Pod をスケジューリング
      requiredDuringSchedulingIgnoredDuringExecution:
        nodeSelectorTerms:
          - matchExpressions:
              - key: "topology.kubernetes.io/zone"
                operator: "In"
                values:
                  - "cn-hangzhou-a"
      preferredDuringSchedulingIgnoredDuringExecution:
        - weight: 1
          preference:
            matchExpressions:
              - key: "topology.kubernetes.io/zone"
                operator: "In"
                values:
                  - "cn-hangzhou-b"
    podAffinity:               # 一致する Pod と同じ場所に Pod を配置
      requiredDuringSchedulingIgnoredDuringExecution:
        - namespaces:
            - "default"
          topologyKey: "topology.kubernetes.io/zone"
          labelSelector:
            matchExpressions:
              - key: "app"
                operator: "In"
                values:
                  - "my-app"
    podAntiAffinity:           # 一致する Pod から離れた場所に Pod を分散
      requiredDuringSchedulingIgnoredDuringExecution:
        - namespaces:
            - "default"
          topologyKey: "kubernetes.io/hostname"
          labelSelector:
            matchExpressions:
              - key: "app"
                operator: "In"
                values:
                  - "my-app"
      preferredDuringSchedulingIgnoredDuringExecution:
        - weight: 2
          podAffinityTerm:
            namespaces:
              - "default"
            topologyKey: "kubernetes.io/hostname"
            labelSelector:
              matchExpressions:
                - key: "app"
                  operator: "In"
                  values:
                    - "my-app"