본문으로 건너뛰기

Object Storage Client Tool - s3cmd

s3cmd 설치 및 기본 사용 가이드

Amazon S3 및 호환 오브젝트 스토리지(S3 API 기반)에 파일을 업로드, 다운로드, 동기화, 삭제 및 관리할 수 있는 명령줄 기반 오브젝트 스토리지 관리 도구입니다.
대용량 데이터의 백업, 정기 동기화, 파일 배포 등 다양한 자동화 환경에 활용되며, S3 API를 지원하는 iwinv 오브젝트 스토리지에서도 사용할 수 있습니다.

해당 메뉴얼은 Object Storage 지원 Tool 중 하나인 s3cmd의 설치방법과 기본 사용법에 대해 설명합니다.

패키지 설치 및 구성​

패키지 설치​

# Debian
apt install s3cmd

# RHEL
yum install s3cmd

오브젝트 스토리지 API 인증키​

인증키 확인 가이드

오브젝트스토리지 API 인증키는 아래 가이드를 통해 참고하여 확인하시기 바랍니다.
오브젝트 스토리지 API 인증키 가이드

API 용어​

  • Endpoint : 오브젝트 스토리지 인증키 관리 ➡️ API Endpoint
  • Access_Key : 오브젝트 스토리지 인증키 관리 ➡️ Access Key ID
  • Secret_Key : 오브젝트 스토리지 인증키 관리 ➡️ Secret Key ID

위에서 확인한 인증키를 참고해 s3cmd 인증 구성합니다.

s3cmd --configure

인증 구성

# Acces_Key , Secret_Key , Endpoint 차례대로 입력
# %bucket)s.Endpoint 입력 필수 ex) %bucket)s.kr.object.iwinv.kr

기본 사용법​

버킷 관리​

버킷 생성​

s3 cmd mb s3://[bucket_name]
ex) s3cmd mb s3://iwinv-bucket

s3cmd mb s3://[bucket_name]

버킷 삭제​

s3cmd rb s3://[bucket_name]
ex) s3cmd rb s3://iwinv-bucket

s3cmd rb s3://[bucket_name]

버킷 리스트 확인​

s3cmd ls

오브젝트 관리​

오브젝트 업로드​

s3cmd put [file_name] s3://[bucket_name]
ex) s3cmd put test.txt s3:/iwinv-buckt

s3cmd put [file_name] s3://[bucket_name]

오브젝트 다운로드​

s3cmd get s3://[bucket_name]/[object_name] [path]/[file_name]
ex) s3cmd get s3://iwinv-bucket/test.txt /home/ubuntu/test.txt

s3cmd get s3://[bucket_name]/[object_name] [path]/[file_name]

오브젝트 리스트 확인​

s3cmd ls s3://[buckt_name]
ex) s3cmd ls s3://iwinv-bucket

s3cmd ls s3://[bucket_name]

오브젝트 삭제​

s3cmd rm s3://[bucket_name]/[object_name]
ex) s3cmd rm s3://iwinv-bucket/test.txt

s3cmd rm s3://[bucket_name]/[object_name]