Aiden's Lab 뉴스레터
Posts
🔭Pulumi를 활용하여 Python 언어로 AWS 리소스 관리하기 - 바로 따라해볼 수 있는 Pulumi 도입 핵심 가이드

🔭Pulumi를 활용하여 Python 언어로 AWS 리소스 관리하기 - 바로 따라해볼 수 있는 Pulumi 도입 핵심 가이드

Pulumi를 활용하여 Python 언어로 AWS 리소스를 관리하는 핵심 가이드를 공유드립니다.

Aiden Kim
June 02, 2025

안녕하세요, Aiden’s Lab 뉴스레터입니다.

우리가 지난 글에서 IaC가 필요한 이유와 Pulumi의 동작 방식까지 살펴봤는데요.

이번 글에서는 Pulumi를 활용해서 AWS SQS를 배포하는 과정을 통해 Pulumi의 핵심 워크플로우를 정리해봤습니다.

제가 직접 테스트하면서 작성한 가이드이니, IaC와 Pulumi에 관심 있으시다면 꼭 확인해주세요!

1️⃣Pulumi 설치 및 AWS 계정 설정

Pulumi를 사용하기 위해서는 먼저 사용 중인 PC에 Pulumi CLI를 설치하고, AWS 계정 설정을 마쳐야 합니다.

그리고 Python 패키지 관리자 pip와 가상 환경 venv가 미리 설치되어 있어야 합니다.

저는 WSL 환경이기 때문에 아래 명령어를 터미널에서 실행해 Pulumi를 설치했습니다.

curl -fsSL https://get.pulumi.com | sh

자동으로 Pulumi 설치 스크립트가 실행되어서 설치가 완료되면 아래와 같이 Pulumi 버전을 조회할 수 있게 됩니다.

Pulumi를 사용하려면 Pulumi 클라우드에 로그인을 하거나 로컬 로그인을 해야 합니다. 지금은 빠른 실습을 위해 아래 명령어로 로컬 로그인을 하겠습니다.

pulumi login --local

그럼 아래와 같이 현재 사용자 이름으로 로그인되었다고 표시됩니다.

다음은 클라우드 계정 설정인데요. Pulumi CLI가 AWS 리소스를 생성하거나 관리하려면 사용 중인 AWS 계정 정보를 알아야 합니다.

만약 로컬에 이미 AWS CLI가 설치되어 있다면 별도의 계정 설정은 필요 없지만, AWS CLI를 설치하지 않았거나 CI/CD에서 Pulumi를 사용하는 경우에는 아래처럼 AWS Access Key ID와 AWS Secret Access Key가 로컬 환경변수에 저장되어 있어야 합니다.

export AWS_ACCESS_KEY_ID="<AWS 계정의 ACCESS KEY ID>"
export AWS_SECRET_ACCESS_KEY="<AWS 계정의 SECRET ACCESS KEY>"

2️⃣새로운 Pulumi 프로젝트 생성

이제 Pulumi를 시작할 준비가 끝났습니다. 원하는 폴더로 이동한 다음 새로운 Pulumi 프로젝트를 생성해보죠.

본 가이드는 AWS 인프라 관리를 Python으로 할 것이기 때문에 aws-python이란 템플릿 이름을 붙인 아래 명령어를 실행합니다.

pulumi new aws-python

그러면 아래 이미지와 같이 터미널 상에서 프로젝트 이름과 설명, 스택 이름, 비밀번호, 패키지 관리자, AWS 리전을 설정하게 됩니다.

이 과정까지 무사히 마치면 Pulumi 프로젝트 생성에 성공입니다!🎉

해당 경로에 아래와 같이 기본적인 프로젝트 구조와 예제 코드가 생성된 것을 확인할 수 있는데요.

Pulumi 동작에 필요한 핵심 파일은 아래와 같습니다.

Pulumi.yaml: 프로젝트의 메타데이터가 포함된 파일
Pulumi.<스택명>.yaml: 특정 스택(예: dev, prod)의 구성 값을 저장된 파일
__main__.py: 실제 인프라 코드를 작성할 파일
requirements.txt: 의존성 관리 파일

“그렇군요... 근데 스택이 뭐예요?”

아까부터 스택이란 용어가 계속 나와서 궁금하실 수 있는데요.

Pulumi는 동일한 인프라 코드를 사용하되, 서로 격리된 인스턴스를 구성할 수 있도록 했습니다. 그걸 Pulumi에서 스택이라고 부릅니다.

예를 들어, dev, staging, production과 같이 각기 다른 목적의 환경을 동일한 코드로 관리할 수 있는 것이죠.

각 스택은 자신만의 구성 설정과 상태 정보를 가지기 때문에 하나의 스택이 변경되었다고 해서 다른 스택에 영향을 주지 않습니다.

3️⃣Pulumi 인프라 관리 코드 작성

다시 Pulumi 프로젝트로 돌아오겠습니다. 프로젝트를 새로 생성할 때 만들어진 실제 인프라 코드(__main__.py)에는 AWS S3 버킷을 생성하는 예제 코드가 들어있을 텐데요.

S3 버킷을 생성하는 예제 코드도 좋지만, 본 가이드에서는 애플리케이션 확장성과 안정성을 높일 때 자주 사용되는 AWS SQS 리소스 생성 예제를 준비했습니다.

AWS SQS가 무엇인지 궁금하신 분도 계실 텐데요.

SQS는 완전 관리형 메시지 대기열 서비스로, 애플리케이션의 구성 요소 간에 어떤 메시지든 안정적으로 전송, 저장, 수신할 수 있도록 도와줍니다.

좀 더 자세한 설명이 궁금하시다면 제가 지난번에 AWS SQS와 SNS를 비교한 글을 참고해주세요.

그럼, 이제 인프라 코드 파일(__main__.py)에 아래 AWS SQS 생성 예제 코드를 넣어줍니다.

import pulumi
import pulumi_aws as aws

# SQS 생성
# mySimpleQueue는 Pulumi 프로그램 내에서 이 리소스를 식별하는 논리적 이름
my_queue = aws.sqs.Queue("mySimpleQueue",
    name="my-app-queue",  # 실제 생성될 큐 이름 (선택 사항, 지정 안하면 Pulumi가 자동 생성)
    tags={
        "Environment": "dev",
        "Project": "MyNewsletterApp",
    })

# 생성된 SQS Queue의 정보 출력
# pulumi.export()를 사용하면 `pulumi up` 실행 후 터미널에 해당 값 출력
pulumi.export("queue_url", my_queue.id) # 생성된 SQS의 URL 반환
pulumi.export("queue_arn", my_queue.arn) # 생성된 SQS의 Amazon Resource Name (ARN) 반환