開発者ツールを使用した Docker コンテナー内のワークベンチ Liberty サーバーの作成
WebSphere® Developer Tools を使用して Docker コンテナーで実行している Liberty サーバーへの参照をワークベンチに作成することができます。この参照を使用して、ワークベンチからサーバー要求を処理できます。
始める前に
- WebSphere Developer Tools をインストールします。WebSphere Developer Tools のインストールについて詳しくは、Liberty 開発者ツールおよび Liberty (オプション) のインストールを参照してください。
- Docker をインストールします。これらのツールは、Docker バージョン 1.10.2 以降をサポートします。 Docker のインストールについて詳しくは、 Liberty での Docker サポートを参照してください。
Docker イメージとコンテナーを管理するには 、Docker Tooling を使用します。Docker Tooling フィーチャーを使用するには、 Docker Tooling を含む WebSphere Application Server Liberty Docker Tools をインストールします。Docker Tooling について詳しくは、Linux Tools Project/Docker Tooling/User Guide を参照してください。
- ローカルの Docker コンテナーで Liberty サーバーを始動し、HTTP と HTTPS の両ポートがホストにマップされていることを確認します。 ローカル Docker コンテナーでの Liberty サーバーの始動について詳しくは、『WASdev GitHub』を参照してください。
- Mac OS を使用している場合、デフォルトでは、Docker コマンドは /usr/local/bin ディレクトリーに配置されています。Docker コマンドの場所を変更する場合は、ツールが Docker コマンドを見つけることができるように、以下のステップを実行してください。
- 次の行を eclipse.ini ファイルに追加します。
-Dcom.ibm.ws.st.envPath=<Docker commands directory>
- Eclipse を再開します。
- 次の行を eclipse.ini ファイルに追加します。
このタスクについて
WebSphere Application Server Liberty をインストールし、WASdev コミュニティーのダウンロード・サイトから Liberty Repository 内のアドオンをダウンロードすることができます。Liberty をインストールした後、Docker コンテナーを選択できます。 その後、Liberty サーバーの Liberty サーバー・セキュリティー・クレデンシャルを入力して、 Docker コンテナー内の Liberty サーバーへのワークベンチ参照を作成します。
下記の手順を実行する際に Docker コマンドがタイムアウトになる場合、この問題を回避することができます。com.ibm.ws.st.DockerCommandTimeoutInSeconds システム・プロパティーを、秒単位の任意の時間に設定します。 デフォルトでは、このプロパティーは 10 に設定されています。
重要: Docker コンテナーで実行されている Liberty サーバーに対して、「次回の始動時にサーバーをクリーン (Clean Server on Next Start)」を選択することはできません。
手順
タスクの結果
Docker コンテナーで実行されるサーバーへのワークベンチ・サーバー参照が作成されました。
- 作成したサーバーとそのサーバー構成を確認するには、「サーバー」ビューを開きます。
- プロジェクト、サーバー・フォルダー、サーバー構成ファイルを確認するには、 「エンタープライズ・エクスプローラー」ビューを開きます。
次のタスク
- サーバー構成を編集できます。詳しくは、開発者ツールを使用した Liberty構成の編集を参照してください。制約事項: ツールは、サーバー構成内で絶対パスを使用することによるインクルード・ファイルの指定をサポートしません。この問題を回避するには、 絶対パスを使用する代わりに、事前定義されたサーバー変数 (server.config.dir や shared.config.dir など) を使用してインクルード・パスを指定します。
- サーバーの始動または停止、サーバーのアプリケーションの追加または削除を行うには、サーバーを右クリックして「サーバー・コンテキスト・メニュー (server context menu)」を使用するか、
「サーバー」ビューのトレイ・ボタンを使用します。
詳しくは、『開発者ツールを使用したサーバーの始動および停止』を参照してください。ヒント: これらのオプションにアクセスするには、 「サーバー」ビューで「サーバー・エントリー (Server Entry)」を選択します。 「サーバー構成」や server.xml エントリーなど、サーバー構成は選択しないでください。
- Tivoli® Directory Server でユーザーを認証するよう Liberty サーバーを構成できます。
- 「サーバー」を右クリックします。
- を選択します。
- スニペットを選択し、ご使用条件に同意します。
サーバー環境ファイルを作成して編集することができます。詳しくは、製品資料の サーバー環境ファイルの作成と編集を参照してください。