第 5 章 开发人员入门

5.1. 准备开发环境

在 OpenShift 项目中开发和测试 Fuse 的根本要求是能够访问 OpenShift 服务器。您有以下基本替代方案：

5.1.1. 在本地机器上安装容器开发套件(CDK)

作为开发人员，如果您想要快速启动，最实用的替代方案是在您的本地机器上安装 Red Hat CDK。使用 CDK，您可以引导在 Red Hat Enterprise Linux (RHEL) 7 上运行 OpenShift 镜像的虚拟机(VM)实例。CDK 的安装由以下关键组件组成：

  • 虚拟机(libvirt、VirtualBox 或 Hyper-V)
  • Minishift 来启动和管理容器开发环境
重要

Red Hat CDK 仅用于开发目的。它不适用于其他目的，如生产环境，可能无法解决已知的安全漏洞。为了获得对在使用 docker 格式的容器中运行的业务关键型应用程序的完全支持，您需要一个有效的 RHEL 7 或 RHEL Atomic 支持。如需了解更多详细信息，请参阅 对 Red Hat Container Development Kit (CDK)的支持。

先决条件

  • Java 版本

    在开发人员计算机上，确保您已安装了由 Fuse 7.10 支持的 Java 版本。有关支持的 Java 版本的详情，请参阅 支持的配置。

流程

在本地机器上安装 CDK：

  1. 对于 OpenShift 上的 Fuse，我们建议您安装 CDK 的版本 3.17。有关安装和使用 CDK 3.17 的详细信息，请参阅 Red Hat CDK 3.17 入门指南。
  2. 按照 为容器镜像验证 registry.redhat.io 中的说明，将 OpenShift 凭证配置为可以访问红帽生态系统目录。

  3. 在 OpenShift 镜像和模板上安装了 Fuse，如 第 2 章 管理员入门 所述。

    注意

    您的 CDK 版本可能预安装了 Fuse on OpenShift 镜像和模板。但是，在配置 OpenShift 凭据后，您必须在 OpenShift 镜像和模板上安装（或更新 Fuse）。

  4. 在进行本章中的示例之前，您应该阅读并全面了解 Red Hat CDK 3.17 入门指南。

5.1.2. 远程访问现有 OpenShift 服务器

您的 IT 部门可能已在某些服务器计算机上设置了 OpenShift 集群。在这种情况下，在 OpenShift 中使用 Fuse 时必须满足以下要求：

  • 服务器机器必须运行受支持的 OpenShift Container Platform 版本（如 支持的配置页面 中所述）。本指南中的示例针对版本 3.11 进行了测试。
  • 要求 OpenShift 管理员在 OpenShift 容器基础镜像和 OpenShift 服务器上的 OpenShift 模板上安装最新的 Fuse。
  • 要求 OpenShift 管理员为您创建用户帐户，具有常见的开发人员权限（允许您创建、部署和运行 OpenShift 项目）。
  • 询问管理员输入 OpenShift 服务器的 URL （您可以使用它浏览 OpenShift 控制台或使用 oc 命令行客户端连接到 OpenShift）以及帐户的登录凭据。

5.1.3. 安装客户端工具

我们建议您在开发人员机器上安装以下工具：

  • Apache Maven 3.6.x：本地构建的 OpenShift 项目需要。从 Apache Maven 下载页面下载 相应的软件包。确保您至少安装了 3.6.x 版本（或更新版本），否则 Maven 在构建项目时可能会遇到解决依赖项的问题。
  • Git：OpenShift S2I 源工作流需要，并通常建议在 OpenShift 项目中对 Fuse 进行源控制。从 Git Downloads 页面下载适当的软件包。

  • OpenShift 客户端：如果您使用 CDK，您可以使用 minishift oc -env 将 oc 二进制文件添加到 PATH 中，这显示您需要键入的命令( oc-env 的输出会根据 OS 和 shell 类型的不同而有所不同)： 

    $ minishift oc-env
export PATH="/Users/john/.minishift/cache/oc/v1.5.0:$PATH"
# Run this command to configure your shell:
# eval $(minishift oc-env)

    如需了解更多详细信息，请参阅 CDK 3.17 中的使用 OpenShift Client Binary 指南。

    如果您不使用 CDK，请按照 CLI 参考中的 说明安装 oc 客户端工具。

  • （可选） Docker 客户端：高级用户可能会发现安装 Docker 客户端工具（与 OpenShift 服务器上运行的 docker 守护进程通信）会很方便。有关您的操作系统的特定二进制安装的详情，请查看 Docker 安装 站点。

    如需了解更多详细信息，请参阅 CDK 3.17 入门指南 中的重复使用 docker Daemon。

    重要

    确保安装 oc 工具的版本和与 OpenShift 服务器上运行的 OpenShift 版本兼容的 docker 工具。

其它资源

（可选） Red Hat JBoss CodeReady Studio ：红帽 JBoss CodeReady Studio 是一个基于 Eclipse 的开发环境，包括在 OpenShift 应用程序中开发 Fuse。有关如何安装此开发环境的详情，请参阅安装 Red Hat JBoss CodeReady Studio。

5.1.4. 配置 Maven 软件仓库

配置 Maven 存储库，其中包含在本地机器上在 OpenShift 项目中构建 Fuse 所需的 archetypes 和工件。

流程

  1. 打开您的 Maven settings.xml 文件，该文件通常位于 ~/.m2/settings.xml （在 Linux 或 macOS 上）或 Documents and Settings\<USER_NAME>\.m2\settings.xml (on Windows)。

  2. 添加以下 Maven 存储库。