Chapter 5. Configuring namespace buckets
Namespace buckets let you connect data repositories on different providers together, so you can interact with all of your data through a single unified view. Add the object bucket associated with each provider to the namespace bucket, and access your data through the namespace bucket to see all of your object buckets at once. This lets you write to your preferred storage provider while reading from multiple other storage providers, greatly reducing the cost of migrating to a new storage provider.
- Connect your providers to the Multicloud Object Gateway.
- Create a namespace resource for each of your providers so they can be added to a namespace bucket.
- Add your namespace resources to a namespace bucket and configure the bucket to read from and write to the appropriate namespace resources.
You can interact with objects in a namespace bucket using the S3 API. See S3 API endpoints for objects in namespace buckets for more information.
A namespace bucket can only be used if its write target is available and functional.
5.1. Adding provider connections to the Multicloud Object Gateway
You need to add connections for each of your providers so that the Multicloud Object Gateway has access to the provider.
Prerequisites
- Administrative access to the OpenShift Console.
Procedure
-
In the OpenShift Console, click Home
Overview and click the Object Service tab. - Click Multicloud Object Gateway and log in if prompted.
- Click Accounts and select an account to add the connection to.
- Click My Connections.
Click Add Connection.
- Enter a Connection Name.
- Your cloud provider is shown in the Service dropdown by default. Change the selection to use a different provider.
- Your cloud provider’s default endpoint is shown in the Endpoint field by default. Enter an alternative endpoint if required.
- Enter your Access Key for this cloud provider.
- Enter your Secret Key for this cloud provider.
- Click Save.
5.2. Adding namespace resources using the Multicloud Object Gateway
Add existing storage to Multicloud Storage Gateway as namespace resources so that they can be included in namespace buckets for a unified view of existing storage targets, such as Amazon Web Services S3 buckets, Microsoft Azure blobs, and IBM Cloud Object Storage buckets.
Prerequisites
- Administrative access to the OpenShift Console.
- Target connections (providers) are already added to the Multicloud Object Gateway. See Section 5.1, “Adding provider connections to the Multicloud Object Gateway” for details.
Procedure
-
In the OpenShift Console, click Home
Overview and click on the Object Service tab. - Click Multicloud Storage Gateway and log in if prompted.
- Click Resources, and click the Namespace Resources tab.
Click Create Namespace Resource.
In Target Connection, select the connection to be used for this namespace’s storage provider.
If you need to add a new connection, click Add New Connection and enter your provider details; see Section 5.1, “Adding provider connections to the Multicloud Object Gateway” for more information.
- In Target Bucket, select the name of the bucket to use as a target.
- Enter a Resource Name for your namespace resource.
- Click Create.
Verification
- Verify that the new resource is listed with a green check mark in the State column, and 0 buckets in the Connected Namespace Buckets column.
5.3. Adding resources to namespace buckets using the Multicloud Object Gateway
Add namespace resources to namespace buckets for a unified view of your storage across various providers. You can also configure read and write behaviour so that only one provider accepts new data, while all providers allow existing data to be read.
Prerequisites
- Ensure that all namespace resources you want to handle in a bucket have been added to the Multicloud Object Gateway: Adding namespace resources using the Multicloud Object Gateway.
Procedure
-
In the OpenShift Console, click Home
Overview and click the Object Service tab. - Click Multicloud Object Gateway and log in if prompted.
- Click Buckets, and click on the Namespace Buckets tab.
Click Create Namespace Bucket.
- On the Choose Name tab, specify a Name for the namespace bucket and click Next.
On the Set Placement tab:
- Under Read Policy, select the checkbox for each namespace resource that the namespace bucket should read data from.
- Under Write Policy, specify which namespace resource the namespace bucket should write data to.
- Click Next.
- Do not make changes on the Set Caching Policy tab in a production environment. This tab is provided as a Development Preview and is subject to support limitations.
- Click Create.
Verification
- Verify that the namespace bucket is listed with a green check mark in the State column, the expected number of read resources, and the expected write resource name.
5.4. Amazon S3 API endpoints for objects in namespace buckets
You can interact with objects in namespace buckets using the Amazon Simple Storage Service (S3) API.
Red Hat OpenShift Container Storage 4.6 supports the following namespace bucket operations:
See the Amazon S3 API reference documentation for the most up-to-date information about these operations and how to use them.
Additional resources