第 4 章 开发人员入门
4.1. 准备开发环境
在 OpenShift 项目中开发和测试 Fuse 的基本要求是能够访问 OpenShift 服务器。您有以下基本替代方案:
4.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.4 支持的 Java 版本。有关支持的 Java 版本的详情,请参阅 支持的配置。
流程
在本地机器上安装 CDK:
- 对于 OpenShift 上的 Fuse,我们建议您安装 CDK 的版本 3.9。Red Hat CDK 3.9 入门指南 中提供了安装和使用 CDK 3.9 的详细信息。
- 按照 配置 Red Hat Container Registry 身份验证 中的说明,配置 OpenShift 凭证以访问红帽容器 registry。
如 第 2 章 管理员入门 所述,在 OpenShift 镜像和模板上安装 Fuse。
注意您的 CDK 版本可能预装了 Fuse on OpenShift 镜像和模板。但是,在配置 OpenShift 凭证后,您必须在 OpenShift 镜像和模板上安装(或更新) Fuse。
- 在继续本章中的示例之前,您应该阅读并彻底理解 Red Hat CDK 3.9 入门指南 的内容。
4.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)以及您的帐户的登录凭据。
4.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 二进制文件添加到 PATH 中,其中显示您需要键入的命令(oc
-envoc-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.9 入门指南中的使用 OpenShift 客户端二进制。
如果您不使用 CDK,请按照 CLI 参考中的 说明安装
oc
客户端工具。(可选) Docker 客户端:高级用户可以方便地安装 Docker 客户端工具(与 OpenShift 服务器上运行的 docker 守护进程通信)。有关您的操作系统特定二进制安装的详情,请查看 Docker 安装 站点。
如需了解更多详细信息,请参阅 CDK 3.9 入门指南 中的 Reusing the docker Daemon。
重要确保安装
oc
工具版本和与 OpenShift 服务器上运行的 OpenShift 版本兼容的docker
工具。
其它资源
(可选) 红帽 JBoss CodeReady Studio: 红帽 JBoss CodeReady Studio 是基于 Eclipse 的开发环境,包括对在 OpenShift 应用中开发 Fuse 的支持。有关如何安装此开发环境的详情,请参阅安装 Red Hat JBoss CodeReady Studio。
4.1.4. 配置 Maven 存储库
配置 Maven 存储库,其中包含您要在本地机器的 OpenShift 项目中构建 Fuse 的 archetypes 和工件。
流程
-
打开 Maven
settings.xml
文件,该文件通常位于~/.m2/settings.xml
(在 Linux 或 macOS 中)或Documents and Settings\<USER_NAME>\.m2\settings.xml
(on Windows)。 添加以下 Maven 存储库。
-
Maven central:
https://repo1.maven.org/maven2
-
Red Hat GA 软件仓库
:https://maven.repository.redhat.com/ga
Red Hat EA 软件仓库
:https://maven.repository.redhat.com/earlyaccess/all
您必须将前面的存储库添加到依赖项存储库部分,以及
settings.xml
文件的插件 repository 部分。
-
Maven central: