分布式: [AIX MacOS Linux Windows]

使用开发者工具在 Docker 容器中创建远程 Liberty 服务器

您可以使用 WebSphere® Developer Tools 来创建对远程主机上的 Docker 容器中运行的 Liberty 服务器的引用。 可以使用此引用从工作台处理服务器请求。

准备工作

  • 安装 WebSphere Developer Tools。
    重要信息: 工具支持 Docker V 1.10.2 和更高版本。
  • 在 Docker 容器中启动远程服务器,并确保超文本传输协议 (HTTP) 和安全超文本传输协议 (HTTPS) 端口都映射到主机。 有关在 Docker 容器中启动远程 Liberty服务器的更多信息,请参阅 WASdev GitHub
  • 对于 macOS 平台以下列表包含 Mac 操作系统与 Docker 工具箱的信息。 此信息不适用于 Mac 的本机 Docker。
    • 要阻止每次启动容器时端口号发生更改,请使用 -p 选项而不是 -P 选项映射容器上的端口。
    • 要使端口对远程机器可见,请转发 Docker 机器的 VirtualBox 网络地址转换 (NAT) 适配器中的端口。
    • 将端口转发到相同端口号。 例如,如果指定了 -p 8001:9080,那么主机端口和访客端口为 8001。 同时转发 HTTP 端口和 HTTPS 端口。
    • 要进行调试,还需转发调试端口。 缺省调试端口为 7777

有关此任务

您可以安装 WebSphere Application Server Liberty ,并从 WASdev 社区下载站点下载 Liberty Repository 中的附加组件。 安装 Liberty后,可以选择 Docker 容器。 然后,可以输入 Liberty 服务器安全凭证以访问 Docker 容器中的远程 Liberty 服务器。 如果您没有 Liberty 服务器安全凭证,那么这些工具可以为您创建这些凭证。

如果在您完成这些步骤时 Docker 命令超时,您可以解决此问题。 请将 com.ibm.ws.st.DockerCommandTimeoutInSeconds 系统属性设置为以秒为单位的时间。 缺省情况下,此属性设置为 10

重要信息: 对于在 Docker 容器中运行的 Liberty 服务器,无法选择 下次启动时清除服务器

过程

  1. 在工作台中,通过单击 服务器 选项卡打开 " 服务器 " 视图。
    提示: 如果 " 服务器 " 视图不可见,请选择 窗口 > 显示视图 > 其他 ... 并在过滤器文本中输入 Server 。 然后,选择 服务器
  2. 在 " 服务器 " 视图中右键单击,然后选择 新建 > 服务器
  3. 要选择服务器类型,请选择 IBM > Liberty Server
  4. 服务器的主机名 字段中输入远程主机名。
  5. 单击下一步
    注: 确保 Liberty 运行时环境具有与所选 Liberty Docker 映像相同的功能部件集。 另外,请确保将它们配置为使用同一级别的 Java™ 运行时环境 (JRE)。 Liberty 运行时环境目标运行时在开发环境中使用。 本地系统运行时与 Liberty Docker 映像中使用的 JRE 不匹配可能导致从配置错误到应用程序发布问题的问题。
  6. 如果工具提示您安装 WebSphere Application Server Liberty,因为它未安装,或者因为您需要输入安装目录,请完成下列其中一个选项。 否则,请跳过此步骤。

    您需要安装 Liberty ,以便可以在远程主机上的 Docker 容器中创建对 Liberty 服务器的工作台引用。

    如果先前安装了 Liberty,请完成以下步骤以选择安装该 Liberty 的目录:

    1. 选择 选择现有安装
    2. 路径 字段中,输入或浏览 WebSphere Application Server Liberty的安装目录。
    3. 在 " Liberty 运行时环境 " 页面上,单击 下一步

      应用程序服务环境已选中。 跳过此步骤的其余部分。

    如果要从先前下载的归档文件安装 Liberty ,请完成以下步骤:

    1. 选择 从归档或存储库安装,然后单击 下一步
    2. 目标 字段中,输入或浏览到要安装 Liberty 运行时环境的目录。

      如果输入不存在的路径,那么系统会在过程末尾当您单击完成时自动创建与该路径对应的文件夹。

    3. 选择 从归档安装新的运行时环境
    4. 路径 字段中,输入或浏览到本地文件系统上的归档文件,然后单击 下一步
    5. 在 " 安装附加组件 " 页面中,单击 安装安装暂挂 以选择要在 Liberty 运行时环境中安装的附加组件归档文件。

      安装多个附加组件归档文件时,可通过从本地文件系统安装和/或下载来安装附加组件归档文件。

      此下载站点包含您可以从 Liberty Repository中选择的附加组件,例如运行时功能部件,样本或开放式源代码集成。

      如果要从本地文件系统安装附加组件归档文件,请完成以下步骤:
      1. 单击 添加归档
      2. 附加组件归档字段中,输入或浏览到本地文件系统上的附加组件归档文件。
      3. 单击确定
      如果要从本地文件系统安装更多附加组件归档文件,请重复此过程直至完成操作。
      如果要从定制存储库安装附加组件文件,请完成以下步骤:
      1. 要添加存储库,请单击配置存储库
      2. 单击 新建 ...
      然后,将文件添加到附加组件文件的列表。

      在“安装附加组件”页面上完成选择后,单击下一步

    6. 在 " 许可证接受 " 页面中,如果您接受许可条款,请选择 我接受所有许可协议的条款,然后单击 下一步

    如果要下载并安装 Liberty的免费开发者版本,请完成以下步骤:

    1. 选择 从归档或存储库安装,然后单击 下一步
    2. 目标 字段中,输入或浏览到要安装 Liberty 运行时环境的目录。

      如果输入不存在的路径,那么系统会在主过程末尾当您单击完成时自动创建与该路径对应的文件夹。

    3. 选择 从 ibm.com下载并安装新的运行时环境,选择运行时环境版本,然后单击 下一步
    4. 在 " 安装附加组件 " 页面中,单击 安装安装暂挂 以选择要在 Liberty 运行时环境中安装的附加组件归档文件。
      您可以使用下列其中一种方法来安装附加组件归档文件:
      • 从本地文件系统安装
      • 通过下载文件来安装
      • 在安装多个附加组件归档文件时使用上述两种方法的组合
      如果要从本地文件系统安装附加组件归档文件,请完成以下步骤:
      1. 单击 添加归档
      2. 附加组件归档字段中,输入或浏览到本地文件系统上的附加组件归档文件。
      3. 单击确定
      如果要从本地文件系统安装更多附加组件归档文件,请重复此过程直至完成操作。
      如果要从定制存储库安装附加组件文件,请完成以下步骤:
      1. 要添加存储库,请单击配置存储库
      2. 单击 新建 ...
      然后,将文件添加到附加组件文件的列表。

      在“安装附加组件”页面上完成选择后,单击下一步

    5. 在 " 许可证接受 " 页面中,如果您接受许可条款,请选择 我接受所有许可协议的条款 ,然后单击 下一步
  7. 在 " 远程服务器设置 " 页面上,选择 Docker 容器中的服务器
  8. 选择远程服务器的操作系统。
    限制: 这些工具不支持 Windows 操作系统的操作系统认证。
  9. 选择用于访问远程主机的方法,输入登录信息,然后单击 下一步
  10. 在 " 新建 Docker 容器中的服务器 " 页面上,从 容器名称 菜单中选择 Docker 容器。
    提示: 如果在 容器名称 菜单中看不到 Docker 容器,请单击 刷新 以刷新列表。
  11. 输入 Liberty 服务器安全凭证
    用户名密码字段必须与用户注册表中定义的具有管理员角色的用户相对应。 如果工具找不到定义指定用户的基本用户注册表,那么将显示“安全性验证”窗口。 如果工具显示“安全性验证”窗口,请完成以下其中一个选项:
    • 选择创建以添加使用您的值和管理员角色定义用户的基本用户注册表。
    • 如果该用户在其他用户注册表类型中定义,请选择继续以继续。
    • 选择 取消 以更改您输入的 User namePassword
  12. 在安全端口字段中输入服务器配置中指定的 HTTPS 端口。
    提示: 默认的 HTTPS 端口号是 9443
  13. 单击完成

结果

您已创建对远程主机上的 Docker 容器中运行的 Liberty 服务器的引用。

  • 要查看您创建的服务器及其服务器配置,请打开“服务器”视图。
  • 要查看项目、服务器文件夹和服务器配置文件,请打开“企业资源管理器”视图。

下一步做什么?

限制: 对于远程 Liberty Docker 服务器,这些工具不支持服务器实用程序。
  • 可以编辑服务器配置。
    限制: 对于远程服务器,工具不支持使用服务器配置中的绝对路径来指定包含文件。 要解决此问题,请通过使用预定义服务器变量(例如,server.config.dirshared.config.dir)而不是使用绝对路径来指定包含路径。
  • 启动或停止服务器,或者在服务器上添加或除去应用程序,请右键单击服务器以使用服务器上下文菜单或使用 " 服务器 " 视图中的托盘按钮。
    提示: 要访问这些选项,请在 " 服务器 " 视图中选择 Liberty 服务器。 如果您在“服务器”视图中选择任何其他条目,那么服务器上下文菜单将不可用。
  • 您可以在产品文档中 创建和编辑服务器环境文件