Kubernetes の StatefulSet を使用してコンテナ化 MID Server を構築およびデプロイする方法 - Support and Troubleshooting

Kubernetes の StatefulSet を使用してコンテナ化 MID Server を構築およびデプロイする方法 Summary Kubernetes では、コンテナ化 MID Server は Pod 上で実行されます。Pod が再起動した場合や障害によって再作成された場合、Pod ストレージは一時的（ephemeral）であるため、Pod のファイルシステムに対するすべての変更は失われます。

MID Server はステートフルアプリケーションです。各 MID Server は config.xml に保存された一意の名前と sys_id を持っています。また、キーストア内に独自の鍵ペアを持ち、work フォルダー内にその他の作業データを保持しています。このようなデータは永続ストレージに保存する必要があります。これにより、MID Server は新しい Pod 上でも継続して動作できます。

Kubernetes Deployment と Kubernetes StatefulSet は、Kubernetes 上でコンテナ化アプリケーションを管理するための 2 つの主要なワークロードリソースです。Deployment はステートレスアプリケーションの管理に適しており、StatefulSet はステートフルアプリケーションの管理に適しています。

StatefulSet は Utah リリースからサポートされていますが、対象はコンテナ化 Linux MID Server のみです。MID Server に Deployment ワークロードリソースを使用することは推奨していません。

注：永続ストレージ上のデータを安全に保つことが重要です。これにアクセスできる人は MID Server を侵害できる可能性があります。

Release この KB は、San Diego または Tokyo を利用しているお客様、およびコンテナ化 Windows MID Server をデプロイしたいお客様向けの回避策を提供します。 Instructions イメージの構築 前提条件：Docker Engine または Docker Desktop がマシンにインストールされていることを確認してください。Windows の場合は Windows Server 2019 が必要です。 Utah Patch 4 以降から MID Docker レシピをダウンロードするか、この KB に添付されているレシピを使用します。 レシピをフォルダーに展開します。 インスタンスで MID Server ダウンロードページを開き、「Download MID Server as ZIP archive」チェックボックスをオフにして MID インストール ZIP ファイルをダウンロードします。 ZIP ファイルの署名を検証します。 jarsigner -verify -verbose -certs -strict 注：jarsigner ツールは JDK に含まれており、JRE には含まれていません。 MID インストール ZIP ファイルを、レシピを展開した asset サブフォルダーに移動します。 現在のディレクトリをレシピフォルダに変更します。 次のコマンドを実行してイメージを構築します。 docker build . --build-arg MID_INSTALLATION_FILE= --build-arg MID_SIGNATURE_VERIFICATION=false --tag 注： はダウンロードした MID インストール ZIP ファイルのパスを含まないファイル名です。例：mid.sandiego-12-22-2021_01-31-2023_0300.linux.x86-64.zip。どの MID バージョンを含むイメージか識別しやすくするため、 に MID のビルドタイムスタンプを含めることを推奨します。例：mid:sandiego-12-22-2021_01-31-2023_0300 イメージを Kubernetes クラスターから取得可能なリモートレジストリへプッシュします。

StatefulSet を使用して Kubernetes に MID Server をデプロイする 前提条件：Kubernetes クラスターへのアクセス権が必要です。以下の手順は Azure CLI を使用した AKS 上でテストされています。Windows MID をデプロイする場合は、Windows Server 2019 ノードを含むクラスターが必要です。 添付ファイル内の StatefulSet デプロイメントテンプレートのいずれかを選択し、コピーを作成します。 yaml ファイルを次のように変更します。 - Replace with a K8s service name, i.e. snc-mid-server - Replace with a K8s namespace name, i.e. default - Replace with a statefulset name, i.e. statefulset-linux-mid or statefulset-windows-mid - Replace with a claim template name, i.e. snc-mid-server - Replace with your storage class name, i.e. managed-csi (Tip: run 'kubectl get storageclass' to get a list of available storage classes) - Replace with the url pointing to the image in the remote registry, i.e. midcontainerregistry.azurecr.io/mid:tokyo-07-08-2022_04-11-2023_0200 - Replace with the instance URL // If the image is in a private registry - Replace with your registry secret name, i.e. midcontainerregistry-secret // If using basic auth - Replace " with the mid instance user name, i.e. mid_server_basic_auth - Replace with the path where the mid secret volume is mounted, i.e. /etc/secrets (linux) or c:\snc_mid_server\secrets (windows) - Replace with the mid secret properties file name, i.e. mid-secrets.properties - Replace with the mid secret name, i.e. mid-secret // If using mutual auth - Replace with the path where the mid mutual auth secret volume is mounted, i.e. /etc/secrets (linux) or c:\snc_mid_server\secrets (windows) - Replace with the mutual auth PEM file, i.e. mid-mutual-auth.pem - Replace with the mid mutual auth secret name, i.e. mid-mutual-auth-secret - Verify all other parameters and make all changes as needed, for example config parameters, replicas number, memory, cpu limits/requests 次のコマンドを実行します。 kubectl apply -f 手動スケール kubectl scale --replicas= statefulset StatefulSet を削除します。 kubectl delete statefulset

* 注：StatefulSet を削除した後も、Persistent Volume Claim と Persistent Volume は残り、再利用できます。必要に応じて明示的に削除してください。 Related Links トラブルシューティング 注: kubectl コマンドの使用方法については、 https://kubernetes.io/docs/reference/kubectl/cheatsheet/ を参照してください

ヒント: すべてのコマンドに --namespace フラグを追加しないようにするには、次のコマンドを実行して現在の名前空間を変更できます。 kubectl config set-context --current --namespace=

1.statefulset、pvc、および pvc が作成されているかどうかを確認 kubectl get statefulsets kubectl describe statefulset kubeclt 取得 PVC kubeclt 取得 PV

2.新しいポッドが作成されて実行されているかどうかを確認する kubectl get ポッド kubectl ログ [-f] kubectl describe pod

3.localhost とポッド間でファイルをコピーする kubectl cp /:/tmp/foo /tmp/bar kubectl cp /tmp/foo /:/tmp/bar

例:デフォルト名前空間のポッドから localhost にエージェントログフォルダーをコピーします Linux: mkdir agent_logs kubectl cp :/opt/snc_mid_server/agent/logs ./agent_logs Windows: mkdir agent_logs kubectl cp :c:\snc_mid_server\agent\logs .\agent_logs 4.MID コンテナにログオンします Linux:kubectl exec -it -- /bin/bash Windows:kubectl exec -it -- powershell

トラブルシューティング 注：kubectl コマンドの使用方法については、 https://kubernetes.io/docs/reference/kubectl/cheatsheet/ を参照してください。

ヒント：すべてのコマンドに --namespace フラグを追加しなくて済むようにするには、以下のコマンドを実行して現在のネームスペースを変更できます： kubectl config set-context --current --namespace=

1. StatefulSet、PVC、および PV が作成されているか確認します。 kubectl get statefulsets kubectl describe statefulset kubeclt get pvc kubeclt get pv

2. 新しい Pod が作成され実行中であるか確認します。 kubectl get pods kubectl logs [-f] kubectl describe pod

3. localhost と Pod 間でファイルをコピーします。 kubectl cp / :/tmp/foo /tmp/bar kubectl cp /tmp/foo / :/tmp/bar

例：default ネームスペース内の Pod から agent logs フォルダーを localhost にコピーする

Linux： mkdir agent_logs kubectl cp :/opt/snc_mid_server/agent/logs ./agent_logs

Windows： mkdir agent_logs kubectl cp :c:\snc_mid_server\agent\logs .\agent_logs

4. MID コンテナーにログインします。 Linux：kubectl exec -it -- /bin/bash Windows：kubectl exec -it -- powershell