Chapter 8. Multicloud Object Gateway bucket replication

Procedure

• From the MCG command-line interface, run the following command to create an OBC with a specific replication policy:

  noobaa obc create <bucket-claim-name> -n openshift-storage --replication-policy /path/to/json-file.json

  Copy to Clipboard Toggle word wrap

  <bucket-claim-name>

  Specify the name of the bucket claim.

  /path/to/json-file.json

  Is the path to a JSON file which defines the replication policy.

  Example JSON file:

  +

  [{ "rule_id": "rule-1", "destination_bucket": "first.bucket", "filter": {"prefix": "repl"}}]

  Copy to Clipboard Toggle word wrap

  "prefix"

  Is optional. It is the prefix of the object keys that should be replicated, and you can even leave it empty, for example, {"prefix": ""}.

  For example:

  noobaa obc create my-bucket-claim -n openshift-storage --replication-policy /path/to/json-file.json

  Copy to Clipboard Toggle word wrap

Procedure

• Apply the following YAML:

  apiVersion: objectbucket.io/v1alpha1
  kind: ObjectBucketClaim
  metadata:
    name: <desired-bucket-claim>
    namespace: <desired-namespace>
  spec:
    generateBucketName: <desired-bucket-name>
    storageClassName: openshift-storage.noobaa.io
    additionalConfig:
      replication-policy: [{ "rule_id": "<rule id>", "destination_bucket": "first.bucket", "filter": {"prefix": "<object name prefix>"}}]

  Copy to Clipboard Toggle word wrap

  <desired-bucket-claim>

  Specify the name of the bucket claim.

  <desired-namespace>

  Specify the namespace.

  <desired-bucket-name>

  Specify the prefix of the bucket name.

  "rule_id"

  Specify the ID number of the rule, for example, {"rule_id": "rule-1"}.

  "destination_bucket"

  Specify the name of the destination bucket, for example, {"destination_bucket": "first.bucket"}.

  "prefix"

  Is optional. It is the prefix of the object keys that should be replicated, and you can even leave it empty, for example, {"prefix": ""}.

Additional information

• For more information about OBCs, see Object Bucket Claim.

• Placement
• Namespace

Procedure

• From the MCG command-line interface, run the following command:

  noobaa -n openshift-storage bucketclass create placement-bucketclass <bucketclass-name> --backingstores <backingstores> --replication-policy=/path/to/json-file.json

  Copy to Clipboard Toggle word wrap

  <bucketclass-name>

  Specify the name of the bucket class.

  <backingstores>

  Specify the name of a backingstore. It is possible to pass several backingstores separated by commas.

  /path/to/json-file.json

  Is the path to a JSON file which defines the replication policy.

  Example JSON file:

  [{ "rule_id": "rule-1", "destination_bucket": "first.bucket", "filter": {"prefix": "repl"}}]

  Copy to Clipboard Toggle word wrap

  "prefix"

  Is optional. It is the prefix of the object keys that should be replicated, and you can even leave it empty, for example, {"prefix": ""}.

  For example:

  noobaa -n openshift-storage bucketclass create placement-bucketclass bc --backingstores azure-blob-ns --replication-policy=/path/to/json-file.json

  Copy to Clipboard Toggle word wrap

  This example creates a placement bucket class with a specific replication policy defined in the JSON file.