Helm チャートを介した Flex Gateway デプロイメントのポッド設定の更新

Flex Gateway デプロイメントが含まれるポッドの要件を変更します。このガイドの例では、Flex Gateway デプロイメントの Helm チャートの次の CPU およびメモリ要件を設定します。

  • resources.limits.cpu=1500m

  • resources.limits.memory=2048Mi

  • resources.requests.cpu=260m

  • resources.requests.memory=384Mi

この例は、Flex Gateway デプロイメントの Helm チャートの値を更新するためのガイドとして使用してください。

次のいずれかの方法で、Flex Gateway のデフォルトの Helm チャート設定を見つけます。

  • ArtifactHUB​ の ​flex-gateway​ ページを開く

  • ターミナルウィンドウから ​helm show values <repository-name>/<chart-name>​ (例: helm show values flex-gateway/flex-gateway​) を実行します。

CPU およびメモリリソース設定についての詳細は、 Kubernetes ドキュメント​を参照してください。

始める前に

Flex Gateway を登録して Kubernetes クラスターにデプロイします。案内については、「​Flex Gateway のセットアップ or Kubernetes クラスターでの Flex Gateway の使用開始​」を参照してください。

Helm チャートの現在の設定を確認する

Flex Gateway デプロイメントが含まれるポッドの設定を更新する前に、ポッドの現在のデプロイメントの設定を確認します。

  1. ターミナルウィンドウから次のコマンドを実行して、Helm リポジトリが稼働していて使用可能であることを確認します。

    helm repo up
  2. 最新のデプロイメントの ​REVISION​ 番号を見つけます。

    次の例では、​gateway​ 名前空間の ​ingress​ リリースの履歴を要求します。

    helm history ingress -n gateway

    コマンドで次のような結果が返されます。

    REVISION  UPDATED                 	STATUS    	CHART             	APP VERSION	DESCRIPTION
    1         Mon Mar 27 09:36:20 2023	superseded	flex-gateway-1.4.2	1.4.2      	Upgrade complete
    2         Mon Mar 27 11:40:56 2023	deployed  	flex-gateway-1.4.2	1.4.2      	Upgrade complete
  3. 現在デプロイされているリビジョンの ​USER-SUPPLIED VALUES​ 設定の ​resources​ を確認します。

    コマンドの構文:
    helm get values --revision=<version-number> <release-name> -n <namespace>
    例:
    helm get values --revision=2 ingress -n gateway

    次の例は、ポッドの ​registration​ データの下にあるポッドの CPU およびメモリの ​resources​ 設定を示しています。

    USER-SUPPLIED VALUES:
    registration:
      ...
    resources:
      limits:
        cpu: 1000m
        memory: 2024Mi
      requests:
        cpu: 250m
        memory: 256Mi

    この例では、​REVISION​ 番号 ​2​ の設定が表示されています。出力には、変更された設定のみが表示されます。Helm チャートのデフォルト値が変更されていない場合、出力にリビジョンは表示​されません​。

  4. 次のいずれかの手順を使用して、Flex Gateway デプロイメントの Helm チャートの設定を変更します。

Helm チャートの設定を変更する

「​Helm チャートの現在の設定を確認する​」の手順を実行した後に、​--set​ オプションを使用して、Flex Gateway デプロイメントの Helm チャートに新しい値を個別に渡します。または、「​Helm チャートの変更された設定が含まれるファイルに提供する​」の手順を実行します。

  1. helm upgrade​ コマンドを使用して、​cpu​ および ​memory​ 値を変更します。

    構文:
    helm -n <namespace> upgrade <release-name> \
    --wait \
    --reuse-values \
    <repository-name>/<chart-name> \
    --set <key-to-update>=<new-value>
    --set <next-key-to-update>=<new-value>
    ...
    例:
    helm -n gateway upgrade ingress \
    --wait \
    --reuse-values \
    flex-gateway/flex-gateway \
    --set resources.limits.cpu=1500m \
    --set resources.limits.memory=2048Mi \
    --set resources.requests.cpu=260m \
    --set resources.requests.memory=384Mi

    コマンドが成功すると、次のような出力が返されます。

    Release "ingress" has been upgraded. Happy Helming!
    NAME: ingress
    LAST DEPLOYED: Mon Mar 27 11:58:36 2023
    NAMESPACE: gateway
    STATUS: deployed
    REVISION: 3
    TEST SUITE: None
  2. 次のように、新しい ​REVISION​ 値を使用して、​resources​ 設定を確認します。

    helm get values --revision=3 ingress -n gateway

    出力には、ポッドの新しい ​resources​ 設定が表示されます。

    USER-SUPPLIED VALUES:
    registration:
      ...
    resources:
      limits:
        cpu: 1500m
        memory: 2048Mi
      requests:
        cpu: 260m
        memory: 384Mi

Helm チャートの変更された設定が含まれるファイルに提供する

「​Helm チャートの現在の設定を確認する​」の手順を実行した後に、​helm upgrade​ で ​-f​ オプションを使用して、Flex Gateway デプロイメントの新しい Helm チャート設定が含まれるファイルを識別します。または、「​Helm チャートの設定を変更する​」の手順を実行します。

  1. 新しい設定が含まれる設定ファイルを作成します。

    たとえば、新しい ​cpu​ および ​memory​ メモリ値が含まれる ​my-config-file.yaml​ という名前の YAML ファイルを作成します。

    resources:
      limits:
        cpu: 1500m
        memory: 2048Mi
      requests:
        cpu: 260m
        memory: 384Mi
  2. 次のように、設定ファイルから Helm チャートに新しい値を渡します。

    構文:
    helm -n <namespace> upgrade <release-name> \
    --wait \
    --reuse-values \
    <repository-name>/<chart-name> \
    -f <your-settings-config-file>
    例:
    helm -n gateway upgrade ingress \
    --wait \
    --reuse-values \
    flex-gateway/flex-gateway \
    -f my-config-file.yaml

    コマンドが成功すると、次のような出力が返されます。

    Release "ingress" has been upgraded. Happy Helming!
    NAME: ingress
    LAST DEPLOYED: Mon Mar 27 16:38:07 2023
    NAMESPACE: gateway
    STATUS: deployed
    REVISION: 4
    TEST SUITE: None
  3. 次のように、Helm リポジトリとチャート名を使用してチャートの更新を確認します。

    helm get values --revision=4 ingress -n gateway

    出力には、ポッドの新しい ​resources​ 設定が表示されます。

    USER-SUPPLIED VALUES:
    registration:
      ...
    resources:
      limits:
        cpu: 1500m
        memory: 2048Mi
      requests:
        cpu: 260m
        memory: 384Mi