Step-by-Step Instructions

1. Create an S3 Bucket

1. Log in to AWS Console:

   • Go to the AWS Management Console.

2. Navigate to S3:

   • Search for "S3" in the AWS services search bar.

3. Create a New Bucket:

   • Click on "Create bucket."

   • Enter a unique bucket name (e.g., my-sample-bucket).

   • Select a region close to your application or users.

   • Keep the default settings for now (block public access for security).

   • Click "Create bucket."

2. Install and Configure boto3 for Python

1. Install boto3:

Run the following command in your terminal or IDE:
bash
Copy code
pip install boto3

2. Set Up AWS CLI Credentials (Optional but Recommended):

Install the AWS CLI:
bash
Copy code
pip install awscli

Configure credentials:
bash
Copy code
aws configure

• Provide your:

  • Access Key ID

  • Secret Access Key

  • Default region (e.g., us-east-1).

3. Upload a Sample File to S3

1. Create a Sample File:

Save a file called sample.txt with the following content:
Copy code
Hello, AWS S3!

2. Write a Python Script to Upload the File:

python

Copy code

import boto3

# Step 1: Initialize the S3 client

s3 = boto3.client('s3')

# Step 2: Define bucket name and file details

bucket_name = 'my-sample-bucket'  # Replace with your bucket name

file_name = 'sample.txt'  # File to upload

s3_key = 'uploads/sample.txt'  # Destination key in the bucket

# Step 3: Upload the file

try:

    s3.upload_file(file_name, bucket_name, s3_key)

    print(f"File '{file_name}' uploaded successfully to '{bucket_name}/{s3_key}'")

except Exception as e:

    print(f"Error uploading file: {e}")

Resources

• AWS S3 Documentation:

  • Amazon S3 User Guide

• Udemy Course:

  • AWS Certified Solutions Architect

Expected Output

After running the script, the console should display:

arduino

Copy code

File 'sample.txt' uploaded successfully to 'my-sample-bucket/uploads/sample.txt'

Verify the file in the S3 console under the "uploads/" folder in your bucket.

Learning Outcomes

• Understand the fundamentals of AWS S3 and bucket setup.

• Install and configure boto3 for Python to interact with AWS services.

• Upload files programmatically to S3, setting a foundation for integrating cloud storage in larger applications.

This activity focuses on gaining hands-on experience with AWS S3 and Python by programmatically uploading a file to an S3 bucket using the boto3 library.

Goals:

1. Understand S3 integration with Python: Learn how to interact with AWS S3 using Python and the boto3 SDK.

2. Upload a file: Programmatically upload a sample file to your S3 bucket.

Prerequisites

1. AWS Account:

   • Set up an AWS account if you don’t already have one.

   • Obtain your Access Key ID and Secret Access Key from the AWS IAM Console.

2. Create an S3 Bucket:

   • Log in to the AWS Management Console.

   • Navigate to S3.

   • Create a bucket (e.g., my-sample-bucket).

3. Install boto3:

   • Ensure Python is installed on your machine.

Install boto3 via pip:
bash
Copy code
pip install boto3

4. Set Up AWS Credentials:

Use the AWS CLI or manually create a file at ~/.aws/credentials with your credentials:
plaintext
Copy code
[default]

aws_access_key_id = YOUR_ACCESS_KEY_ID

aws_secret_access_key = YOUR_SECRET_ACCESS_KEY

Steps to Upload a File to S3

1. Create a Sample File

Create a text file named sample.txt with the following content:

plaintext

Copy code

Hello, AWS S3! This is a sample file for testing uploads.

2. Write a Python Script

python

Copy code

import boto3

from botocore.exceptions import NoCredentialsError

# Step 1: Define S3 bucket and file details

bucket_name = "my-sample-bucket"  # Replace with your bucket name

file_name = "sample.txt"          # The local file to upload

s3_key = "uploads/sample.txt"     # The destination key (folder path in S3)

# Step 2: Initialize the S3 client

s3 = boto3.client('s3')

try:

    # Step 3: Upload the file to S3

    s3.upload_file(file_name, bucket_name, s3_key)

    print(f"File '{file_name}' successfully uploaded to '{bucket_name}/{s3_key}'")

except FileNotFoundError:

    print(f"The file '{file_name}' was not found.")

except NoCredentialsError:

    print("AWS credentials not found. Please configure them.")

except Exception as e:

    print(f"An error occurred: {e}")

Explanation of the Script

1. Define S3 Bucket and File Details:

   • bucket_name: Name of the bucket where the file will be uploaded.

   • file_name: The local file to upload.

   • s3_key: The destination path and name for the file in S3.

2. Initialize the S3 Client:

   • boto3.client('s3'): Creates a client to interact with the S3 service.

3. Upload the File:

   • upload_file(): Uploads the local file to the specified bucket and key.

4. Error Handling:

   • Handles errors like missing files or credentials using try-except blocks.

Run the Script

• Save the script as upload_to_s3.py.

Run it using Python:
bash
Copy code
python upload_to_s3.py

Expected Output

If successful, the script will print:

arduino

Copy code

File 'sample.txt' successfully uploaded to 'my-sample-bucket/uploads/sample.txt'

Verify the Upload

1. Log in to the AWS Management Console.

2. Navigate to your S3 bucket.

3. Check the uploads/ folder for the sample.txt file.

Extensions

Set Object ACL: Modify permissions for the uploaded object (e.g., make it public):
python
Copy code
s3.upload_file(file_name, bucket_name, s3_key, ExtraArgs={'ACL': 'public-read'})

• Enable Multipart Upload: Use for large files to optimize performance.

Generate a Presigned URL: Create a temporary link for file access:
python
Copy code

url = s3.generate_presigned_url('get_object',

                                Params={'Bucket': bucket_name, 'Key': s3_key},

                                ExpiresIn=3600)

print("Presigned URL:", url)

Learning Outcomes

• Understand the basic functionality of AWS S3.

• Configure and use boto3 to interact with S3.

• Programmatically upload files to S3 for integration into larger workflows.