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

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

开始之前

  • 安装 WebSphere Developer Tools。有关安装 WebSphere Developer Tools 的更多信息,请参阅安装 Liberty 开发者工具和(可选)Liberty
  • 安装 Docker。这些工具支持 Docker V1.10.2 和更高版本。有关安装 Docker 的更多信息,请参阅Liberty 中的 Docker 支持
  • [16.0.0.4 及更高版本]使用 Docker Tooling 管理 Docker 映像和容器。要使用 Docker Tooling 功能部件,请安装 WebSphere Application Server Liberty Docker Tools(其中包含Docker Tooling)。有关 Docker Tooling 的更多信息,请参阅 Linux Tools Project/Docker Tooling/User Guide
  • 在本地 Docker 容器中启动 Liberty 服务器,并确保 HTTP 和 HTTPS 端口都映射到主机。有关在本地 Docker 容器中启动 Liberty 服务器的更多信息,请参阅 WASdev GitHub
  • 如果您使用的是 Mac OS,那么缺省情况下 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. 在工作台中,通过单击服务器选项卡来打开“服务器”视图。
    提示: 如果“服务器”视图不可视,请选择窗口 > 显示视图 > 其他...,并在过滤器文本中输入服务器。然后,选择服务器
  2. 右键单击服务器视图,然后选择新建 > 服务器
  3. 要选择服务器类型,请选择 IBM > WebSphere Application Server Liberty
  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 运行时环境上安装的附加组件归档文件。

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

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

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

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

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

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

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

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

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

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

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

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

    5. 在“接受许可协议”页面中,如果接受许可条款,请选择我接受所有许可协议的条款,然后单击下一步
  7. 在“Liberty 服务器”页面上,选择 Docker 容器中的服务器
  8. 容器名称菜单中选择 Docker 容器。
    提示: 如果您在容器名称菜单中看不到您的 Docker 容器,请单击刷新以刷新列表。
  9. 输入“Liberty 服务器安全凭证”。
    用户名密码字段必须与用户注册表中定义的具有管理员角色的用户相对应。如果工具找不到定义指定用户的基本用户注册表,那么将显示“安全性验证”窗口。如果工具显示“安全性验证”窗口,请完成以下其中一个选项:
    • 选择创建以添加使用您的值和管理员角色定义用户的基本用户注册表。
    • 如果该用户在其他用户注册表类型中定义,请选择继续以继续。
    • 选择取消以更改您输入的用户名密码
  10. 安全端口字段输入服务器配置中指定的 HTTPS 端口值。
  11. 单击完成

结果

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

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

下一步做什么

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

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



时间戳记图标 最近一次更新时间: Tuesday, 6 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=t_creating_server_docker
文件名:t_creating_server_docker.html