🔍 개요
Dapr(Distributed Application Runtime)는 마이크로서비스 개발을 돕는 오픈소스 런타임입니다.
한 줄로 말하면 내 앱이 Redis, Kafka, Key Vault 같은 외부 시스템을 직접 다루지 않아도 되게 "대신 해 주는" 도우미입니다.
비유: 호텔 컨시어지
호텔에 묵고 있다고 생각해 보겠습니다.
- 컨시어지가 없으면(Dapr 없이): 택시를 부르려면 택시 회사에, 공항 셔틀은 셔틀 회사에, 공연 티켓은 티켓 사이트에 각각 직접 연락해야 합니다. 모든 업체의 방식을 내가 알아야 합니다.
- 컨시어지가 있으면(Dapr 사용): "택시 불러 주세요" 한마디면 컨시어지가 알아서 연락하고 결제합니다. 내일 택시 회사가 바뀌어도 나는 똑같이 "택시 불러 주세요"라고 말하면 됩니다.
Dapr가 바로 이 컨시어지 역할을 합니다.
1. Dapr가 없을 때와 있을 때
Dapr가 없을 때
[내 앱]
├── Redis SDK 설치
├── Kafka SDK 설치
├── Azure Service Bus SDK 설치
├── Key Vault SDK 설치
└── 각각 연결 코드, 인증 코드, 재시도 코드 직접 작성앱 코드가 인프라 지식으로 가득 찹니다. Redis 주소가 바뀌면 코드를 고쳐야 하고, Kafka를 Service Bus로 바꾸면 관련 코드를 다시 작성해야 합니다.
Dapr가 있을 때
[내 앱]
└── "저장해 줘", "메시지 보내 줘", "시크릿 줘" 요청만
[Dapr 사이드카] ← 내 앱 옆에 붙어서 실행
├── Redis에 저장 처리
├── Kafka에 메시지 전송
└── Key Vault에서 시크릿 읽기앱은 "무엇을 해 달라"만 말하고, Dapr가 "어떻게 할지"를 맡습니다.
2. 사이드카(Sidecar)란
사이드카는 오토바이 옆에 붙은 보조석을 떠올리면 됩니다. 내 앱 컨테이너 옆에 Dapr 컨테이너(daprd)가 하나 더 붙어서 실행됩니다.
- 두 컨테이너는 같은 Pod 안에서
localhost로 통신합니다. - Dapr 사이드카는 HTTP 포트 3500, gRPC 포트 50001로 API를 제공합니다.
- 앱은
localhost:3500에 요청만 보내면 되고, Redis가 어디 있는지 몰라도 됩니다.
3. Dapr가 해 주는 일 (Building Blocks)
Dapr는 기능을 빌딩 블록(Building Block)이라는 API 묶음으로 제공합니다. 필요한 것만 골라 쓸 수 있습니다.
| 빌딩 블록 | 쉽게 말하면 | 예 |
|---|---|---|
| 상태 관리 (State) | "이 값 기억해 줘" | Dapr가 Redis · Cosmos DB 등에 저장 |
| 게시 · 구독 (Pub/Sub) | "다른 서비스에 알려 줘", "소식 오면 알려 줘" | Dapr가 Service Bus · Kafka 등으로 전달 · 구독 |
| 서비스 호출 (Service Invocation) | "주문 서비스한테 물어봐 줘" | Dapr가 대상 서비스를 찾아 호출 |
| 비밀 관리 (Secrets) | "비밀번호 줘" | Dapr가 Key Vault 등에서 조회 |
| 바인딩 (Bindings) | "SMS 보내 줘" | Dapr가 외부 시스템 API 호출 |
핵심은 Redis, Kafka, Key Vault의 SDK를 각각 배울 필요 없이 Dapr의 표준 API로 요청하면 된다는 점입니다.
4. Dapr를 쓰면 좋은 점
인프라 교체가 쉽다
"비용 때문에 Redis를 Cosmos DB로 바꾸자"는 결정이 났다고 해 보겠습니다.
- Dapr가 없으면: 앱 코드에서 Redis 관련 부분을 모두 찾아 고치고 다시 테스트해야 합니다.
- Dapr가 있으면: 앱 코드는 그대로 두고, Dapr 설정 파일(Component)만 바꾸면 됩니다. (자세한 내용은 5장)
언어에 상관없다
팀이 Python, Go, .NET, Java를 섞어 써도 모두 똑같이 localhost:3500에 HTTP(또는 gRPC) 요청만 하면 됩니다. 언어별로 Redis · Kafka SDK를 따로 익힐 필요가 없습니다.
귀찮은 일을 대신 처리한다
- 재시도 · 복원력: 일시적인 네트워크 오류에 대한 재시도 정책 적용
- 암호화: 서비스 간 통신에 mTLS 적용
- 추적: 요청이 어느 서비스를 거쳤는지 분산 추적 (OpenTelemetry 연동)
- 서비스 검색: "결제 서비스가 어디 있지?"를 Dapr가 찾아 줌
5. Dapr는 인프라를 대체하지 않는다
가장 많이 오해하는 부분입니다.
실제 리소스는 여전히 필요합니다
Dapr를 써도 Redis · Kafka · Event Hubs 같은 실제 백엔드 리소스는 직접 만들어야 합니다. Dapr는 리소스를 없애 주는 것이 아니라, 리소스에 접근하는 방식을 표준화할 뿐입니다.
| 구분 | Dapr가 해결하는 것 | Dapr가 해결하지 못하는 것 |
|---|---|---|
| 앱 코드 | Redis SDK · Kafka SDK, 연결 · 재시도 코드 제거 | - |
| 실제 리소스 | - | Redis 인스턴스, Event Hubs 네임스페이스 등 프로비저닝은 여전히 필요 |
Dapr를 TV 리모컨에 비유할 수 있습니다. 리모컨이 편하다고 TV(실제 리소스)가 없어지지는 않습니다. 대신 TV 브랜드를 바꿔도 리모컨 조작법(앱 코드)은 그대로입니다.
연결 고리: Component
앱과 실제 리소스를 이어 주는 것이 Component 정의입니다. 여기에 실제 리소스의 종류, 주소, 인증 정보가 들어갑니다.
apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
name: statestore # 앱이 부르는 논리적 이름
spec:
type: state.redis # 백엔드 종류
version: v1
metadata:
- name: redisHost
value: "myredis.redis.cache.windows.net:6380" # 실제 리소스 주소
- name: redisPassword
secretKeyRef: # 비밀번호는 Kubernetes Secret에서 읽음
name: redis-secret
key: redis-password
- name: enableTLS
value: "true"핵심은 앱이 리소스 주소가 아니라 논리적 이름(statestore)만 안다는 점입니다.
인프라 교체가 쉬운 진짜 이유
Redis를 Cosmos DB로 바꾸면 Component의 type을 state.azure.cosmosdb로 바꾸고, metadata를 Cosmos DB 접속 정보(엔드포인트, 데이터베이스, 컨테이너 등)로 바꿉니다.
앱은 여전히 statestore라는 이름으로 요청하므로 앱 코드는 한 줄도 바뀌지 않습니다. SDK로 직접 개발했다면 앱 코드를 크게 고쳐야 했을 부분입니다.
6. 요청이 실제 리소스까지 가는 흐름
앱이 상태를 저장할 때 실제로 일어나는 일입니다.
- 앱이
localhost:3500의 사이드카에 논리 이름(statestore)으로 HTTP 요청을 보냅니다. - 사이드카가 그 이름에 맞는 Component 정의를 찾습니다.
- Component에 적힌 실제 주소와 인증 정보를 확인합니다.
- 사이드카가 Redis 프로토콜로 변환해 실제 리소스를 호출합니다.
앱은 1번만 하면 되고, 2~4번의 실제 연결은 사이드카가 처리합니다. 리소스가 없거나 Component의 주소가 틀리면 이 단계에서 오류가 납니다.
앱 쪽 코드는 아래처럼 HTTP 요청 하나입니다.
curl -X POST http://localhost:3500/v1.0/state/statestore \
-H "Content-Type: application/json" \
-d '[{ "key": "order-1", "value": { "status": "paid" } }]'7. AKS에서 Dapr 동작 구조
AKS에서 Dapr는 Kubernetes의 Operator + CRD(사용자 정의 리소스) 패턴으로 동작합니다.
설치: 컨트롤 플레인 생성
AKS에 Dapr를 설치하는 방법은 두 가지입니다.
| 방법 | 설명 |
|---|---|
AKS Dapr 확장 (Microsoft.Dapr) | Azure CLI 또는 Bicep으로 설치 · 구성 · 업그레이드. Dapr 도구 다운로드와 런타임 수동 설치 부담이 없음 |
| 오픈소스 방식 | Dapr CLI(dapr init -k) 또는 Helm으로 직접 설치 · 관리 |
어느 방법이든 설치하면 다음이 만들어집니다.
- CRD 등록:
components.dapr.io,configurations.dapr.io,subscriptions.dapr.io,resiliencies.dapr.io등 - 컨트롤 플레인 파드
| 서비스 | 역할 |
|---|---|
dapr-operator | Component 변경과 Kubernetes 서비스 엔드포인트(상태 저장소, Pub/Sub 등) 관리 |
dapr-sidecar-injector | 어노테이션이 달린 파드에 사이드카 주입, Dapr 포트 환경 변수 추가 |
dapr-placement | 액터(Actor) 전용. 액터 인스턴스를 파드에 매핑하는 테이블 관리 |
dapr-sentry | 서비스 간 mTLS를 관리하는 인증 기관(CA) |
AKS Dapr 확장은 아래처럼 설치합니다.
# 변수 선언
RESOURCE_GROUP="myResourceGroup"
AKS_CLUSTER="myAKSCluster"
# AKS 클러스터에 Dapr 확장 설치 (부 버전 자동 업그레이드 끔)
az k8s-extension create \
--cluster-type managedClusters \
--cluster-name "$AKS_CLUSTER" \
--resource-group "$RESOURCE_GROUP" \
--name dapr \
--extension-type Microsoft.Dapr \
--auto-upgrade-minor-version falseAKS Dapr 확장 운영 팁
--auto-upgrade-minor-version을 지정하지 않으면 부 버전 자동 업그레이드가 켜집니다. Microsoft는 자동 업그레이드를 개발 · 테스트 환경에만 쓰고, 프로덕션은 수동 업그레이드를 권장합니다.- Dapr는 현재 버전과 이전 버전만 지원하는 롤링 방식이므로, 지원 버전을 유지하는 것은 운영자 책임입니다.
- 확장으로 설치했다면 이후 관리도 확장으로만 하세요. Dapr CLI와 섞어 쓰면 충돌이 날 수 있습니다.
Component 등록
5장의 statestore.yaml을 kubectl apply -f로 적용하면 dapr-operator가 이를 인식합니다. 이때 kind: Component가 바로 components.dapr.io CRD의 인스턴스입니다.
앱 파드에 사이드카 주입
어떤 파드에 Dapr를 붙일지는 Deployment의 어노테이션으로 지정합니다.
spec:
template:
metadata:
annotations:
dapr.io/enabled: "true"
dapr.io/app-id: "myapp"
dapr.io/app-port: "8080"이 어노테이션이 있으면 dapr-sidecar-injector가 파드 생성 요청을 가로채 daprd 컨테이너를 하나 더 넣습니다. 그 사이드카가 Component들을 불러와 localhost:3500으로 API를 제공합니다.
8. AKS와 Azure Container Apps 비교
Azure Container Apps(ACA)는 Dapr를 플랫폼이 직접 관리합니다. 설치 없이 앱 설정에서 Dapr를 켜기만 하면 사이드카가 붙습니다.
| 구분 | AKS | ACA |
|---|---|---|
| Dapr 런타임 | Dapr 확장 또는 Helm으로 직접 설치 | 플랫폼이 관리 (설치 불필요) |
| Component 정의 | Component CRD를 kubectl apply | 환경 수준 리소스로 등록 (az containerapp env dapr-component set) |
| 사이드카 활성화 | 파드 어노테이션 | 컨테이너 앱 설정에서 Dapr 사용 설정 |
| 버전 업그레이드 | 운영자 책임 (확장은 부 버전 자동 업그레이드 선택 가능) | 플랫폼 책임 |
개념 구조(Component가 실제 리소스를 가리키고, 앱 옆에 사이드카가 붙는다)는 같습니다. AKS는 이를 CRD와 어노테이션으로 직접 다루고, ACA는 CRD를 숨기고 az 명령과 설정으로 추상화한 차이입니다.
ACA에서 Component를 등록하는 예입니다. ACA의 Component YAML은 Kubernetes CRD와 형식이 조금 다르므로, ACA 문서의 스키마를 따라 작성합니다.
# 변수 선언
RESOURCE_GROUP="myResourceGroup"
ACA_ENVIRONMENT="myContainerAppsEnv"
# 컨테이너 앱 환경에 Dapr 구성 요소 등록
az containerapp env dapr-component set \
--name "$ACA_ENVIRONMENT" \
--resource-group "$RESOURCE_GROUP" \
--dapr-component-name statestore \
--yaml "./statestore.yaml"ACA에서 알아 둘 점
- 같은 환경의 Dapr 사용 앱은 기본적으로 모든 Component를 불러옵니다. 특정 앱만 쓰게 하려면 Component에
scopes(Dapr 앱 ID 목록)를 지정하세요. - Container Apps 작업(Jobs)에서는 Dapr를 지원하지 않습니다.
9. 언제 Dapr를 고려할까
| 상황 | 판단 |
|---|---|
| 마이크로서비스 여러 개가 서로 통신해야 함 | 고려할 만함 |
| 팀이 여러 언어(Python + Go + .NET 등)를 씀 | 고려할 만함 |
| 나중에 인프라(Redis → Cosmos DB 등)를 바꿀 가능성이 있음 | 고려할 만함 |
| 재시도 · 암호화 · 추적을 앱 코드에서 빼고 싶음 | 고려할 만함 |
| 단순한 웹앱 하나 | 과한 선택 |
| 서비스 메시(Istio 등)가 이미 서비스 간 통신을 맡고 있고, 상태 저장 · 메시징 추상화는 필요 없음 | 굳이 필요 없음 |
| 한 언어만 쓰고 프레임워크(예: Spring Cloud)가 이미 해결해 줌 | 굳이 필요 없음 |
✨ 결론
한 장으로 정리하면 다음과 같습니다.
- Dapr는 앱 옆에 붙는 도우미 컨테이너(사이드카)로, 복잡한 인프라 호출을 표준 API로 바꿔 줍니다.
- 앱은
localhost:3500에 "저장해", "보내", "읽어 와"라고 요청만 하면 됩니다. - 인프라를 바꿔도 앱 코드는 그대로이고, Component 정의만 바뀝니다.
- 단, 실제 리소스(Redis · Kafka · Event Hubs 등)는 여전히 필요합니다. Dapr는 대체가 아니라 추상화입니다.
- AKS는 Dapr 확장(또는 Helm)으로 CRD · Operator · 어노테이션 기반 사이드카 주입을 직접 다루고, ACA는 이를 숨긴 완전 관리형으로 바로 쓸 수 있습니다.
이 포스트는 2026년 11월 기준 최신 Azure 공식 문서를 바탕으로 작성되었습니다. 최신 정보는 Microsoft Learn - Azure Container Apps의 Dapr, Microsoft Learn - Container Apps의 Dapr 구성 요소, Microsoft Learn - AKS용 Dapr 확장, Microsoft Learn - AKS에 Dapr 확장 설치, Dapr 공식 문서에서 확인하실 수 있습니다.