🐍 boto3 설치 방법 – AWS Python SDK 간편 가이드

 

Amazon Web Services(AWS)를 Python에서 사용하려면 boto3라는 라이브러리를 설치해야 합니다. 이 글에서는 boto3를 설치하는 가장 쉬운 방법과 주의사항까지 모두 정리해드립니다.

---

✅ boto3란?

boto3는 Python용 AWS SDK로, S3, EC2, DynamoDB 등 대부분의 AWS 서비스를 Python 코드로 제어할 수 있게 해줍니다.

---

🛠 boto3 설치 방법

1. pip로 설치 (가장 기본적인 방법)

pip install boto3

2. 가상환경에 설치 (권장)

프로젝트마다 독립된 환경을 만들고 싶다면 아래처럼 가상환경을 설정해 설치하세요.

# 가상환경 생성
python -m venv venv

# 가상환경 활성화 (Windows 기준)
venv\Scripts\activate

# boto3 설치
pip install boto3

3. 설치 확인

설치가 제대로 되었는지 확인하려면 다음 명령을 실행해보세요.

pip show boto3

또는 Python 인터프리터에서 직접 확인할 수 있습니다.

import boto3
print(boto3.__version__)

---

🔐 AWS 인증 정보 설정 (필수)

boto3를 사용하려면 AWS 자격 증명이 필요합니다. 다음 명령어로 CLI 설정을 해주세요.

aws configure

입력할 내용:

• AWS Access Key ID
• AWS Secret Access Key
• Region (예: ap-northeast-2)
• Output format (json 권장)

---

💡 참고사항

• boto3는 자동으로 ~/.aws/credentials 파일을 사용해 인증합니다.
• 회사/기관 환경이라면 IAM Role을 사용하거나 환경 변수로 설정할 수도 있습니다.
• Windows 환경이라면 관리자 권한으로 터미널을 실행하세요.

---

✅ 결론

boto3 설치는 매우 간단하지만, AWS 자격 증명과 환경 설정까지 마쳐야만 정상적으로 사용할 수 있습니다. 가상환경을 활용하면 프로젝트별로 깨끗한 환경을 유지할 수 있으니 꼭 활용해보세요.