[AWS] CLI를 통해 S3 사용하기

 

안녕하세요, 달콤한달팽이입니다.🐌😎

 

이전 글에서 S3를 생성하고, 사용하는 방법을 실습해보며 CLI를 사용하는 방식에 대해 가볍게 알아보았습니다.

 

이번 글에선 CLI를 사용하는 방법을 조금 더 자세하게 알아보는 시간을 가져볼 예정입니다.

 

S3를 처음 사용해보시는 분이라면 아래 글을 먼저 읽어보시는 것을 권장드려요!

 

[AWS] S3 사용하기

 

---

AWS CLI란?

AWS CLI란, AWS의 오픈 소스 도구로 명령어를 통해 AWS 서비스와 상호 작용을 할 수 있는 기능을 의미합니다.

 

AWS에서는 CLI를 통해 거의 모든 기능을 수행할 수 있기 때문에,

명령어를 숙지하고 사용 방법이 어렵다는 단점을 제외한다면 아주 강력한 도구가 될 수 있습니다!

---

1) 사전 작업 - 권한 부여

사실상 모든 AWS 리소스를 제어할 수 있는 CLI 사용을 위해선,

CLI를 사용하는 사용자가 올바른 사용자인지 검증할 방법이 필요합니다.

 

이를 위해선 크게 두 가지 방법이 존재합니다.

  (1) 엑세스 키 사용

    - 장점: Access Key, Secret Access Key만 보유하고 있다면 어떤 서버에서든 사용 가능

    - 단점: Access Key를 분실 및 탈취로 인한 보안적인 문제가 발생할 수 있음

  (2) 서버 내 권한 부여

    - 장점: Key 분실로 인한 보안 위험이 적음

    - 단점: 권한이 부여된 특정 서버에서만 CLI 사용 가능

 

이렇듯 두 가지 검증 방식의 장단점이 명확하기 때문에 상황에 맞게 잘 고려하시는 것이 중요합니다!

 

2) 사전 작업 - CLI 설치 확인 및 설치

AWS CLI를 사용하기 위해선 CLI가 설치되어 있어야 합니다.

이를 확인하기 위해선 CLI를 사용할 서버에 접속하여 Access Key를 등록하는 명령어를 사용해봅시다!

  aws configure

성공 시 아래와 같이 Access Key를 물어보는 문구가 출력됩니다.

 

실패 시 아래와 같이 aws 명령어를 찾을 수 없다는 문구가 출력됩니다.

 

AWS CLI가 설치되어 있지 않으신 분들은 아래 작업을 잘 따라와주세요!

 

AWS에서 제공하는 zip파일을 다운로드, 압축해제 후 이를 실행해 주세요.

  curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
  unzip awscliv2.zip
  sudo ./aws/install

 

이후 다시 명령어를 사용해 보면 정상적으로 사용이 가능할 것입니다.

참 쉽죠?!

 

이제 엑세스 키를 발급받았다면 Key를 등록해 주세요

(저는 서버에 권한을 부여하는 방식을 사용할 것이므로 그냥 넘어가도록 하겠습니다.)

 

3 ) 커맨드 옵션

CLI를 사용할 때에 사용 가능한 옵션은 수없이 많겠지만,

이 중에서도 몇 가지 옵션은 특히 자주 사용되므로 알아두면 좋습니다! 

 

강제 수행(--force)

버킷이 비어있지 않아도 강제로 삭제되도록 설정하는 옵션입니다.

주로 버킷 삭제(rb) 명령어에 사용됩니다.

 

커맨드 테스트(--dryrun)

명령어가 수행됐을 때, 어떤 결과가 예상될지 테스트를 진행해보는 옵션입니다.

 

하위 디렉터리 포함(--recursive)

명령어를 수행할 때, 하위 디렉터리를 포함할 때 사용되는 옵션입니다.

주로 파일 복제(cp), 파일 삭제(rm) 명령어에 사용됩니다.

 

ex) aws s3 cp . s3://{버킷명} --recursive

 

파일 포함 & 제외(--include & --exclude)

지정된 객체만 포함 혹은 제외되도록 설정하는 옵션입니다.

주로 파일 복제(cp), 파일 삭제(rm) 명령어에 사용됩니다.

 

ex) aws s3 cp . s3://{버킷명} --exclude "*.txt"

ex) aws s3 cp . s3://{버킷명} --include "*.txt"

 

 

---

앞으로 사용될 명령어의 모 버킷 경로는 모두 s3://{버킷명}/{버킷 경로}로 구성되어있다는점 참고바랍니다!

---

 

4 - 1) S3 목록 확인(ls)

우선 현재 생성되어 있는 S3의 목록을 확인해보겠습니다.

 

아래의 명령어를 통해 현재 4개의 버킷이 있다는 것을 알 수 있습니다.

 

  aws s3 ls {버킷 경로}

 

4 - 2) S3 생성 및 삭제(mb & rb)

현재 생성되어는 버킷이 아닌 다른 버킷을 사용하고 싶을 경우, 새로운 버킷 생성이 필요할 수 있습니다.

  aws s3 mb s3://{신규 버킷명}

 

또는 필요하지 않은 버킷을 삭제해야할 때도 있습니다.

(버킷 안에 내용물이 남아있는데 강제로 삭제를 원할 경우 --force 명령어를 추가해주세요!)

 

  aws s3 rb s3://{기존 버킷명}

 

4 - 3) 파일 이동(mv)

파일을 S3 버킷의 지정된 경로로 이동을 시켜야할 경우 아래와 같이 명령어를 사용합니다.

 

저는 동일한 버킷의 cli 경로에 있는 hello,cli.txt 파일을 console 경로로 이동시켜 보겠습니다.

(--dryrun 명령어를 통해 실제 명령어 수행(파일 이동)은 이루어지지 않고, 예상 결과만 출력하는 것도 가능합니다!)

 

  aws s3 mv {이동 대상 경로} {파일 저장 경로}

 

4 - 4) 파일 복사(cp)

만약 로컬과 버킷 간 파일 복사가 필요할 경우 아래와 같이 파일 복사를 수행합니다.

(--recursive 명령어를 통해 디렉터리와 이에 포함된 파일들도 복사할 수 있습니다!)

 

  aws s3 cp {이동 대상 경로} {파일 저장 경로}

 

3 - 5) 파일 동기화(sync)

만약 로컬과 버킷 간 중복되는 파일은 유지하고, 없는 파일은 복사하는 동기화를 수행하고 싶을 경우 동기화 명령어를 사용합니다.

 

  aws s3 sync {동기 주체} {동기 대상}

 

하지만 동기화를 수행해도 기존에 없는 파일을 복사해오기만 할 뿐, 삭제는 진행하지 않는다는 특징이 있습니다.

 

---

지금까지 CLI를 통해 S3를 제어하는 방법에 대하여 알아보았습니다.

 

보다 더 많은 내용을 확인하고 싶을 경우,  AWS 공식 문서를 확인해보시길 바랍니다!!

 

감사합니다.