Create an S3 Bucket

Table of contents
  1. 1. Objective
  2. 2. Create an S3 Bucket

Objective

In S3, a bucket is essentially a folder where you can store files.  Think of S3 as one big hard drive that everyone shares.  As a result, you'll have to create unique bucket names.  You will not be able to create generic bucket names like "files" or "images."  Therefore, it's a good idea to add your application name as a prefix to any bucket name.  ex: myapp_images

NOTE: You can only create an S3 bucket with a Developer or Premium account.  The maximum number of S3 buckets per account is 100. 

If you plan to use the MySQL Backup feature in the RightScale ServerTemplates, be sure to make an S3 bucket first before you use the ServerTemplates.  Use an S3 bucket name that's all lower-case.  Later, when you are asked for the S3 bucket for the DB_BACKUPS script, you will be ready with a place to store the files.

Inside your S3 bucket you can place all of the MySQL Backups for several MySQL servers by defining a unique prefix for each MySQL Master-DB server that you deploy.

WARNING! Watch out for two servers that backup into the same S3 bucket with the same prefix!  You'll run into problems if you "Clone" a deployment and forget to rename the prefix or the name of the S3 bucket before launching the server.

Create an S3 Bucket

Go to Manage -> Storage -> S3 Browser.
Click New Bucket

01-s3_home.gif

 

Name the bucket with your application name appended with “_production_backups.”  For example, “myapp_production_backups.” Remember, the S3 namespace is global, so if your application name is common, you may need to come up with a unique name for it.

02-s3_create_bucket.gif

Click Create.

You should now see your new bucket listed.

03-s3_bucket_list.gif

Click on the bucket name to see its contents. For now, it is empty. But, to upload files, simply click on the bucket where you want to store your file(s). 

NOTE: You will not be able to delete a bucket until all of its contents have been deleted.

04-s3_upload.gif

You now have a bucket where you can store files on S3. 

 

 ----------------------

Did you find this document helpful?  Please feel free to leave us a comment below so that we'll know how we can improve our documentation.  Thanks!

 

Tag page
Viewing 2 of 2 comments: view all
If you plan to use the MySQL Backup in the RightScale Templates make a Bucket first before you use the templates. Make the name all lower case. When you are asked later for the Bucket for the DB_BACKUPS you will be ready with a place to store the files.

Inside that Bucket you can place all of the MySQL Backups for several MySQL servers by defining a unique prefix for each MySQL Master Server you deploy.

Watch out for two servers that backup into the same bucket with the same prefix! This can happen if you "Clone" a Deployment and forget to rename the prefix or the Bucket before launch.

Ed@RightScale.com

Posted 06:10, 29 Jul 2008
Thanks for the helpful comments Ed. I've incorporated them into the main body text.

-Dean
Posted 17:39, 20 Aug 2008
Viewing 2 of 2 comments: view all
You must login to post a comment.