
開発者ツールを使用した Docker コンテナー内のワークベンチ Liberty サーバーの作成
WebSphere® Developer Tools を使用して Docker コンテナーで実行される Liberty サーバーへの参照をワークベンチに作成することができます。この参照を使用して、ワークベンチからサーバー要求を処理できます。
始める前に
- 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 をインストールします。詳しくは、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 リポジトリー 内のアドオンをダウンロードすることができます。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 サーバーを構成できます。
- 「サーバー」を右クリックします。
- を選択します。
- スニペットを選択し、ご使用条件に同意します。
サーバー環境ファイルを作成して編集することができます。詳しくは、製品資料の サーバー環境ファイルの作成と編集を参照してください。