Beetroot LogoBeetroot

Upload Raw Photos

Upload test photos into S3 so we can trigger the ingestion pipeline in later steps.

Goal

Upload a few test images into the raw bucket under photos-raw/. These uploads will later be used to trigger the ingestion Lambda.

Minimum prerequisites

Make sure:

  • Your AWS CLI works (aws sts get-caller-identity)
  • Your raw bucket exists: beetroot-raw
  • Your prefix exists (or will be created automatically): photos-raw/
  • You are using the same region everywhere: us-east-1

Choose the right photos

Use 2-3 photos that contain multiple faces (group photos work best). This makes the face grouping output much easier to understand later.

Step 1: Create a local test folder

  1. Create a folder on your computer named:

    • beetroot-test-photos/
  2. Add 2-3 images inside it:

    • JPG or PNG works best
    • Prefer images where faces are clear and not too small

Example:

  • beetroot-test-photos/group1.jpg
  • beetroot-test-photos/group2.jpg

Step 2: Upload photos using AWS CLI

Why CLI?

You can upload the photos from the Console if you want, but CLI is faster for repeated testing, and later steps in this project will also rely on CLI commands so it's worth learning now.

From the folder's parent directory, run:

aws s3 cp ./v2-test-photos s3://beetroot-raw/photos-raw/ --recursive --region us-east-1

What this does:

  • uploads every file in v2-test-photos/
  • places them under photos-raw/ in the raw bucket

What does `--recursive` do?

--recursive tells the AWS CLI to upload everything inside the folder, including any subfolders.

Without --recursive, aws s3 cp would only upload a single file (not the whole directory).

Step 3: Verify the upload

Run:

aws s3 ls s3://beetroot-raw/photos-raw/ --region us-east-1

You should see your uploaded image files listed.

If you see an error

Common causes:

  • Wrong bucket name
  • Wrong region (us-east-1 vs another region)
  • AWS CLI not configured correctly

Fix those before moving on, or the next steps will not work.

On this page