Skill Level: Any
Connect to IBM Cloud Object Storage (IBM COS) Public Services to browse and synchronize an IBM COS bucket with local files folder. Cyberduck is a popular FTP client that can use the S3 API to authenticate and connect to IBM COS. It is a product that is licensed under the GPL. In this recipe, we demonstrate how to create a connection to IBM COS and synchronize a folder of local files to an IBM COS bucket.
You must install Cyberduck for the operation system that you use. Cyberduck can be downloaded for multiple operating systems from the Cyberduck website. Run the installation application and accept the defaults.
In addition, you need to have access to an IBM COS Public Services environment (will be referred as IBM COS hereafter). See the following link for signing up for an account: http://www-03.ibm.com/software/products/en/object-storage-public
To use Cyberduck to create a connection to IBM COS and synchronize a folder of local files to a bucket, complete the following steps:
Download, install, and start Cyberduck
Open a connection to IBM COS
The main window of the application opens (Figure-1), where you can create a connection to IBM COS. Click Open Connection to configure a connection to IBM COS.
Figure 1. Cyberduck main window
Create a connection to IBM COS
A window opens (Figure-2). From the drop-down menu at the top, select the S3 storage. Enter information into the following fields, and then click Connect:
- Server: Enter the nearest endpoint of IBM COS.
- Access Key ID.
- Secret Access Key.
Figure 2. Creating a connection to IBM COS.
Creating a bucket
Cyberduck takes you to the root of the account where buckets can be created. Right-click within the main window and select New Folder (the application deals with many transfer protocols where Folder is the more common container construct).
A dialog box opens (Figure-3). Enter the bucket name and then click Create.
Figure 3. Creating a bucket
View the bucket
After the bucket is created, double-click the bucket to view it. Within the bucket, you can perform various functions, such as upload files to the bucket, list bucket contents, download objects from the bucket, synchronize local files to a bucket, synchronize objects to another bucket, or create an archive of a bucket.
Synchronize folders to the bucket
Right-click within the bucket and select Synchronize.
A dialog box opens (Figure-4) where you can browse to the folder that you want to synchronize to the bucket. Select the folder and click Choose.
Figure 4. Selecting the source folder for synchronization
Perform the synchronization request
After you select the folder, a new dialog box opens. Here, a drop-down menu is available where you select the synchronization operation with the bucket.
- Download: This option downloads changed and missing objects from the bucket.
- Upload: This option uploads changed and missing files to the bucket.
- Mirror: This option performs both download and upload operations, ensuring that all new and updated files and objects are synchronized between the local folder and the bucket.
Select Upload from the menu and click Continue to start the synchronization request.
Figure 5. Selecting a synchronization request operation.
You see that the folder is synchronized to the IBM COS bucket.
This recipe showed a simple but useful method for managing IBM COS buckets from a desktop. You can browse IBM COS like your hard disk drive and perform various functions within the bucket, such as upload files to the bucket, list bucket contents, download objects from the bucket, synchronize local files to a bucket, synchronize objects to another bucket, or create an archive of a bucket.
We hope that this article provides enough of a background to encourage you to explore Cyberduck integration with IBM COS.