一个 JBoss 项目
Red Hat

操作指南

在 IDE 中创建 OpenShift 应用程序

创建一个新的 OpenShift 连接

如需在 IDE 中使用 OpenShift tooling,首先必须创建 OpenShift 连接。创建新的 OpenShift 连接的方法:

  1. OpenShift Explorer 视图中,单击 New Connection Wizard。如果 OpenShift Explorer 视图不可用,请依次单击 Window > Show View > Other,然后在 Show View 窗口中搜索 OpenShift Explorer,并在找到后单击 OK

  2. New OpenShift Connection 向导中

    1. Connection 列表中,单击 <New Connection>

    2. Server 字段中,键入 OpenShift 服务器的 URL。

    3. Authentication 部分中,在 Protocol 列表中,单击 OAuth 以使用令牌进行身份验证,或者单击 Basic 以使用登录凭据进行身份验证。

  3. 单击 Finish

Set up a New OpenShift Connection
图 1. 设置新的 OpenShift 连接

结果:连接已列在 OpenShift Explorer 视图中。

创建一个新的 OpenShift 项目

创建新的 OpenShift 项目的方法:

  1. OpenShift Explorer 视图中,右键单击连接,然后单击 New > Project

  2. Create OpenShift Project 窗口中

    1. Project Name 字段中,键入项目的名称。项目名称必须是字母数字,可以包含字符“-”,但不能以该字符开头或结尾。

    2. Display Name 字段中,键入项目的显示名称。该名称用作项目在 OpenShift 项目创建后的 OpenShift Explorer 视图以及 OpenShift Web 控制台中的显示名称。

    3. Description 字段中,键入项目的描述。

  3. 单击 Finish

结果:项目将列在相关连接下的 OpenShift Explorer 视图中。

创建新的 OpenShift 应用程序

使用 新 OpenShift 应用程序向导,可以从默认或自定义模板中创建 OpenShift 应用程序。使用模板来创建应用程序很有用,因为同一个模板可用于创建多个相似的应用程序,每个应用程序具有不同或相同的配置。

如需了解如何使用和创建 OpenShift 模板的更多信息,请参阅 在 OpenShift 中使用模板

  1. OpenShift 资源管理器视图中,右键单击连接,然后单击 新建 > 应用程序

  2. 如果需要,在 新 OpenShift 应用程序向导中,使用 基本协议(用户名和密码)或 OAuth 协议(令牌)登录到您的 OpenShift 服务器,然后单击 下一步

  3. 选择模板窗口中,单击 服务器应用程序源选项卡。

    要从本地模板创建应用程序,请单击 本地模板选项卡,然后单击 浏览文件系统浏览工作区,以找到您希望将其用作项目基础的模板。

  4. 从列表中,单击您希望将其用作项目基础的模板。您还可以使用 类型过滤器文本字段来搜索特定的模板。

  5. 单击 下一步

    Select a Template for Project Creation
    图 2. 选择一个用于项目创建的模板
  6. 模板参数窗口中,确认参数值,然后单击 下一步

  7. 资源标签窗口中,确认您希望添加到每个资源的标签。您还可以单击 添加编辑来添加标签或编辑现有标签。

  8. 单击 Finish

  9. [template_name]创建资源的结果窗口中,查看详细信息,然后单击 确定

  10. 导入应用程序窗口中,单击 使用默认克隆目标以便在默认位置克隆应用程序,或在 Git 克隆位置字段中,输入或浏览您希望在其中克隆应用程序的位置,然后单击 完成

    Select a Git Clone Location
    图 3. 选择一个 Git 克隆位置

    如果您选择用于克隆应用程序的 Git 位置已经包含了具有您正在尝试导入的应用程序名称的文件夹,则您必须为 Git 克隆选择一个新位置。如果您不选择一个新位置,您做出的更改将被保留在现有的存储库中,但不会反映在 OpenShift 控制台中。

    Git Clone Location Reuse
    图 4. Git 克隆位置重用

结果: 应用程序会显示在 项目资源管理器视图中。

将现有 OpenShift 应用程序导入到 IDE

仅当其源在 build config 文件中指定的应用程序才能导入到工作区中。

与 OpenShift 帐户关联的应用程序列在 OpenShift Explorer 视图中。可以分别使用 OpenShift 工具 导入 OpenShift 应用程序 向导将这些应用程序的源代码导入到 IDE 中。导入后,用户可以根据需要轻松修改应用程序源代码、构建应用程序并使用 Web 浏览器查看应用程序。

将现有的 OpenShift 应用程序作为新项目导入现有 IDE 工作区

  1. 如有需要,请使用 基本 协议或 OAuth 协议登录 OpenShift 服务器。

  2. OpenShift Explorer 视图中,展开连接以找到要导入的应用程序。

  3. 右键单击 {项目名称},然后单击 导入应用程序

    若要从服务导入特定应用程序,请右键单击该服务,然后单击 导入应用程序。如果你右键单击一个项目,然后单击 导入应用程序,并且项目下有多个带有源代码的构建配置,则会提示你选择要导入的所需应用程序,因为一个项目下有几个应用程序。

  4. 导入 OpenShift 应用程序 向导中,单击 现有构建配置 列表中要导入的应用程序,然后单击 下一步

  5. 确保 Git 克隆目标 字段中的位置与你想要创建 OpenShift 应用程序 Git 存储库的本地副本的位置相对应,然后单击 完成

结果: 应用程序列在 项目资源管理器 视图中。

使用服务器适配器部署应用程序

服务器适配器允许将应用程序增量部署到 OpenShift 中已部署的 pod 中。

部署应用程序

  1. OpenShift Explorer 视图中,展开连接、项目,然后展开应用程序。

  2. 右键单击 {应用程序名称},然后单击 服务器适配器。在 服务器设置 窗口的 服务 部分中,选择服务。

    如果 OpenShift 服务具有构建配置的 Git URL 与工作区项目之一的 Git 远程 URL 相匹配,那么工作区项目将自动选中。

  3. 单击 Finish

结果: 服务器 视图是焦点视图,服务器显示 [已启动,正在发布…],然后 控制台 视图显示应用程序发布的进度。

Console View Showing Application Publication Progress
图 5. 显示应用程序发布进度的控制台视图

在 Web 浏览器中查看现有应用程序

若要在应用程序成功部署后在内部 Web 浏览器中查看它,请在 OpenShift Explorer 视图中右键单击该应用程序,然后单击 显示在 > Web 浏览器

结果: 该应用程序显示在内置 Web 浏览器中。

删除 OpenShift 项目

您可以选择从工作空间删除某个项目,以重新开始项目开发,或者在结束一个项目的开发后将其删除。删除项目后,与该项目相关的所有资源都将被删除。

要删除 OpenShift 项目

  1. OpenShift Explorer 视图中,展开连接,然后展开项目,以找到要删除的应用程序。

  2. 右键单击 {project name},然后单击 Delete Project

  3. OpenShift resource deletion 窗口中,单击 OK

要删除多个项目(及所包含的应用程序),请在 OpenShift Explorer 视图中,单击要删除的项目将其选中,然后在按住 Control 键的同时选择另一个要删除的项目,再按 Delete。

您知道吗

  • 使用服务(项目下方的第一个节点)的上下文菜单缩放项目部署。也可以通过部署复制代码复制(复制控制器)和部署配置的 Properties 选项卡缩放部署。

  • Console 视图中查看 rsync 输出。还可以看到将本地更改发布到 OpenShift 后的文件传输进度。

返回顶部