分布式: [AIX MacOS Linux Windows]

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

使用 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 命令:
    1. 将以下行添加到 eclipse.ini 文件:
      -Dcom.ibm.ws.st.envPath=<Docker commands directory>
    2. 重新启动 Eclipse。

有关此任务

您可以安装 WebSphere Application Server Liberty ,并从 WASdev 社区下载站点下载 Liberty Repository 中的附加组件。 安装 Liberty后,可以选择 Docker 容器。 然后,您可以输入 Liberty 服务器的 Liberty 服务器安全凭证,以在 Docker 容器中创建对 Liberty 服务器的工作台引用。

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

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

过程

  1. 在工作台中,通过单击 服务器 选项卡打开 " 服务器 " 视图。
    提示: 如果 " 服务器 " 视图不可见,请选择 窗口 > 显示视图 > 其他 ... 并在过滤器文本中输入 Server 。 然后,选择 服务器
  2. 右键单击 " 服务器 " 视图,然后选择 新建 > 服务器
  3. 要选择服务器类型,请选择 IBM > Liberty Server
  4. 服务器的主机名 字段中输入 localhost 值。
  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. 在 " Liberty 服务器 " 页面上,选择 Docker 容器中的服务器
  8. 容器名称 菜单中选择 Docker 容器。
    提示: 如果在 Container name 菜单中看不到 Docker 容器,请单击 刷新 以刷新列表。
  9. 输入 Liberty 服务器安全凭证
    用户名密码字段必须与用户注册表中定义的具有管理员角色的用户相对应。 如果工具找不到定义指定用户的基本用户注册表,那么将显示“安全性验证”窗口。 如果工具显示“安全性验证”窗口,请完成以下其中一个选项:
    • 选择创建以添加使用您的值和管理员角色定义用户的基本用户注册表。
    • 如果该用户在其他用户注册表类型中定义,请选择继续以继续。
    • 选择 取消 以更改您输入的 User namePassword
  10. 在安全端口字段中输入服务器配置中指定的 HTTPS 端口。
  11. 单击完成

结果

您已创建对 Docker 容器中运行的服务器的工作台服务器引用。

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

下一步做什么?

  • 可以编辑服务器配置。 有关更多信息,请参阅 使用开发者工具编辑 Liberty 配置
    限制: 工具不支持使用服务器配置中的绝对路径指定包含文件。 要解决此问题,请通过使用预定义服务器变量(例如,server.config.dirshared.config.dir)而不是使用绝对路径来指定包含路径。
  • 启动或停止服务器,或者在服务器上添加或除去应用程序,请右键单击服务器以使用 服务器上下文菜单 或使用 " 服务器 " 视图中的托盘按钮。
    提示: 要访问这些选项,请在 " 服务器 " 视图中选择 服务器条目 。 请勿选择诸如服务器配置server.xml 条目的服务器配置。
  • 您可以配置 Liberty 服务器以向 Tivoli® Directory Server认证用户。
    1. 右键单击 服务器
    2. 选择 实用程序 > 添加配置片段
    3. 选择片段并接受许可协议。
    工具下载您所选的配置片段,并将它们添加到 server.xml 文件。
  • 您可以在产品文档中 创建和编辑服务器环境文件