第 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 最新版本所需的代码。

流程

  1. 在网页浏览器中,导航到 AMQ Interconnect 版本的 Software Downloads 页面。
  2. 确保 Version 下拉列表的值设置为 1.10.7,并且选择 Releases 选项卡。
  3. AMQ Interconnect 1.10.7 Operator 安装和示例文件 旁边,点 Download

    下载 amq-interconnect-operator-1.10.7-ocp-install-examples.zip 压缩存档会自动开始。

  4. 下载完成后,将存档移至您选择的安装目录。以下示例将存档 移到名为 ~/router/operator 的目录。

    $ mkdir ~/router
    $ mv amq-interconnect-operator-1.10.7-ocp-install-examples.zip ~/router
  5. 在您选择的安装目录中,提取存档的内容。例如:

    $ cd ~/router
    $ unzip amq-interconnect-operator-1.10.7-ocp-install-examples.zip
  6. 切换到提取存档时创建的目录。例如:

    $ cd operator
  7. 以集群管理员身份登录 OpenShift Container Platform。例如:

    $ oc login -u system:admin
  8. 指定要安装 Operator 的项目。您可以创建新项目或切换到现有项目。

    1. 创建一个新项目:

      $ oc new-project <project-name>
    2. 或者,切换到现有项目:

      $ oc project <project-name>
  9. 创建要与 Operator 搭配使用的服务帐户。

    $ oc create -f deploy/service_account.yaml
  10. 为 Operator 创建角色。

    $ oc create -f deploy/role.yaml
  11. 为 Operator 创建角色绑定。角色绑定根据您指定的名称将之前创建的服务帐户绑定到 Operator 角色。

    $ oc create -f deploy/role_binding.yaml

在下面的流程中,您要在项目中部署 Operator。

3.1.2. 使用 CLI 部署 Operator

本节中的步骤演示了如何使用 OpenShift 命令行界面(CLI)在 OpenShift 项目中为 AMQ Interconnect 1.10 部署最新版本的 Operator。

先决条件

流程

  1. 在 OpenShift 命令行界面(CLI)中,作为集群管理员登录到 OpenShift Container Platform。例如:

    $ oc login -u system:admin
  2. 切换到您之前为 Operator 部署准备的项目。例如:

    $ oc project <project-name>
  3. 切换到之前提取 Operator 安装存档时创建的目录。例如:

    $ cd ~/router/operator/qdr-operator-1.10-ocp-install-examples
  4. 部署 Operator 中包含的 CRD。您必须在部署和启动 Operator 前,在 OpenShift 集群中安装 CRD。

    $ oc create -f deploy/crds/interconnectedcloud_v1alpha1_interconnect_crd.yaml
  5. 将与红帽生态系统目录中用于身份验证的帐户关联的 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)关联。为此,请单击 AdministrationService Accounts。指定与您在 Red Hat Container Registry 中用于身份验证的帐户关联的 pull secret。

  6. 部署 Operator。

    $ oc create -f deploy/operator.yaml
  7. 验证 Operator 是否正在运行:

    $ oc get pods -l name=qdr-operator

    如果输出没有报告 pod 正在运行,请使用以下命令来确定阻止它运行的问题:

    $ oc describe pod -l name=qdr-operator
  8. 验证 CRD 是否已在集群中注册,并查看 CRD 详情:

    $ oc get crd
    $ oc describe crd interconnects.interconnectedcloud.github.io
注意

建议您在给定的 OpenShift 项目中仅部署 AMQ Interconnect Operator 的单个实例。不建议将 Operator 部署的 replicas 元素设置为大于 1 的值,或者不要 在同一项目中部署 Operator。

其他资源