AWS S3에 앱 연결하기

앱을 AWS S3에 연결하여 S3 버킷의 CSV, JSON, Parquet 등 데이터 파일을 Lovable 앱에서 읽고 쓸 수 있습니다.

Amazon S3는 클라우드 객체 스토리지 서비스입니다. S3 버킷에서 CSV, JSON, Parquet 등의 데이터 파일을 직접 읽고 쓸 수 있어 외부 데이터셋, 배치 내보내기, 파일 업로드, 파일 기반 데이터 소스로 작업하는 앱을 구축할 수 있습니다.

AWS S3를 연동하면 앱에서 다음과 같은 작업이 가능합니다

• S3 버킷에서 CSV, JSON 등 데이터 파일 읽기
• S3 버킷에 파일 업로드 (쓰기 접근 활성화 시)
• 접두사 필터링으로 버킷 내 객체 목록 조회 및 탐색
• 외부 데이터 소스를 Lovable 앱에 통합
• 엔터프라이즈 데이터 파이프라인의 배치 데이터 내보내기 접근

AWS S3는 S3에 저장된 파일(분석 내보내기, 데이터 파이프라인 출력, 사용자 업로드, 공유 데이터셋 등)을 읽거나 써야 할 때 적합합니다.

주요 활용 사례 및 예시 앱

AWS S3 연결 방식

각 AWS S3 연결은 하나의 S3 버킷에 연결됩니다. AWS S3를 연결할 때 해당 버킷에 대한 접근 권한이 있는 IAM 인증 정보를 제공합니다. 기본적으로 연결은 읽기 전용이지만, 파일 업로드를 허용하려면 읽기-쓰기 접근을 활성화할 수 있습니다.

Lovable 워크스페이스에서는

• AWS S3 연결을 여러 개 만들 수 있습니다
• 각 연결은 특정 버킷과 AWS 리전을 대상으로 합니다
• 각 연결은 자체 IAM 인증 정보를 사용합니다
• 같은 워크스페이스 내 여러 프로젝트가 하나의 연결을 공유할 수 있습니다

이를 통해 서로 다른 버킷(예: 운영 데이터와 스테이징 데이터)을 연결하거나 팀별로 접근을 분리할 수 있습니다.

AWS S3는 안전한 인증 정보 처리와 자동 요청 서명을 위해 Lovable의 게이트웨이 아키텍처를 사용합니다. 인증 및 사용량 제한에 대한 자세한 내용은 게이트웨이 기반 커넥터를 참고하세요.

AWS S3 연결하기

워크스페이스 admin 또는 owner가 AWS S3를 연결할 수 있습니다.

연결을 만들면 해당 워크스페이스의 모든 프로젝트에서 S3 버킷을 사용할 수 있습니다.

사전 준비

AWS S3를 연결하기 전에 다음을 준비하세요

• 연결하려는 S3 버킷에 접근 가능한 AWS 계정
• 적절한 S3 권한이 있는 IAM 사용자 (아래 참고)
• 버킷 이름 및 AWS 리전
• Lovable 워크스페이스 admin 또는 owner 권한

1단계: S3 접근 IAM 사용자 생성

Lovable에서 연결을 설정하기 전에 필요한 최소 권한을 가진 IAM 사용자를 AWS에 생성합니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "ListBucket",
      "Effect": "Allow",
      "Action": ["s3:ListBucket", "s3:GetBucketLocation"],
      "Resource": "arn:aws:s3:::YOUR-BUCKET-NAME"
    },
    {
      "Sid": "ReadObjects",
      "Effect": "Allow",
      "Action": ["s3:GetObject"],
      "Resource": "arn:aws:s3:::YOUR-BUCKET-NAME/*"
    }
  ]
}

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "ListBucket",
      "Effect": "Allow",
      "Action": ["s3:ListBucket", "s3:GetBucketLocation"],
      "Resource": "arn:aws:s3:::YOUR-BUCKET-NAME"
    },
    {
      "Sid": "ReadWriteObjects",
      "Effect": "Allow",
      "Action": ["s3:GetObject", "s3:PutObject"],
      "Resource": "arn:aws:s3:::YOUR-BUCKET-NAME/*"
    }
  ]
}

2단계: Lovable에 AWS S3 연결

연결이 완료되면 Lovable 앱에서 S3 버킷의 데이터를 읽을 수 있습니다.

서명된 URL을 위한 CORS 설정

파일 다운로드 및 업로드는 서명된 URL을 사용하며, 브라우저가 S3에 직접 접근합니다. 이를 위해 S3 버킷에 앱의 오리진에서 오는 요청을 허용하는 CORS (Cross-Origin Resource Sharing) 정책이 설정되어 있어야 합니다. 설정하지 않으면 브라우저가 요청을 차단합니다.

버킷에 CORS를 설정하는 방법

1. S3 콘솔을 열고 버킷을 선택합니다.
2. **Permissions → Cross-origin resource sharing (CORS)**로 이동합니다.
3. CORS 설정을 추가합니다. https://your-app-id.lovable.app을 앱의 실제 URL로 교체하세요.

[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT"],
    "AllowedOrigins": ["https://your-app-id.lovable.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]

제한 사항

AWS S3 커넥터는 다음을 지원하지 않습니다

• 버킷의 객체 삭제
• MinIO나 DigitalOcean Spaces 같은 AWS S3 이외의 S3 호환 서비스 연결
• 사용자별 AWS 로그인 (최종 사용자가 각자 AWS 계정을 연결)
• 실시간 이벤트 알림 또는 S3 이벤트 트리거

AWS S3 연결에서 프로젝트 연결 해제

Editor 이상 권한을 가진 사용자는 연결 자체를 삭제하지 않고 특정 프로젝트만 연결 해제할 수 있습니다. 연결은 다른 프로젝트에서 계속 사용할 수 있습니다.

연결 해제 방법

연결 해제 후 해당 프로젝트는 이 연결을 통해 AWS S3에 접근할 수 없습니다. 필요하면 다른 연결로 다시 연결할 수 있습니다.

AWS S3 연결 삭제

워크스페이스 admin 또는 owner가 AWS S3 연결을 삭제할 수 있습니다.

삭제 전에 Linked projects 섹션에서 현재 이 연결을 사용 중인 프로젝트를 먼저 확인하세요.

삭제 방법