使用 WebSphere® Developer Tools 在工作台中创建对在 Docker 容器中运行的 Liberty 服务器的引用。 可以使用此引用从工作台处理服务器请求。
准备工作
- 安装 WebSphere Developer Tools。 有关更多信息,请参阅 安装 Liberty 开发者工具和 (可选) Liberty。
- 安装 Docker。 这些工具支持 Docker V1.10.2 和更高版本。 有关安装 Docker的更多信息,请参阅 Docker: 入门。
- 使用 Docker Tooling 管理 Docker 映像和容器。 要使用 Docker 工具功能部件,请安装 WebSphere Application Server Liberty Docker 工具,其中包括 Docker 工具。 有关更多信息,请参阅 Linux® Tools Project/Docker Tooling/User Guide。
- 在本地 Docker 容器中启动 Liberty服务器 ,并确保将 HTTP 和 HTTPS 端口映射到主机。 有关在本地 Docker 容器中启动 Liberty服务器的更多信息,请参阅 WASdev GitHub。
- 如果您默认使用 macOS, ,则 Docker 命令位于 /usr/local/bin 目录中。 如果您更改 Docker 命令的位置,请完成下列步骤,以便工具可以找到
Docker 命令:
- 将以下行添加到 eclipse.ini 文件:
-Dcom.ibm.ws.st.envPath=<Docker commands directory>
- 重新启动 Eclipse。
有关此任务
您可以安装 WebSphere Application Server Liberty ,并从 WASdev 社区下载站点下载 Liberty Repository 中的附加组件。 安装 Liberty后,可以选择 Docker 容器。 然后,您可以输入 Liberty 服务器的 Liberty 服务器安全凭证,以在 Docker 容器中创建对 Liberty 服务器的工作台引用。
如果在您完成这些步骤时 Docker 命令超时,您可以解决此问题。 请将
com.ibm.ws.st.DockerCommandTimeoutInSeconds 系统属性设置为以秒为单位的时间。 缺省情况下,此属性设置为
10。
重要信息: 对于在 Docker 容器中运行的 Liberty 服务器,无法选择 下次启动时清除服务器 。
过程
- 在工作台中,通过单击 服务器 选项卡打开 " 服务器 " 视图。
提示: 如果 " 服务器 " 视图不可见,请选择 并在过滤器文本中输入 Server 。 然后,选择 服务器。
- 右键单击 " 服务器 " 视图,然后选择 。
- 要选择服务器类型,请选择 。
- 在 服务器的主机名 字段中输入 localhost 值。
- 单击下一步。
注: 确保 Liberty 运行时环境具有与所选 Liberty Docker 映像相同的功能部件集。 另外,请确保将它们配置为使用同一级别的 Java™ 运行时环境 (JRE)。 Liberty 运行时环境用作开发环境中的目标运行时。 本地系统运行时与 Liberty Docker 映像中使用的 JRE 不匹配可能导致从配置错误到应用程序发布问题的问题。
- 如果工具提示您安装 WebSphere Application Server Liberty,因为它未安装,或者因为您需要输入安装目录,请完成下列其中一个选项。 否则,请跳过此步骤。
您需要安装 Liberty ,以便可以在 Docker 容器中创建对 Liberty 服务器的工作台引用。
如果先前安装了 Liberty,请完成以下步骤以选择安装该 Liberty 的目录:
- 选择 选择现有安装。
- 在 路径 字段中,输入或浏览 WebSphere Application Server Liberty的安装目录。
- 在 " Liberty 运行时环境 " 页面上,单击 下一步。
如果要从先前下载的归档文件安装 Liberty ,请完成以下步骤:
- 选择 从归档或存储库安装,然后单击 下一步。
- 在 目标 字段中,输入或浏览到要安装 Liberty 运行时环境的目录。
如果输入不存在的路径,那么系统会在过程末尾当您单击完成时自动创建与该路径对应的文件夹。
- 选择 从归档安装新的运行时环境。
- 在 路径 字段中,输入或浏览到本地文件系统上的归档文件,然后单击 下一步。
- 在 " 安装附加组件 " 页面中,单击 安装 或 安装暂挂 以选择要在 Liberty 运行时环境上安装的附加组件归档文件。
安装多个附加组件归档文件时,可通过从本地文件系统安装和/或下载来安装附加组件归档文件。
此下载站点包含您可以从 Liberty Repository中选择的附加组件,例如运行时功能部件,样本或开放式源代码集成。
如果要从本地文件系统安装附加组件归档文件,请完成以下步骤:
- 单击 添加归档。
- 在附加组件归档字段中,输入或浏览到本地文件系统上的附加组件归档文件。
- 单击确定。
如果要从本地文件系统安装更多附加组件归档文件,请重复此过程直至完成操作。
如果要从定制存储库安装附加组件文件,请完成以下步骤:
- 要添加存储库,请单击配置存储库。
- 单击 新建 ...。
然后,将文件添加到附加组件文件的列表。
- 在 " 许可证接受 " 页面中,如果您接受许可条款,请选择 我接受所有许可协议的条款 ,然后单击 下一步。
如果要下载并安装 Liberty的免费开发者版本,请完成以下步骤:
- 选择 从归档或存储库安装,然后单击 下一步。
- 在 目标 字段中,输入或浏览到要安装 Liberty 运行时环境的目录。
如果输入不存在的路径,那么系统会在主过程末尾当您单击完成时自动创建与该路径对应的文件夹。
- 选择 从 ibm.com下载并安装新的运行时环境,选择运行时环境版本,然后单击 下一步。
- 在 " 安装附加组件 " 页面中,单击 安装 或 安装暂挂 以选择要在 Liberty 运行时环境上安装的附加组件归档文件。
您可以使用下列其中一种方法来安装附加组件归档文件:
- 从本地文件系统安装
- 通过下载文件来安装
- 在安装多个附加组件归档文件时使用上述两种方法的组合
如果要从本地文件系统安装附加组件归档文件,请完成以下步骤:
- 单击 添加归档。
- 在附加组件归档字段中,输入或浏览到本地文件系统上的附加组件归档文件。
- 单击确定。
如果要从本地文件系统安装更多附加组件归档文件,请重复此过程直至完成操作。
如果要从定制存储库安装附加组件文件,请完成以下步骤:
- 要添加存储库,请单击配置存储库。
- 单击 新建 ...。
然后,将文件添加到附加组件文件的列表。
- 在 " 许可证接受 " 页面中,如果您接受许可条款,请选择 我接受所有许可协议的条款 ,然后单击 下一步。
- 在 " Liberty 服务器 " 页面上,选择 Docker 容器中的服务器。
- 从 容器名称 菜单中选择 Docker 容器。
提示: 如果在 Container name 菜单中看不到 Docker 容器,请单击 刷新 以刷新列表。
- 输入 Liberty 服务器安全凭证。
用户名和
密码字段必须与用户注册表中定义的具有管理员角色的用户相对应。 如果工具找不到定义指定用户的基本用户注册表,那么将显示“
安全性验证”窗口。 如果工具显示“
安全性验证”窗口,请完成以下其中一个选项:
- 选择创建以添加使用您的值和管理员角色定义用户的基本用户注册表。
- 如果该用户在其他用户注册表类型中定义,请选择继续以继续。
- 选择 取消 以更改您输入的 User name 和 Password 。
- 在安全端口字段中输入服务器配置中指定的 HTTPS 端口。
- 单击完成。
结果
您已创建对 Docker 容器中运行的服务器的工作台服务器引用。
- 要查看您创建的服务器及其服务器配置,请打开“服务器”视图。
- 要查看项目、服务器文件夹和服务器配置文件,请打开“企业资源管理器”视图。