開発者ツールを使用した Docker コンテナー内のワークベンチ Liberty サーバーの作成
WebSphere Developer Tools を使用して Docker コンテナーで実行される Liberty サーバーへの参照をワークベンチに作成することができます。 この参照を使用して、ワークベンチからサーバー要求を処理できます。
始める前に
- WebSphere Developer Tools をインストールします。 WebSphere Developer Tools のインストールについて詳しくは、Liberty 開発者ツールおよび Liberty (オプション) のインストールを参照してください。
- Docker をインストールします。Docker のインストールについて詳しくは、Liberty での Docker のサポート (Docker support in Liberty) を参照してください。重要: これらのツールは、Docker バージョン 1.10.2 以降をサポートします。
- ローカルの 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 サーバーを構成できます。
- 「サーバー」を右クリックします。
- を選択します。
- スニペットを選択し、ご使用条件に同意します。
タスク・トピック