第 3 章 添加 Red Hat Integration - AMQ Interconnect Operator
Red Hat Integration - AMQ Interconnect Operator 在 OpenShift Container Platform 中创建和管理 AMQ Interconnect 路由器网络。此 Operator 必须为每个使用它的项目单独安装。
安装 Operator 的选项有:
安装 Operator 需要 OpenShift 集群的管理员级权限。
3.1. 使用 CLI 安装 Operator
本节中的步骤演示了如何使用 OpenShift 命令行界面(CLI)在给定的 OpenShift 项目中安装和部署最新版本的 Red Hat Integration - AMQ Interconnect Operator。
3.1.1. 获取 Operator 代码
此流程演示了如何访问和准备为 AMQ Interconnect 1.10 安装 Operator 最新版本所需的代码。
流程
- 在网页浏览器中,导航到 AMQ Interconnect 版本的 Software Downloads 页面。
-
确保 Version 下拉列表的值设置为
1.10.7
,并且选择 Releases 选项卡。 在 AMQ Interconnect 1.10.7 Operator 安装和示例文件 旁边,点 Download。
下载
amq-interconnect-operator-1.10.7-ocp-install-examples.zip
压缩存档会自动开始。下载完成后,将存档移至您选择的安装目录。以下示例将存档 移到名为
~/router/operator
的目录。$ mkdir ~/router $ mv amq-interconnect-operator-1.10.7-ocp-install-examples.zip ~/router
在您选择的安装目录中,提取存档的内容。例如:
$ cd ~/router $ unzip amq-interconnect-operator-1.10.7-ocp-install-examples.zip
切换到提取存档时创建的目录。例如:
$ cd operator
以集群管理员身份登录 OpenShift Container Platform。例如:
$ oc login -u system:admin
指定要安装 Operator 的项目。您可以创建新项目或切换到现有项目。
创建一个新项目:
$ oc new-project <project-name>
或者,切换到现有项目:
$ oc project <project-name>
创建要与 Operator 搭配使用的服务帐户。
$ oc create -f deploy/service_account.yaml
为 Operator 创建角色。
$ oc create -f deploy/role.yaml
为 Operator 创建角色绑定。角色绑定根据您指定的名称将之前创建的服务帐户绑定到 Operator 角色。
$ oc create -f deploy/role_binding.yaml
在下面的流程中,您要在项目中部署 Operator。
3.1.2. 使用 CLI 部署 Operator
本节中的步骤演示了如何使用 OpenShift 命令行界面(CLI)在 OpenShift 项目中为 AMQ Interconnect 1.10 部署最新版本的 Operator。
先决条件
- 您必须已经为 Operator 部署准备了 OpenShift 项目。请参阅 第 3.1.1 节 “获取 Operator 代码”。
- 在按照本节中的步骤操作前,您必须首先完成 Red Hat Container Registry 身份验证 中描述的步骤。
流程
在 OpenShift 命令行界面(CLI)中,作为集群管理员登录到 OpenShift Container Platform。例如:
$ oc login -u system:admin
切换到您之前为 Operator 部署准备的项目。例如:
$ oc project <project-name>
切换到之前提取 Operator 安装存档时创建的目录。例如:
$ cd ~/router/operator/qdr-operator-1.10-ocp-install-examples
部署 Operator 中包含的 CRD。您必须在部署和启动 Operator 前,在 OpenShift 集群中安装 CRD。
$ oc create -f deploy/crds/interconnectedcloud_v1alpha1_interconnect_crd.yaml
将与红帽生态系统目录中用于身份验证的帐户关联的 pull secret 与 OpenShift 项目
的默认
、部署器和构建器服务帐户
相关联。$ oc secrets link --for=pull default <secret-name> $ oc secrets link --for=pull deployer <secret-name> $ oc secrets link --for=pull builder <secret-name>
注意在 OpenShift Container Platform 4.1 或更高版本中,您还可以使用 Web 控制台将 pull secret 与您要在其中部署容器镜像的项目(如 AMQ Interconnect Operator)关联。为此,请单击
。指定与您在 Red Hat Container Registry 中用于身份验证的帐户关联的 pull secret。 部署 Operator。
$ oc create -f deploy/operator.yaml
验证 Operator 是否正在运行:
$ oc get pods -l name=qdr-operator
如果输出没有报告 pod 正在运行,请使用以下命令来确定阻止它运行的问题:
$ oc describe pod -l name=qdr-operator
验证 CRD 是否已在集群中注册,并查看 CRD 详情:
$ oc get crd $ oc describe crd interconnects.interconnectedcloud.github.io
建议您在给定的 OpenShift 项目中仅部署 AMQ Interconnect Operator 的单个实例。不建议将 Operator 部署的 replicas
元素设置为大于 1
的值,或者不要 在同一项目中部署 Operator。
其他资源
- 有关安装使用 OperatorHub 图形界面的 AMQ Interconnect Operator 的替代方法,请参阅 第 3.2 节 “使用 Operator Lifecycle Manager 安装 Operator”。