第 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.11 支持的 Java 版本。有关支持的 Java 版本的详情，请参阅支持的配置。

流程

在您的本地机器上安装 CDK：

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

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

    注意

    您的 CDK 版本可能预安装了 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 容器镜像上安装最新的 Fuse，并在 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 的输出会因操作系统和 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 Reference 中的说明安装 oc 客户端工具。

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

    如需了解更多详细信息，请参阅在 CDK 3.17 中使用 docker Daemon 。

    重要

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

5.1.4. 配置 Maven 软件仓库

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

流程

  1. 打开 Maven settings.xml 文件，它通常位于 ~/.m2/settings.xml （在 Linux 或 macOS 中）或 Documents 和 Settings\<USER_NAME>\.m2\settings.xml （位于 Windows）。

  2. 添加以下 Maven 存储库。