Hitachi

Hitachi Microservices Platform - Paxos Commit Transaction Orchestrator ユーザーズガイド

2.3.6　Relay-Serviceコンテナイメージの作成

Relay-Serviceコンテナイメージの作成方法について説明します。

ユーザ責務のKubernetesアプリケーションのRelay-Serviceコンテナの数だけ、このコンテナイメージのContainerfileを作成しビルドしてください。

〈この項の構成〉

(1)　Containerfileの作成

「6.4.2　Relay-Serviceコンテナイメージ」に記載されている要件を満たすように、Relay-ServiceコンテナイメージをビルドするためのContainerfileを作成してください。

Containerfileの記述例を次に示します。

■通常版（uCosminexus Application Runtime for Spring Boot導入あり）の場合

FROM myregistry.example.com/myproject/ucars:01-12-01     …1
COPY --chown=1001:0 --chmod=0440 ./relay-service-V.R.S※.jar /deployments/     …2
COPY --chown=1001:0 --chmod=0550 ./health_check.sh /deployments/    …3
CMD /opt/hitachi/ucars/bin/starter.sh java ${HMPPCTO_JAVA_OPTIONS} -jar /deployments/relay-service-V.R.S※.jar     …4

記述例の番号は、説明の番号と対応しています。

＜説明＞

  1. コンテナベースイメージとして「2.3.3　uCosminexus Application Runtime for Spring Bootコンテナベースイメージの作成（通常版限定）」で作成した「uCosminexus Application Runtime for Spring Bootコンテナベースイメージ」を指定します。この例では、「myregistry.example.com/myproject/ucars:01-12-01」を指定しています。

  2. 「ユーザのRelay-ServiceアプリケーションのJARファイル」を配置し、パーミッションにコンテナ実行ユーザとグループそれぞれの読み取り権限を付与します。この例では、「ユーザのRelay-ServiceアプリケーションのJARファイル」の名前を「relay-service-V.R.S※.jar」としています。

  3. 「HMP-PCTOのトランザクションヘルスチェックスクリプト（health_check.sh）」を配置し、パーミッションにコンテナ実行ユーザとグループそれぞれの実行権限を付与します。

  4. コマンドを「uCosminexus Application Runtime for Spring Bootのプロセスモニタ起動スクリプト(starter.sh)」とし、引数に「javaコマンド」、「環境変数HMPPCTO_JAVA_OPTIONSの値」、「ユーザのRelay-ServiceアプリケーションのJARファイル」を指定します。

注※

V.R.Sは使用するHMP-PCTOのバージョンに合わせて読み替えてください。

■通常版（uCosminexus Application Runtime for Spring Boot導入なし）の場合

FROM myregistry.example.com/myproject/jdk:latest     …1
COPY --chown=1001:0 --chmod=0440 ./relay-service-V.R.S※.jar /deployments/     …2
COPY --chown=1001:0 --chmod=0550 ./health_check.sh /deployments/     …3
CMD java ${HMPPCTO_JAVA_OPTIONS} -jar /deployments/relay-service-V.R.S※.jar     …4

記述例の番号は、説明の番号と対応しています。

＜説明＞

  1. コンテナベースイメージとして「2.3.4　JDKコンテナベースイメージの作成」で作成した「JDKコンテナベースイメージ」を指定します。この例では、「myregistry.example.com/myproject/jdk:latest」を指定しています。

  2. 「ユーザのRelay-ServiceアプリケーションのJARファイル」を配置し、パーミッションにコンテナ実行ユーザとグループそれぞれの読み取り権限を付与します。この例では、「ユーザのRelay-ServiceアプリケーションのJARファイル」の名前を「relay-service-V.R.S※.jar」としています。

  3. 「HMP-PCTOのトランザクションヘルスチェックスクリプト（health_check.sh）」を配置し、パーミッションにコンテナ実行ユーザとグループそれぞれの実行権限を付与します。

  4. コマンドを「javaコマンド」とし、引数に「環境変数HMPPCTO_JAVA_OPTIONSの値」、「ユーザのRelay-ServiceアプリケーションのJARファイル」を指定します。

注※

V.R.Sは使用するHMP-PCTOのバージョンに合わせて読み替えてください。

■トライアル版の場合

FROM myregistry.example.com/myproject/jdk:latest     …1
COPY --chown=1001:0 --chmod=0440 ./relay-service-V.R.S※.jar /deployments/     …2
COPY --chown=1001:0 --chmod=0550 ./health_check.sh /deployments/     …3
CMD java ${HMPPCTO_JAVA_OPTIONS} -jar /deployments/relay-service-V.R.S※.jar     …4

記述例の番号は、説明の番号と対応しています。

＜説明＞

  1. コンテナベースイメージとして「2.3.4　JDKコンテナベースイメージの作成」で作成した「JDKコンテナベースイメージ」を指定します。この例では、「myregistry.example.com/myproject/jdk:latest」を指定しています。

  2. 「ユーザのRelay-ServiceアプリケーションのJARファイル」を配置し、パーミッションにコンテナ実行ユーザとグループそれぞれの読み取り権限を付与します。この例では、「ユーザのRelay-ServiceアプリケーションのJARファイル」の名前を「relay-service-V.R.S※.jar」としています。

  3. 「HMP-PCTOのトランザクションヘルスチェックスクリプト（health_check.sh）」を配置し、パーミッションにコンテナ実行ユーザとグループそれぞれの実行権限を付与します。

  4. コマンドを「javaコマンド」とし、引数に「環境変数HMPPCTO_JAVA_OPTIONSの値」、「ユーザのRelay-ServiceアプリケーションのJARファイル」を指定します。

注※

V.R.Sは使用するHMP-PCTOのバージョンに合わせて読み替えてください。

ヒント

Red Hat OpenShift Container Platformで実行する場合のファイルのパーミッション設定

Red Hat OpenShift Container Platformには、SCC（Security Context Constraints）と呼ばれる、Podのパーミッションを制御する機能があります。このSCCのデフォルトの設定である「restricted」では、事前に割り当てられた一定範囲内のUID（非root）とGID「0」（root）でコンテナを実行します。

このため、Red Hat OpenShift Container PlatformのSCCのrestricted設定で動作可能なコンテナイメージを作成する際は、配置するファイルのグループに「0」（root）を設定し、パーミッションにはオーナーの権限に加えてグループの権限も付与することを推奨します。

ページの先頭へ

(2)　Containerfileと資材の配置

次の表に示すとおりContainerfileと資材をコンテナイメージビルド環境に配置してください。

表2‒12　Containerfileと資材の配置構成

ファイル／ディレクトリ構成

作成・提供元

備考

<コンテナイメージビルド作業ディレクトリ>/

ユーザ

−

Containerfile

ユーザ

−

<ユーザのRelay-ServiceアプリケーションのJARファイル>

ユーザ

−

health_check.sh

（HMP-PCTOのトランザクションヘルスチェックスクリプト）

日立

−

（凡例）−：該当しません。

ページの先頭へ

(3)　コンテナイメージのビルド

Containerfileを使用して、コンテナイメージをビルドします。

Relay-Serviceコンテナイメージのビルドのコマンドを次に示します。

cd <コンテナイメージビルド作業ディレクトリ>/
docker△build△-f△./Containerfile△-t△<コンテナレジストリ>/[<namespace>/]<Relay-Serviceコンテナイメージのユーザ任意のイメージ名>:<ユーザ任意のタグ名>△.

（凡例）△：半角スペース1文字

＜実行例＞

cd build/
docker build -f ./Containerfile -t myregistry.example.com/myproject/relay-service:latest .

この例では、Relay-Serviceコンテナイメージのイメージ名・タグ名を「relay-service:latest」としています。

ページの先頭へ

(4)　コンテナイメージの登録

ビルドしたRelay-Serviceコンテナイメージを、Kubernetesクラスタで使用するコンテナレジストリにdocker pushコマンドなどで登録してください。

インターネット接続のない閉塞環境の場合は、ローカルのリポジトリ・レジストリなどを使用したり、コンテナイメージビルド環境でエクスポートしたコンテナイメージをKubernetesクラスタの各ワーカーノードにインポートしたりするなどの方法で対応してください。

ページの先頭へ

All Rights Reserved. Copyright (C) 2024, 2025, Hitachi, Ltd.