In this guide, we will learn how to use s3cmd as a client for ArvanCloud. S3cmd is a tool that allows you to create, list, or delete buckets from the terminal and download, upload, and delete objects to\/from your bucket.<\/p>\n
You can install S3cmd from the command line using your Linux distribution’s Package Manager.<\/p>\n
Enter the following command to update and upgrade your packages:<\/p>\n
apt update && apt upgrade -y<\/code><\/pre>\nEnter the following command to install s3cmd:<\/p>\n
apt install s3cmd<\/code><\/pre>\nS3cmd Configuration<\/h2>\n
Create a configuration file called .s3cfg in the HOME directory:<\/p>\n
cd $HOME\r\ntouch .s3cfg<\/code><\/pre>\nOpen the file with a text editor like nano:<\/p>\n
nano .s3cfg<\/code><\/pre>\nCopy and paste the following text into the file, then save and close it. Note that you must replace the Access Key and Secret Key values with your own, which are available in the dashboard of your user panel.<\/p>\n
[default]\r\n# Login credentials\r\naccess_key = <ACCESS_KEY>\r\nsecret_key = <SECRET_KEY>\r\nhost_base = https:\/\/s3.ir-thr-at1.arvanstorage.ir\r\nhost_bucket = https:\/\/s3.ir-thr-at1.arvanstorage.ir\r\nuse_https = True<\/code><\/pre>\nAn alternative solution to creating a configuration file is to use the s3cmd –configure command.<\/p>\n
Using Object Storage with S3cmd<\/h2>\n
The features available in the Object Storage user panel or tools such as S3browser can be easily implemented with the help of S3cmd. In the following, we will examine the commands related to working with ArvanCloud Object Storage using S3cmd.<\/p>\n
Creating a New Bucket<\/h3>\n
Enter the following command to create a new bucket. Be careful that the bucket’s name must be a unique combination of numbers and small letters. Here we have chosen the name \u201cnewbucket\u201d.<\/p>\n
s3cmd mb s3:\/\/newbucket<\/code><\/pre>\nThe output of the command will be similar to the following:<\/p>\n
Bucket 's3:\/\/newbucket\/' created<\/code><\/pre>\nUploading Files to a Bucket<\/h3>\n
You can use the following command to upload the file to the bucket:<\/p>\n
s3cmd put logs.txt photo1.jpg s3:\/\/newbucket<\/code><\/pre>\nThe output of this command will be as follows:<\/p>\n
logs.txt -> s3:\/\/newbucket\/logs.txt [1 of 2]\r\n0 of 0 0% in 0s 0.00 B\/s done\r\nphoto1.jpg -> s3:\/\/newbucket\/photo1.jpg [2 of 2]\r\n0 of 0 0% in 0s 0.00 B\/s done<\/code><\/pre>\nListing Files in a Bucket<\/h3>\n
To view the list of files in a bucket, use the following command. Here we list all the files in the \u201cnewbucket\u201d bucket:<\/p>\n
s3cmd ls s3:\/\/newbucket<\/code><\/pre>\nYou should see an output similar to the following, which includes the files inside the bucket:<\/p>\n
2021-07-10 06:23 0 s3:\/\/newbucket\/logs.txt\r\n2021-07-10 06:23 0 s3:\/\/newbucket\/photo1.jpg<\/code><\/pre>\nDownloading a File from the Bucket<\/h3>\n
Use the following command to download an object from the bucket to your system. For example, here we downloaded the logs.txt file from \u201cnewbucket\u201d:<\/p>\n
s3cmd get s3:\/\/newbucket\/logs.txt logs.txt<\/code><\/pre>\nThe output will be as follows:<\/p>\n
s3:\/\/newbucket\/logs.txt -> logs.txt [1 of 1]\r\n0 of 0 0% in 0s 0.00 B\/s done<\/code><\/pre>\nRemoving a File from the Bucket<\/h3>\n
You can use the following command to delete a file from the bucket. For example, here we delete the logs.txt file from the \u201cnewbucket\u201d:<\/p>\n
s3cmd del s3:\/\/newbucket\/logs.txt<\/code><\/pre>\nYou should see the output as follows:<\/p>\n
delete: 's3:\/\/newbucket\/logs.txt'<\/code><\/pre>\nDeleting a Bucket<\/h3>\n
To delete a bucket, use the following command. Here we delete \u201cnewbucket\u201d:<\/p>\n
s3cmd rb s3:\/\/newbucket<\/code><\/pre>\nThe output will be similar to the following:<\/p>\n
Bucket 's3:\/\/newbucket\/' removed<\/code><\/pre>\nCORS Configuration<\/h2>\n