4.4. 配置代理存储要求

流程

1. 为代理部署配置自定义资源(CR)实例。

   1. 使用 OpenShift 命令行界面：

      1. 以具有特权的用户身份登录 OpenShift，以便在您要在其中创建部署的项目中部署 CR。

         oc login -u <user> -p <password> --server=<host:port>

      2. 打开名为 broker_activemqartemis_cr.yaml 的示例 CR 文件，该文件包含在您下载和提取的 Operator 安装存档的 deploy/crs 目录中。

   2. 使用 OpenShift Container Platform Web 控制台：

      1. 以有权在您要创建部署的项目中部署 CR 的用户身份登录控制台。
      2. 根据主代理 CRD 启动一个新的 CR 实例。在左侧窗格中，点 Administration Custom Resource Definitions。
      3. 单击 ActiveMQArtemis CRD。
      4. 点 实例 选项卡。

      5. 单击 Create ActiveMQArtemis。

         在控制台中，会打开 YAML 编辑器，供您配置 CR 实例。

   对于基本的代理部署，配置可能类似如下。

   apiVersion: broker.amq.io/v1beta1
   kind: ActiveMQArtemis
   metadata:
     name: ex-aao
   spec:
     deploymentPlan:
       size: 1
       image: placeholder
       requireLogin: false
       persistenceEnabled: true
       journalType: nio
       messageMigration: true

   观察 broker_activemqartemis_cr.yaml 示例 CR 文件中的，image 属性被设置为 占位符 的默认值。这个值表示，默认情况下 image 属性没有指定用于部署的代理容器镜像。要了解 Operator 如何确定要使用的适当代理容器镜像，请参阅 第 2.6 节 “Operator 如何选择容器镜像”。

2. 要指定代理存储大小，在 CR 的 deploymentPlan 部分添加一个 存储 部分。添加 size 属性并指定值。例如：

   spec:
     deploymentPlan:
       size: 1
       image: placeholder
       requireLogin: false
       persistenceEnabled: true
       journalType: nio
       messageMigration: true
       storage:
         size: 4Gi

   storage.size

   每个代理 Pod 所需的持久性卷声明(PVC)的大小（以字节为单位）。只有在 persistenceEnabled 设为 true 时，此属性才会应用。您指定的值 必须使用 字节表示法（如 K、M、G）或二进制等同的单位(Ki、Mi、Gi)。

3. 要指定每个代理 Pod 需要用于持久性存储的存储类，在 storage 部分添加一个 storageClassName 属性并指定一个值。例如：

   spec:
     deploymentPlan:
       size: 1
       image: placeholder
       requireLogin: false
       persistenceEnabled: true
       journalType: nio
       messageMigration: true
       storage:
         size: 4Gi
         storageClassName: gp3

   storage.storageClassName

   在持久性卷声明(PVC)中请求的存储类的名称。存储类为管理员提供了描述和分类可用存储的方法。例如，不同的存储类可能会映射到特定的服务质量级别、备份策略等。

   如果没有指定存储类，则 PVC 会声明带有为集群配置默认存储类的持久性卷。

   注意

   如果您指定了存储类，则只有在卷的存储类与指定的存储类匹配时，PVC 才会声明持久性卷。

4. 部署 CR 实例。

   1. 使用 OpenShift 命令行界面：

      1. 保存 CR 文件。

      2. 切换到您要在其中创建代理部署的项目。

         $ oc project <project_name>

      3. 创建 CR 实例。

         $ oc create -f <path/to/custom_resource_instance>.yaml

   2. 使用 OpenShift Web 控制台：

      1. 配置完 CR 后，点 Create。