10.5. 管理命名空间存储桶

命名空间存储桶可让您将不同提供程序上的数据存储库连接在一起，以便您可以通过统一视图与所有数据交互。将与各个提供程序关联的对象存储桶添加到命名空间存储桶，并通过命名空间存储桶访问您的数据，以一次性查看所有对象存储桶。这可让您在读取多个其他存储提供商的同时写入您首选的存储供应商，从而显著降低迁移至新存储提供商的成本。

您可以使用 S3 API 与命名空间存储桶中的对象交互。如需更多信息，请参阅命名空间存储桶中对象的 S3 API 端点。

注意

只有其写入目标可用且可正常运行时，才能使用命名空间存储桶。

10.5.1. 命名空间存储桶中对象的 Amazon S3 API 端点

您可以使用 Amazon Simple Storage Service(S3) API 与命名空间存储桶中的对象交互。

Red Hat OpenShift Data Foundation 4.6 之后支持以下命名空间存储桶操作：

有关这些操作及其使用方法的最新信息，请参阅 Amazon S3 API 参考文档。

其它资源

10.5.2. 使用 Multicloud 对象网关 CLI 和 YAML 添加命名空间存储桶

如需有关命名空间存储桶的更多信息，请参阅管理命名空间存储桶。

根据部署的类型以及是否使用 YAML 或 Multicloud 对象网关 CLI，选择以下流程之一来添加命名空间存储桶：

10.5.2.1. 使用 YAML 添加 AWS S3 命名空间存储桶

先决条件

流程

  1. 使用凭证创建 secret： 

    apiVersion: v1
kind: Secret
metadata:
  name: <namespacestore-secret-name>
  type: Opaque
data:
  AWS_ACCESS_KEY_ID: <AWS ACCESS KEY ID ENCODED IN BASE64>
  AWS_SECRET_ACCESS_KEY: <AWS SECRET ACCESS KEY ENCODED IN BASE64>
    1. 您必须使用 Base64 提供并编码您自己的 AWS 访问密钥 ID 和 secret 访问密钥，并使用结果代替 <AWS ACCESS KEY ID ENCODED IN BASE64> 和 <AWS SECRET ACCESS KEY ENCODED IN BASE64>。
    2. 使用一个唯一的名称替换 <namespacestore-secret-name>。

  2. 使用 OpenShift 自定义资源定义 (CRD) 创建 NamespaceStore 资源。NamespaceStore 代表底层存储，用作 MCG 命名空间存储桶中数据的读取或写入目标。要创建 NamespaceStore 资源，请应用以下 YAML： 

    apiVersion: noobaa.io/v1alpha1
kind: NamespaceStore
metadata:
  finalizers:
  - noobaa.io/finalizer
  labels:
    app: noobaa
  name: <resource-name>
  namespace: openshift-storage
spec:
  awsS3:
    secret:
      name: <namespacestore-secret-name>
      namespace: <namespace-secret>
    targetBucket: <target-bucket>
  type: aws-s3
    1. 将 <resource-name> 替换为您要提供给资源的名称。
    2. 将 <namespacestore-secret-name> 替换为在第 1 步中创建的 secret。
    3. 将 <namespace-secret> 替换为可找到 secret 的命名空间。
    4. 将 <target-bucket> 替换为您为 NamespaceStore 创建的目标存储桶。

  3. 创建一个命名空间存储桶类，为命名空间存储桶定义命名空间策略。命名空间策略的类型需要是 single 或 multi。

    • 一个类型为 single 的命名空间策略需要以下配置： 

      apiVersion: noobaa.io/v1alpha1
kind: BucketClass
metadata:
  labels:
    app: noobaa
  name: <my-bucket-class>
  namespace: openshift-storage
spec:
  namespacePolicy:
    type:
    single:
      resource: <resource>
      • 将 <my-bucket-class> 替换为唯一的命名空间存储桶类名称。
      • 将 <resource> 替换为单个 namespace-store 的名称，该存储将定义命名空间存储桶的读取和写入目标。

    • 一个类型为 multi 的命名空间策略需要以下配置： 

      apiVersion: noobaa.io/v1alpha1

kind: BucketClass
metadata:
  labels:
    app: noobaa
  name: <my-bucket-class>
  namespace: openshift-storage
spec:
  namespacePolicy:
    type: Multi
    multi:
      writeResource: <write-resource>
      readResources:
      - <read-resources>
      - <read-resources>
      • 将 <my-bucket-class> 替换为唯一的存储桶类名称。
      • 将 <write-resource> 替换为定义命名空间存储桶写入目标的单一命名空间存储名称。
      • 将 <read-resources> 替换为定义命名空间存储桶读取目标的 namespace-store 的名称列表。

  4. 应用以下 YAML，以使用对象 Bucket Class (OBC) 资源创建 bucket，该资源使用第 2 步中定义的 bucket 类。 

    apiVersion: objectbucket.io/v1alpha1
kind: ObjectBucketClaim
metadata:
  name: <resource-name>
  namespace: openshift-storage
spec:
  generateBucketName: <my-bucket>
  storageClassName: openshift-storage.noobaa.io
  additionalConfig:
    bucketclass: <my-bucket-class>
    1. 将 <resource-name> 替换为您要提供给资源的名称。
    2. 将 <my-bucket> 替换为您要提供给存储桶的名称。
    3. 将 <my-bucket-class> 替换为上一步中创建的存储桶类。

当 Operator 置备 OBC 后，会在 MCG 中创建存储桶，Operator 会创建一个名称相同且位于 OBC 同一命名空间上的 Secret 和 ConfigMap。

10.5.2.2. 使用 YAML 添加 IBM COS 命名空间存储桶

先决条件

流程

  1. 使用凭证创建 secret： 

    apiVersion: v1
kind: Secret
metadata:
  name: <namespacestore-secret-name>
  type: Opaque
data:
  IBM_COS_ACCESS_KEY_ID: <IBM COS ACCESS KEY ID ENCODED IN BASE64>
  IBM_COS_SECRET_ACCESS_KEY: <IBM COS SECRET ACCESS KEY ENCODED IN BASE64>
    1. 您必须使用 Base64 提供和编码您自己的 IBM COS 访问密钥 ID 和 secret 访问密钥，并使用结果代替 <IBM COS ACCESS KEY ID ENCODED IN BASE64> 和 <IBM COS SECRET ACCESS KEY ENCODED IN BASE64>。
    2. 使用一个唯一的名称替换 <namespacestore-secret-name>。

  2. 使用 OpenShift 自定义资源定义 (CRD) 创建 NamespaceStore 资源。NamespaceStore 代表底层存储，用作 MCG 命名空间存储桶中数据的读取或写入目标。要创建 NamespaceStore 资源，请应用以下 YAML： 

    apiVersion: noobaa.io/v1alpha1
kind: NamespaceStore
metadata:
  finalizers:
  - noobaa.io/finalizer
  labels:
    app: noobaa
  name: bs
  namespace: openshift-storage
spec:
  s3Compatible:
    endpoint: <IBM COS ENDPOINT>
    secret:
      name: <namespacestore-secret-name>
      namespace: <namespace-secret>
    signatureVersion: v2
    targetBucket: <target-bucket>
  type: ibm-cos
    1. 将 <IBM COS ENDPOINT> 替换为适当的 IBM COS 端点。
    2. 将 <namespacestore-secret-name> 替换为在第 1 步中创建的 secret。
    3. 将 <namespace-secret> 替换为可找到 secret 的命名空间。
    4. 将 <target-bucket> 替换为您为 NamespaceStore 创建的目标存储桶。

  3. 创建一个命名空间存储桶类，为命名空间存储桶定义命名空间策略。命名空间策略的类型需要是 single 或 multi。

    • 一个类型为 single 的命名空间策略需要以下配置： 

      apiVersion: noobaa.io/v1alpha1
kind: BucketClass
metadata:
  labels:
    app: noobaa
  name: <my-bucket-class>
  namespace: openshift-storage
spec:
  namespacePolicy:
    type:
    single:
      resource: <resource>
      • 将 <my-bucket-class> 替换为唯一的命名空间存储桶类名称。
      • 将 <resource> 替换为单个 namespace-store 的名称，该存储将定义命名空间存储桶的读取和写入目标。

    • 一个类型为 multi 的命名空间策略需要以下配置： 

      apiVersion: noobaa.io/v1alpha1
kind: BucketClass
metadata:
  labels:
    app: noobaa
  name: <my-bucket-class>
  namespace: openshift-storage
spec:
  namespacePolicy:
    type: Multi
    multi:
      writeResource: <write-resource>
      readResources:
      - <read-resources>
      - <read-resources>
      • 将 <my-bucket-class> 替换为唯一的存储桶类名称。
      • 将 <write-resource> 替换为定义命名空间存储桶写入目标的单一命名空间存储名称。
      • 将 <read-resources> 替换为定义命名空间存储桶读取目标的 namespace-store 的名称列表。

  4. 应用以下 YAML，以使用对象 Bucket Class (OBC) 资源创建 bucket，该资源使用第 2 步中定义的 bucket 类。 

    apiVersion: objectbucket.io/v1alpha1
kind: ObjectBucketClaim
metadata:
  name: <resource-name>
  namespace: openshift-storage
spec:
  generateBucketName: <my-bucket>
  storageClassName: openshift-storage.noobaa.io
  additionalConfig:
    bucketclass: <my-bucket-class>
    1. 将 <resource-name> 替换为您要提供给资源的名称。
    2. 将 <my-bucket> 替换为您要提供给存储桶的名称。
    3. 将 <my-bucket-class> 替换为上一步中创建的存储桶类。

当 Operator 置备 OBC 后，会在 MCG 中创建存储桶，Operator 会创建一个名称相同且位于 OBC 同一命名空间上的 Secret 和 ConfigMap。

10.5.2.3. 使用 Multicloud 对象网关 CLI 添加 AWS S3 命名空间存储桶

先决条件

# subscription-manager repos --enable=rh-odf-4-for-rhel-8-x86_64-rpms
# yum install mcg
注意

指定适当的架构，以使用订阅管理器启用存储库。例如，如果是 IBM Z 基础架构，请使用以下命令： 

# subscription-manager repos --enable=rh-odf-4-for-rhel-8-s390x-rpms

另外，您还可以从位于 https://access.redhat.com/downloads/content/547/ver=4/rhel---8/4/x86_64/package的 OpenShift Data Foundation RPM 安装 MCG 软件包。

注意

根据您的架构选择正确的产品变体。

流程

  1. 创建 NamespaceStore 资源。NamespaceStore 代表底层存储，用作 MCG 命名空间存储桶中数据的读取或写入目标。在 MCG 命令行界面中运行以下命令： 

    noobaa namespacestore create aws-s3 <namespacestore> --access-key <AWS ACCESS KEY> --secret-key <AWS SECRET ACCESS KEY> --target-bucket <bucket-name> -n openshift-storage
    1. 将 <namespacestore> 替换为 NamespaceStore 的名称。
    2. 将 <AWS ACCESS KEY> 和 <AWS SECRET ACCESS KEY> 替换为您为此创建的 AWS 访问密钥 ID 和 secret 访问密钥。
    3. 将 <bucket-name> 替换为现有的 AWS 存储桶名称。此参数告知 MCG 将哪一个存储桶用作其后备存储的目标存储桶，以及随后数据存储和管理。

  2. 创建一个命名空间存储桶类，为命名空间存储桶定义命名空间策略。命名空间策略的类型需要是 single 或 multi。

    • 运行以下命令，创建一个命名空间存储桶类，其命名空间策略类型为 single ： 

      noobaa bucketclass create namespace-bucketclass single <my-bucket-class> --resource <resource> -n openshift-storage
      • 将 <resource-name> 替换为您要为其提供资源的名称。
      • 将 <my-bucket-class> 替换为唯一的存储桶类名称。
      • 将 <resource> 替换为定义命名空间存储桶读写目标的单个 namespace-store。

    • 运行以下命令，创建一个命名空间存储桶类，其命名空间策略为 multi： 

      noobaa bucketclass create namespace-bucketclass multi <my-bucket-class> --write-resource <write-resource> --read-resources <read-resources> -n openshift-storage
      • 将 <resource-name> 替换为您要为其提供资源的名称。
      • 将 <my-bucket-class> 替换为唯一的存储桶类名称。
      • 将 <write-resource> 替换为定义命名空间存储桶写入目标的单个 namespace-store。
      • 将 <read-resources> 替换为一个以逗号分开的命名空间存储列表，该存储将定义命名空间存储桶的读取目标。

  3. 运行以下命令，以使用对象 Bucket Class (OBC) 资源创建 bucket，该资源使用第 2 步中定义的 bucket 类。 

    noobaa obc create my-bucket-claim -n openshift-storage --app-namespace my-app --bucketclass <custom-bucket-class>
    1. 将 <bucket-name> 替换为您选择的存储桶名称。
    2. 将 <custom-bucket-class> 替换为在第 2 步中创建的 bucket 类的名称。

当 Operator 置备 OBC 后，会在 MCG 中创建存储桶，Operator 会创建一个名称相同且位于 OBC 同一命名空间上的 Secret 和 ConfigMap。

10.5.2.4. 使用 Multicloud 对象网关 CLI 添加 IBM COS 命名空间存储桶

先决条件

  • 正在运行的 OpenShift Data Foundation 平台。
  • 访问多云对象网关（MCG），请参阅第 2 章，使用应用程序访问多云对象网关

  • 下载 MCG 命令行界面： 

    # subscription-manager repos --enable=rh-odf-4-for-rhel-8-x86_64-rpms
# yum install mcg
    注意

    指定适当的架构，以使用订阅管理器启用存储库。

    • 对于 IBM Power，使用以下命令： 
    # subscription-manager repos --enable=rh-odf-4-for-rhel-8-ppc64le-rpms
    • 对于 IBM Z 基础架构，使用以下命令： 
    # subscription-manager repos --enable=rh-odf-4-for-rhel-8-s390x-rpms

    另外，您还可以从位于 https://access.redhat.com/downloads/content/547/ver=4/rhel---8/4/x86_64/package的 OpenShift Data Foundation RPM 安装 MCG 软件包。

    注意

    根据您的架构选择正确的产品变体。

流程

  1. 创建 NamespaceStore 资源。NamespaceStore 代表底层存储，用作 MCG 命名空间存储桶中数据的读取或写入目标。在 MCG 命令行界面中运行以下命令： 

    noobaa namespacestore create ibm-cos <namespacestore> --endpoint <IBM COS ENDPOINT> --access-key <IBM ACCESS KEY> --secret-key <IBM SECRET ACCESS KEY> --target-bucket <bucket-name> -n openshift-storage
    1. 将 <namespacestore> 替换为 NamespaceStore 的名称。
    2. 将 <IBM ACCESS KEY>、、<IBM SECRET ACCESS KEY>、<IBM COS ENDPOINT> 替换为 IBM 访问密钥 ID、机密访问密钥和对应于现有 IBM 存储桶位置的适当区域端点。
    3. 将 <bucket-name> 替换为现有的 IBM 存储桶名称。此参数告知 MCG 将哪一个存储桶用作其后备存储的目标存储桶，以及随后数据存储和管理。

  2. 创建一个命名空间存储桶类，为命名空间存储桶定义命名空间策略。命名空间策略的类型需要是 single 或 multi。

    • 运行以下命令，创建一个命名空间存储桶类，其命名空间策略类型为 single ： 

      noobaa bucketclass create namespace-bucketclass single <my-bucket-class> --resource <resource> -n openshift-storage
      • 将 <resource-name> 替换为您要为其提供资源的名称。
      • 将 <my-bucket-class> 替换为唯一的存储桶类名称。
      • 将 <resource> 替换为定义命名空间存储桶读写目标的单个 namespace-store。

    • 运行以下命令，创建一个命名空间存储桶类，其命名空间策略为 multi： 

      noobaa bucketclass create namespace-bucketclass multi <my-bucket-class> --write-resource <write-resource> --read-resources <read-resources> -n openshift-storage
      • 将 <resource-name> 替换为您要为其提供资源的名称。
      • 将 <my-bucket-class> 替换为唯一的存储桶类名称。
      • 将 <write-resource> 替换为定义命名空间存储桶写入目标的单个 namespace-store。
      • 将 <read-resources> 替换为一个以逗号分开的命名空间存储列表，该存储将定义命名空间存储桶的读取目标。

  3. 运行以下命令，以使用对象 Bucket Class (OBC) 资源创建 bucket，该资源使用第 2 步中定义的 bucket 类。 

    noobaa obc create my-bucket-claim -n openshift-storage --app-namespace my-app --bucketclass <custom-bucket-class>
    1. 将 <bucket-name> 替换为您选择的存储桶名称。
    2. 将 <custom-bucket-class> 替换为在第 2 步中创建的 bucket 类的名称。

当 Operator 置备 OBC 后，会在 MCG 中创建存储桶，Operator 会创建一个名称相同且位于 OBC 同一命名空间上的 Secret 和 ConfigMap。

10.5.3. 使用 OpenShift Container Platform 用户界面添加命名空间存储桶

从 OpenShift Data Foundation 4.8 开始，可以使用 OpenShift Container Platform 用户界面添加命名空间存储桶。如需有关命名空间存储桶的更多信息，请参阅管理命名空间存储桶。

先决条件

  • 安装了带有 OpenShift Data Foundation operator 的 OpenShift Container Platform。
  • 访问多云对象网关(MCG)。

流程

  1. 登录 OpenShift Web 控制台。
  2. 点 Storage → Data Foundation。

  3. 点 Namespace Store 选项卡创建要在命名空间存储桶中使用的 namespacestore 资源。

    1. 单击 Create namespace store。
    2. 输入命名空间存储名称。
    3. 选择一个供应商。
    4. 选择一个地区。
    5. 选择现有的 secret，或者点击 Swith to credentials 通过输入 secret key 和 secret access key 来创建 secret。
    6. 选择目标存储桶。
    7. 点击 Create。
    8. 验证命名空间存储是否处于 Ready 状态。
    9. 重复这些步骤，直到您拥有所需的资源量。

  4. 点击 Bucket Class 选项卡 → Create a new Bucket Class。

    1. 选择 Namespace 单选按钮。
    2. 输入 Bucket 类名称。
    3. 添加描述（可选）。
    4. 点 Next。
  5. 为您的命名空间存储桶选择一个命名空间策略类型，然后单击 Next。

  6. 选择目标资源。

    • 如果您的命名空间策略类型是 Single，则需要选择一个读取资源。
    • 如果您的命名空间策略类型是 Multi，则需要选择读取资源和写入资源。
    • 如果命名空间策略类型是 Cache，则需要选择一个定义命名空间存储桶读取和写入目标的 Hub 命名空间存储。
  7. 点 Next。
  8. 检查您的新 bucket 类，然后点击 Create Bucketclass。
  9. 在 BucketClass 页面中，验证新创建的资源是否处于 Created 阶段。
  10. 在 OpenShift Web 控制台中，点 Storage → Data Foundation。
  11. 在 Status 卡中，单击 Storage System，再单击弹出窗口中的 storage 系统链接。
  12. 在 Object 选项卡中，点 Multicloud Object Gateway → Buckets → Namespace Buckets 选项卡。

  13. 点 Create Namespace Bucket。

    1. 在 Choose Name 选项卡中，指定命名空间存储桶的名称，再单击 Next。

    2. 在 Set Placement 标签页中：

      1. 在 Read Policy 下，选中在第 5 步中创建的每个命名空间资源应从中读取数据的复选框。
      2. 如果您使用的命名空间策略类型是 Multi，在 Write Policy 下指定要将数据写入的命名空间资源。
      3. 点 Next。
    3. 点击 Create。

验证

  • 验证命名空间存储桶是否在 State 列中带有绿色勾号、预期的读取资源和预期的写入资源名称。