For distributed platforms

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

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

开始之前

  • 安装 WebSphere Developer Tools。
    要点: 这些工具支持 Docker V1.10.2 和更高版本。
  • 在 Docker 容器中启动远程服务器,并确保超文本传输协议 (HTTP) 和安全超文本传输协议 (HTTPS) 端口都映射到主机。有关启动 Docker 容器中远程 Liberty 服务器的更多信息,请参阅 WASdev GitHub

关于此任务

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

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

要点: 对于 Docker 容器中正在运行的 Liberty 服务器,您不能选中下次启动时清除服务器

过程

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

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

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

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

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

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

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

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

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

      安装多个附加组件归档文件时,可通过从本地文件系统安装和/或下载来安装附加组件归档文件。如果工作台已连接至互联网,那么系统会使用可从 WAS 开发社区下载站点下载的附加组件归档文件来填充“安装附加组件”页面。

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

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

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

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

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

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

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

    3. 选择从 ibm.com 下载并安装新的运行时环境,选择运行时环境版本,然后单击下一步
    4. 在“安装附加组件”页面中,单击安装安装暂挂以选择要在 Liberty 运行时环境上安装的附加组件归档文件。
      您可以使用下列其中一种方法来安装附加组件归档文件:
      • 从本地文件系统安装
      • 通过下载文件来安装
      • 在安装多个附加组件归档文件时使用上述两种方法的组合
      如果工作台已连接至互联网,那么系统会使用可从 WAS 开发社区下载站点下载的附加组件归档文件来填充“安装附加组件”页面。

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

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

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

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

结果

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

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

下一步做什么

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

用于指示主题类型的图标 任务主题

文件名:t_creating_remote_server_docker.html