JBoss 项目
红帽

操作指南

使用 IDE 的容器开发套件工具

关于使用容器开发套件与 IDE

Red Hat 容器开发套件 (CDK) 是基于 Red Hat Enterprise Linux 的预构建容器开发环境。CDK 可帮助您快速开始基于容器的应用程序开发。您可以轻松设置 CDK,然后通过 IDE 使用 OpenShift 容器平台和 Docker 等工具,而无需花费额外的时间来设置和配置补充工具。

以下两种方法可以将 CDK 与 DevStudio 一起安装

安装完成后,您可以将安装的组件与 Docker 工具一起使用。

使用红帽开发套件安装程序安装 CDK 和 DevStudio

使用红帽开发套件 (DevSuite) 安装程序来安装 CDK、DevStudio 和其他相关组件。安装程序会自动配置这些组件以协同使用。此选项目前适用于 Windows、macOS 和 RHEL 7。有关使用 DevSuite 安装程序的说明,请参阅 Red Hat 开发套件安装指南

安装配置 CDK 工具(创建 CDK 服务器适配器,传递用于安装程序中使用的 access.redhat.com 域的用户凭据)。这使得 CDK 工具可以在 IDE 中使用。安装完成后,直接从安装程序运行 DevStudio,打开“服务器”视图并启动容器开发环境服务器适配器。这将启动 CDK 并创建 OpenShift 容器平台和 Docker 连接。请注意,如果您关闭安装程序窗口,然后运行 DevStudio,您的用户凭据将不会自动传递,您必须手动输入您的用户凭据。

分别安装 CDK 和 IDE

您可以分别下载并安装 CDK 和 IDE。此选项需要在将两者一起使用之前执行一些额外的配置步骤。

先决条件

确保您的系统上已安装以下内容

  • 确保您的系统已启用硬件虚拟化

  • 确保您的系统上已安装以下内容

    • 已安装并配置了虚拟机管理程序,例如 VirtualBox、Linux KVM/libvirt、xhyve (macOS) 或 hyper-V (Windows)

    • CDK 3.1

    • DevStudio 11.0

  • 确保您拥有 Red Hat 开发人员帐户。如需新建帐户,请访问 https://developers.redhat.com/

有关安装这些先决条件的详细信息,请参阅 Red Hat 容器开发套件安装指南

在 IDE 中设置 CDK 连接

要在 IDE 中设置 CDK 连接,请执行以下操作

  1. 启动 IDE。

  2. 按 Ctrl+3,在“快速访问”栏中键入 CDK

  3. 从结果中,单击“使用 Red Hat CDK 启动容器开发环境”。

  4. 如果出现提示,请输入您的用户凭据。

  5. 在“新建服务器”对话框中

    1. 确保默认情况下已选择“Red Hat 容器开发”。

    2. 在“服务器的主机名”字段中,键入所需的服务器主机名。

    3. 在“服务器名称”字段中,键入所需的服务器名称。

  6. 单击“下一步”继续。

    Selecting Red Hat Container Development Kit 3
    图 1. 选择 Red Hat 容器开发套件 3
  7. 在“新建服务器 Red Hat 容器开发环境”窗口中,添加安全信息和您的 access.redhat.com 凭据

    1. 在“域”字段中,确保 access.redhat.com 出现。

    2. 在“用户名”字段中,确保您的用户名出现。

    3. 在“虚拟机管理程序”字段中,确保出现了与您的操作系统相关的虚拟化系统。

    4. 在“Minishift 二进制文件”字段中,确保出现了安装 minishift 的目录的位置。

  8. 单击“完成”。

    Entering User Credentials
    图 2. 输入用户凭据
  9. 如果出现提示,在“安全存储密码”窗口的“密码”字段中,键入您的密码,然后单击“确定”。

  10. 打开“服务器”视图,右键单击容器开发环境服务器适配器,然后单击“启动”。

  11. “控制台”视图是显示启动容器开发环境进度的视图。

  12. 如果出现提示,在“不受信任的 SSL 证书”对话框中,单击“是”。

结果:IDE 的“控制台”视图中将显示“使用 ‘kvm’ 虚拟机管理程序启动本地 OpenSHift 集群”消息。

如果您尚未登录到 OpenShift 容器平台帐户,则会显示“新建 OpenShift 连接”向导。创建新的连接,或使用“基本”或“OAuth”协议登录到现有帐户。

打开“OpenShift 资源管理器”视图以查看您已连接到的 OpenShift 容器平台的 IP 地址和端口:developer {connection_IP}(例如,developer https://10.1.2.2:8443)。展开连接以查看示例项目。您还可以打开“Docker 资源管理器”视图以查看容器开发环境连接,并展开连接以查看容器和镜像。选择继续在 DevStudio 中使用 OpenShift 容器平台,或查看在 DevStudio 中进行基于容器的开发的说明。

使用 Docker 工具

在 IDE 中启动 CDK 服务器后,您可以遵循以下两种容器开发工作流之一

使用 Docker 进行基于容器的开发

按照以下步骤使用 Docker 进行基于容器的开发

  1. 使用您的 Dockerfile 创建新项目。

    1. 单击“文件”>“新建”>“项目”。

    2. 在搜索栏中键入 java,从结果中选择“Java 项目”,然后单击“下一步”继续。

    3. 在“项目名称”字段中,键入新项目的名称,然后单击“完成”。“项目资源管理器”视图将显示您刚刚创建的项目。

    4. 单击“文件”>“新建”>“文件”。

    5. 在“新建文件”窗口中

      1. 在“输入或选择父文件夹”字段中,单击您创建的项目。

      2. 在“文件名”字段中,键入 Dockerfile,然后单击“完成”。

    6. 根据需要编辑 Dockerfile,然后保存它。例如,将以下内容复制并粘贴到 dockerfile 中,然后保存文件

          # Use latest jboss/base-jdk:8 image as the base
      FROM jboss/base-jdk:8
      
      # Set the WILDFLY_VERSION env variable
      ENV WILDFLY_VERSION 10.1.0.Final
      ENV WILDFLY_SHA1 9ee3c0255e2e6007d502223916cefad2a1a5e333
      ENV JBOSS_HOME /opt/jboss/wildfly
      
      USER root
      
      # Add the WildFly distribution to /opt, and make wildfly the owner of the extracted tar content
      # Make sure the distribution is available from a well-known place
      RUN cd $HOME \
          && curl -O https://download.jboss.org/wildfly/$WILDFLY_VERSION/wildfly-$WILDFLY_VERSION.tar.gz \
          && sha1sum wildfly-$WILDFLY_VERSION.tar.gz | grep $WILDFLY_SHA1 \
          && tar xf wildfly-$WILDFLY_VERSION.tar.gz \
          && mv $HOME/wildfly-$WILDFLY_VERSION $JBOSS_HOME \
          && rm wildfly-$WILDFLY_VERSION.tar.gz \
          && chown -R jboss:0 ${JBOSS_HOME} \
          && chmod -R g+rw ${JBOSS_HOME}
      
          # Ensure signals are forwarded to the JVM process correctly for graceful shutdown
          ENV LAUNCH_JBOSS_IN_BACKGROUND true
      
          USER jboss
      
          # Expose the ports we're interested in
          EXPOSE 8080
      
          # Set the default command to run on boot
          # This will boot WildFly in the standalone mode and bind to all interface
          CMD ["/opt/jboss/wildfly/bin/standalone.sh", "-b", "0.0.0.0"]
      ).

      有关 Dockerfile 的更多信息,请参阅 https://docs.docker.net.cn/engine/reference/builder

使用容器开发环境构建 Docker 镜像

要使用容器开发环境执行 Docker 镜像构建,请执行以下操作

  1. 在“项目资源管理器”视图中,展开项目,右键单击 Dockerfile,然后选择“以...方式运行”>“Docker 镜像构建”。

  2. 在“Docker 镜像构建配置”对话框中

    1. 在“连接”字段中,选择您的容器开发环境服务器适配器。

    2. 在“镜像名称”字段中,输入 Docker 镜像的所需名称,然后单击“确定”。构建完成后,新的镜像将以指定的名称列在“Docker 资源管理器”视图中,位于 CDK Docker 连接的“镜像”下,以及“Docker 镜像”视图中。此外,“控制台”视图将显示“已成功构建 <Docker_image_ID>”消息。

  3. 使用容器开发环境运行 Docker 镜像

    1. 通过在快速访问菜单中键入 Ctrl+3 或使用“窗口”>“透视图”>“打开透视图”>“Docker 工具”菜单选项来打开“Docker 资源管理器”视图。

    2. 导航到 Docker 连接下的“镜像”节点。

    3. 右键单击您的镜像,然后单击“运行”。

    4. 在“运行 Docker 镜像”窗口中,填写必要的详细信息,然后单击“完成”以运行您的镜像。“控制台”视图将显示 Docker 镜像执行的进度。可选择为容器命名。此名称有助于将来在容器列表中找到特定容器。

    5. 在“Docker 资源管理器”视图中,选择您在上一步中命名的容器,展开其节点,选择 8080 端口,然后单击“显示于”>“Web 浏览器”以访问部署在 Docker 容器中的应用程序。该应用程序将在默认的 Web 浏览器中打开。

Docker 工具的后续步骤

有关 Docker 工具基本知识的更多信息,请参阅 配置 Docker 工具(基本)

使用 OpenShift 容器平台工具

按照以下步骤使用 OpenShift 容器平台进行基于容器的开发

  1. 创建新的 OpenShift 容器平台项目。这些项目类似于 OpenShift 应用程序的命名空间。它们与 Eclipse 项目与 Eclipse 应用程序的关系不同。此外,Eclipse 项目可以映射到 OpenShift 应用程序。

    1. 在“OpenShift 资源管理器”视图中,右键单击连接,然后单击“新建”>“项目”以创建新的 OpenShift 容器平台项目。

      当您在上几节中启动 CDK 服务器适配器时,CDK 服务器适配器会创建 OpenShift 容器平台连接。

    2. 添加新项目的名称和其他相关详细信息,然后单击“完成”。

  2. 使用模板在 OpenShift 容器平台项目中创建应用程序

    1. 右键单击您的新项目名称,然后单击“新建”>“应用程序”。

    2. 在“新建 OpenShift 应用程序”窗口的搜索框中,键入所需的应用程序类型。例如,对于 node.js 应用程序,键入 nodejs,然后从显示的列表中选择相关的 nodejs 模板,并单击“完成”。

    3. 单击“确定”以接受应用程序创建过程的结果。

    4. 在“导入 OpenShift 应用程序”窗口中,选择一个“Git 克隆位置”,然后单击“完成”。

OpenShift 工具的后续步骤

有关使用 OpenShift Container Platform 工具执行的其他任务,请参阅 使用 OpenShift 开发云应用程序

已知问题

  • 首次启动 Docker Explorer 时,尝试扩展容器或映像会导致 Explorer 失败并抛出异常。要解决此问题,请重新启动 Eclipse/JBoss Developer Studio。详细信息请参阅 JBIDE-21983

返回顶部