aws/troubleshooting-s3-files

troubleshooting-s3-files은(는) 무엇을 하나요?

Amazon S3 Files 문제를 진단하고 해결합니다. 마운트 실패, 권한 오류, 동기화 문제, 성능 저하 등을 포함합니다. 사용자가 S3 파일 시스템을 마운트할 수 없거나, 접근 거부 오류가 발생하거나, 변경 사항이 S3에 동기화되지 않거나, lost+found에 파일이 표시되거나, 예상보다 느리게 작동할 때 사용하세요.

문제 진단

1. 마운트 실패: S3 파일 시스템을 마운트하려고 할 때 오류가 발생하면 다음을 확인하세요.

   • IAM 역할 또는 사용자에 s3:ListBucket 및 s3:GetObject 권한이 있는지 확인합니다.
   • 마운트 명령의 버킷 이름과 경로가 올바른지 확인합니다.
   • 네트워크 연결 및 DNS 해석이 작동하는지 확인합니다.

2. 권한 오류 (Access Denied): 접근 거부 오류가 발생하면:

   • IAM 정책을 검토하여 필요한 S3 작업에 대한 권한이 있는지 확인합니다.
   • 버킷 정책이 요청을 허용하거나 거부하는지 확인합니다.
   • 객체 수준 권한이 올바르게 설정되었는지 확인합니다.

3. 동기화 문제: S3로 변경 사항이 동기화되지 않는 경우:

   • aws s3 sync 명령의 --delete 플래그 사용 여부를 확인합니다.
   • 로컬 파일과 S3 객체의 최종 수정 시간을 비교합니다.
   • S3 버킷에서 버전 관리가 활성화되어 있는지 확인합니다.

4. lost+found 디렉토리: 파일이 lost+found에 나타나는 경우:

   • 이는 일반적으로 파일 시스템 불일치 또는 강제 종료 후 발생합니다.
   • fsck 명령을 사용하여 파일 시스템을 복구하세요.

5. 성능 문제: 예상보다 느린 경우:

   • 네트워크 대역폭 및 지연 시간을 확인합니다.
   • S3 요청 레이트 제한을 초과하지 않았는지 확인합니다.
   • 대용량 파일의 경우 멀티파트 업로드를 사용하는 것이 좋습니다.

해결 방법

마운트 실패 해결

1. AWS CLI를 사용하여 S3 버킷에 접근할 수 있는지 테스트합니다:

   aws s3 ls s3://your-bucket-name/
   

2. 필요한 권한이 있는지 IAM 정책을 확인합니다:

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Action": [
           "s3:ListBucket",
           "s3:GetObject"
         ],
         "Resource": [
           "arn:aws:s3:::your-bucket-name",
           "arn:aws:s3:::your-bucket-name/*"
         ]
       }
     ]
   }
   

3. 마운트 명령을 다시 시도합니다:

   sudo mount -t s3fs your-bucket-name /path/to/mountpoint -o passwd_file=/path/to/passwd-file
   

권한 오류 해결

1. 버킷 정책을 확인하여 요청을 허용하는지 확인합니다.
2. IAM 사용자/역할에 s3:PutObject 및 s3:DeleteObject 권한을 추가합니다.
3. 객체 수준 ACL이 올바르게 설정되었는지 확인합니다.

동기화 문제 해결

1. 증분 동기화를 위해 aws s3 sync 명령을 사용합니다:

   aws s3 sync /local/dir s3://your-bucket-name/ --delete
   

2. S3 버킷에서 버전 관리를 활성화하여 변경 사항을 추적합니다.
3. --exclude 및 --include 패턴을 사용하여 동기화 범위를 제어합니다.

lost+found 복구

1. fsck 명령을 사용하여 파일 시스템을 복구합니다:

   sudo fsck /path/to/mountpoint
   

2. lost+found에서 파일을 복사하고 적절한 위치로 이동합니다.
3. 정기적인 백업을 설정하여 데이터 손실을 방지합니다.

성능 최적화

1. 멀티파트 업로드 임계값을 조정합니다 (기본값 8MB):
   • 환경 변수 S3FS_MULTIPART_UPLOAD_THRESHOLD를 설정합니다.
2. 캐싱을 활성화하여 읽기 성능을 향상시킵니다:
   • -o use_cache=/path/to/cache 옵션을 사용합니다.
3. 네트워크 연결이 안정적인지 확인하고 필요한 경우 AWS Direct Connect를 고려합니다.