Docker コンテナによる VersionVault Dynamic View クライアントアクセス

2023/1/11 - 読み終える時間: 12 分

Docker Container with VersionVault Dynamic View Client Access の翻訳版です。

Docker コンテナによる VersionVault Dynamic View クライアントアクセス

はじめに

本ブログでは、HCL VersionVaultとDockerをインストールしたDockerホストに、Docker Container with Dynamic View Client Accessを提供する設定方法について説明します。これまで開発者は、1台のマシンで異なるバージョンのソフトウェアに対応する環境を構成するのは面倒な作業でした。しかし現在では、アプリのバージョンごとに「Dockerコンテナ」と呼ばれる隔離された環境を作成し、各コンテナは、開発者マシン上で同時に実行されるOSや他のコンテナの構成に影響を与えない個別の環境設定を保持することができます。このような柔軟な環境をユーザーに提供するため、HCL VersionVaultはDockerに対応するよう強化されました。

1. VersionVaultとDockerコンテナの統合のための前提条件

Linuxホスト上に以下の4つがインストールされ、稼働していることが必要です。

• HCL VersionVault バージョン2.0.1以降
• Docker
• NFSサービス
• Automounter サービス
• LinuxホストへのDockerとVersionVaultのインストール

2.1. VersionVaultのインストール

• MVFSとMVFSデバイスを共有するために、Dockerホストは最低限VersionVault 2.0.1をインストールし、VersionVaultダイナミックビュークライアントとして動作するように設定する必要があります。
• コマンドラインユーザーのソフトウェア開発ワークステーションに必要な最小数のVersionVaultコンポーネントをインストールするため、Dockerホストでは、VersionVault最小開発者用インストールのみが必要です。
• Dockerコンテナに含まれ、共有が必要な主なコンポーネントは、MVFSとview/VOBサーバーです。
• HCL VV 2.0.1をDockerホストにインストールするには、IBM Installation Manager 1.8.6、1.9.1およびその将来の修正パックを使用する必要があります。

• VV 2.0.1インストール後の "cleartool-version "コマンドのスクリーンショットを以下に掲載します。

2.2. Dockerのインストール

• VersionVault 2.0.1がインストールされたLinuxホストには、最新バージョンのDockerをインストールすることができます。以下は、Docker Engineのインストール概要のリンクで、異なるLinuxプラットフォームでのインストール手順を共有しています。

https://docs.docker.com/engine/install/

1. DockerホストへのNFSサーバとLinux Automounterのインストール

• VersionVaultは、NFSとLinuxオートカウンターを使用して、ビューやVOBストレージにアクセスします。Dockerホストシステムは、NFSとLinuxオートカウンター用に設定されている必要があります。

3.1. NFSサーバーのインストール

• このブログ記事では、RedHat OSを使用しています。以下に示すコマンドは、使用する特定のLinuxディストリビューションによって異なります。

ステップ 1：サーバーの更新とホスト名の設定

サーバーには、再起動後も有効な固定IPアドレスと固定ホスト名が必要です。

ステップ 2：NFSサーバーのインストール。

次に、LinuxホストへのNFSサーバ・パッケージのインストールです。

インストール後、nfs-serverサービスを開始し、有効にします。

ステータスが "running" と表示されるはずです。

2. Linuxオートカウンターのインストール

ステップ 1：Linuxホストにautofsをインストールします。

• AutoFSパッケージをインストールする場合、インストールプロセスでは以下のことが行われます。
• /etcディレクトリに auto.master、auto.net、auto.misc などの複数の設定ファイルを作成します。
• systemd に AutoFS サービスを作成 (Create) します。
• 「nsswitch.conf」ファイルに automount エントリを追加し、files ソースにリンクします。

ステップ 2: インストール直後、systemctl status コマンドで AutoFS サービスが起動していることを確認します。

ステップ 3: スタートアップ時に実行されるように、AutoFSサービスを有効にすることもできます。

3. Docker Host での VOB、View 作成について

• Dockerコンテナ内で使用するVOB/Viewを作成する場合、オプションを指定する必要があります。-ホスト、-hpath、-gpath を指定します。hpathとgpathは、いずれもVOB/Viewの格納ディレクトリのグローバルパス名を指定します。

例えば、ホスト名がtest_hostであるマシンにVOB/Viewを常駐させたいとします。DockerホストとVOB/Viewサーバーのホストであるtest_hostは、automounterを使用しています。

コンテナ内で使用するVOB/ViewをDockerホスト上に作成する場合は、以下のようにします。

cleartool mkview -tag testview -host dockhost -hpath /net/ dockhost /viewstg/testview.vws -gpath /net/dockhost/user/viewstg/testview.vws /net/dockhost /user/viewstg/testview.vwsを実行します。

cleartool mkvob -tag /vob/testvob -host dockhost -hpath /net/dockhost/vobstg/testvob.vbs - gpath /net/dockhost/user/vobstg/testvob.vbs /net/dockhost/user/vobstg/testvob.vbsを実行します。

VOB/View が Docker ホストまたは Docker コンテナ上に存在する場合に必要です。

Dockerコンテナでは、コンテナの設定次第でストレージもホスト名も一時的なものになるため、Dockerコンテナの外部のVOB/Viewを使用することをお勧めします。

1. サンプルのDockerコンテナ

動的なビュークライアントアクセスが可能なDockerコンテナ

• この方法では、コンテナ内にビューを作成し、VOBにアクセスして新しいファイル/ディレクトリの要素を作成したり、既存のファイル/ディレクトリの要素を変更したりすることができます。
• Docker build ディレクトリは、Dockerfile, config_ssh.sh, config_dir, docker_compose.yml から構成されています。
• Linuxのベースイメージは、Dockerホスト上で動作するVersionVaultのリリースでサポートされている必要があり、initプロセスもサポートされている必要があります。RedHatとSUSEの両社は、それぞれのレジストリでベースイメージを提供しています。
• Linuxベース・イメージには、VersionVaultを実行するために必要なすべてのパッケージが含まれていない場合があります。ユーザーは、これらのパッケージをインストールするためにコンテナを更新する必要があります。Technote 535653、887639、718343 を参照してください。
• Dynamic View Client Access 搭載コンテナに関連するDocker buildディレクトリとサンプルDockerfile、docker_compose.yml、config_ssh.sh、config_dirの詳細については、以下のリンク先を参照してください。ウィンドウ右上のResourcesドロップダウンで、"HCL VersionVault and Docker Containers"という記事へのリンクを探します。

https://www.hcltechsw.com/versionvault

2. 最終的な統合の実行

• Dockerfile と docker_compose.yml ファイルが必要な設定内容で作成されたら、Docker build ディレクトリに移動して、以下のコマンドを実行してコンテナを構築・実行する必要があります。引数"-d "は、コンテナをデタッチャブルモードで実行するために使用されます。

• 上記のコマンドは、サービス用のコンテナのビルド、（再）作成、起動、アタッチメントを行うものです。実行中のコンテナを確認するには、以下のコマンドを実行する。

• コンテナにsshでアクセスするためには、コンテナのIPアドレスを見つける必要があります。これを実現するために、以下のコマンドを実行する必要があります。

コマンドの出力の最後に、IPアドレスが表示されます。以下は、参考のためのサンプルスニペットです。

• コンテナのIPアドレスが見つかったら、Dockerホストの/etc/hostsファイルにコンテナのIPとホストネームを入力します。同様に、Dockerfileで提供された入力に従って、コンテナ作成時に作成したアカウントを使用してコンテナにsshした後、コンテナの/etc/hostsファイルにDockerホストのIPアドレスとホスト名の詳細情報を追加してください。

• このブログ記事では、コンテナ作成時に「root」アカウントを作成するようにDockerfileをカスタマイズしているため、コンテナのログインにも同じアカウントを使用します。また、Dockerfileを修正して、そのアカウントがClearCaseコマンドの実行、ビューの作成、VOBへのアクセスを確実に行えるようにすれば、必要に応じてVOBオーナーや通常のVersionVaultユーザーを作成することができます。

• VOBオーナーアカウントは、Dockerホストに存在するようなコンテナ内に作成されるため、ログイン後に切り替えることができます。VersionVaultのVOBオーナーアカウントを特定する理由は、VOBやVOBオブジェクトをrootアカウントやVersionVault管理者グループに所有させることは、権限の問題に直面することになるため、良い習慣とは言えないからです。

• コンテナ内で "cleartool "コマンドを実行できるようになりました。

DockerホストがVersionVaultのバイナリをボリュームとしてコンテナと共有しているからこそ、「cleartool」コマンドの実行が可能なのです。

• Dockerコンテナから、DockerホストにホストされているVOBを一覧表示し、説明することができます。

• DockerホストでホストされているVOBにアクセスするために、コンテナ内にビューを作成する。

• VOBにアクセスするために、ビューをコンテナ内に作成した後、ビューに設定します。

• チェックアウトを行い、"mkelem "を実行してVOBの下に新しいファイルエレメントを追加しました。最後にcatコマンドを実行し、test.txtファイルの中身を確認。

• コンテナ内に作成したファイル「test.txt」は、Dockerホストからアクセスすることができます。

サンプルビルドの実行

※本節では、サンプルビルドを実行します。

• このセクションでは、コンテナ内でビルドを実行する方法について説明します。
• コンテナにsshで入り、VOBのオーナーアカウントに切り替えて、コンテナ内に作成したビューにセットし、VOBにcdします。

• VOBの下にhelloworldディレクトリが作成され、その下に簡単なC言語プログラムが配置されているのがわかります。

• 次に、ビルドユーティリティ "clearmake "を実行して、単純なCコードをコンパイルし、helloworldプログラムを実行して出力を見ます。

• clearmakeの完了後、上記のスクリーンショットから、helloworldの実行ファイルが作成され、 実行可能な状態にあることが分かります。

• この例では、コンテナ内でのシンプルなclearmakeのビルドを確認しましたが、同様の方法で、Dockerコンテナ内で実行可能な他のカスタマイズされたビルドを設定することが可能です。このように、異なるビルド環境のために複数の物理ビルドマシンを構成する代わりに、異なるコンテナ内で実行するようにビルド環境を構成することができるので、コストと時間を節約することができます。

• VersionVaultは、コンテナ内にインストールすることができます。コンテナではMVFSファイルシステムのインストールと起動を行わないため、インストールはサーバーインストールである必要があります（最小または完全な開発者用インストールではありません）。