Windows 環境でコンテナー化されたデベロッパーズ・ツールキットをセットアップするための前提条件

Windows 環境でコンテナー化されたデベロッパーズ・ツールキットをセットアップする前に、以下のステップを実行する必要があります。

始める前に

Windows Subsystem for Linux® バージョン 2 (WSL 2) および Ubuntu は、Windows 環境でのデベロッパーズ・ツールキットのセットアップに広く使用されます。 そのため、WSL 2 システムおよび Ubuntu システムの操作に関する十分な知識が必要です。

手順

  1. Windows 10 システムに Windows Subsystem for Linux バージョン 2 (WSL 2) をインストールします (まだインストールされていない場合)。 Windows Subsystem for Linux バージョン 2 (WSL 2) のインストールについて詳しくは、 Windows Subsystem for Linux Installation Guide for Windows 10を参照してください。
  2. Ubuntu 20.04 を WSL 2 の一部としてダウンロードしてインストールします。
  3. WSL 2 Ubuntu 端末にログインします。
  4. Docker。 詳しくは、 Install Docker Engine on Ubuntuを参照してください。
    重要: デベロッパーズ・ツールキット環境は、非 root ユーザーとしてセットアップする必要があります。 また、ユーザーを docker グループに追加する必要もあります。 詳しくは、 非 root ユーザーとしての Docker の管理を参照してください。
  5. インストール後、 Docker を開始し、 Docker が正しくインストールされていることを確認します。
    Ubuntu システムで、スーパーユーザーとして次のコマンドを実行して Dockerを開始します。
    sudo service docker start

    WSL 2 システムが再始動するたびにこのコマンドを実行するか、これを OS 始動レベルで設定する必要があります。OS 始動レベルで設定すると、WSL 2 システムが再始動するたびに Docker が開始され、有効になります。

  6. Docker Compose バージョン 2.x ( 2.23.0、 2.24 バージョンでテスト済み) をインストールします。 Docker Composeについて詳しくは、 Overview of Docker Compose and Install Docker Composeを参照してください。
  7. WSL 2 システムで実行されているネイティブ DB2®、 WebSphere® Application Server、IBM WebSphere Liberty アプリケーション・サーバー、または MQ アプリケーション・サービスは、不必要にシステム・リソースを消費する可能性があり、ポート番号が Docker Compose 環境と競合する可能性があるため、停止または使用不可にすることをお勧めします。
  8. WSL 2 システムで、 mqserver を localhost として /etc/hosts ファイルに追加します。 このステップは、WSL 2 システムが再始動するたびに繰り返す必要があります。 このステップは、WSL 2 システムの始動時に実行するように自動化することをお勧めします。

次のタスク

Windows WSL 2 環境でデベロッパーズ・ツールキットをセットアップする場合は、以下の点に留意してください。
重要:
  • Windows (WSL 2) 環境でデベロッパーズ・ツールキットをセットアップするコンテキストでは、 localhost が言及されているすべての場所で、WSL 2 システムの IP アドレスを使用する必要があります。 次のコマンドを実行して、WSL 2 システムの IP アドレスを取得できます。

    ip addr | grep -Ee 'inet.*eth0'

    このコマンドは、このコマンドの出力の開始時に IP アドレスを返します。 この IP アドレスは、WSL 2 システムが再始動するたびに変更されます。

    WSL2から Ubuntuで稼働しているサービスを利用する際に、IPアドレスの代わりに localhost を使用したい場合は、これらのサービスが稼働している関連ポート（80、443、1414、9080、9443、50000など）をWSL 2システムのIPアドレスに転送する必要があります。

  • devtoolkit_docker ディレクトリーが /home/user/ ディレクトリー内に直接配置されるように、デベロッパーズ・ツールキット・ファイルを /home/user/ ディレクトリーに解凍することをお勧めします。 これにより、デベロッパーズ・ツールキットが Ubuntu システムのルート・ファイル・システムで実行され、Windows と共有されているドライブやディレクトリー ( /mnt/c など) で実行されていないことも確認できます。

    開発者ツールキットの抽出に関する詳細は、 開発者ツールキットの抽出を参照してください。

  • セットアップの完了後、デベロッパーズ・ツールキットの抽出された /runtime/bin ディレクトリーからシェル・スクリプトまたはコマンドを実行しているときに、 set: Illegal option -o pipefailなどのエラーが発生した場合は、コマンドの前に bashを付けます。

    例えば、コマンドは ./agentserver.sh AgentServerではなく bash ./agentserver.sh AgentServer として入力する必要があります。