Dapr 쉽게 이해하기: 사이드카 개념부터 AKS · Container Apps 동작 구조까지

앱이 Redis, Kafka, Key Vault 같은 외부 시스템을 직접 다루지 않게 해 주는 Dapr를 비유로 이해하고, Component와 사이드카가 실제 리소스에 연결되는 흐름, AKS와 Azure Container Apps에서의 동작 차이를 정리합니다.

2026. 11. 17.
6개 태그

🔍 개요

Dapr(Distributed Application Runtime)는 마이크로서비스 개발을 돕는 오픈소스 런타임입니다.
한 줄로 말하면 내 앱이 Redis, Kafka, Key Vault 같은 외부 시스템을 직접 다루지 않아도 되게 "대신 해 주는" 도우미입니다.

비유: 호텔 컨시어지

호텔에 묵고 있다고 생각해 보겠습니다.

  • 컨시어지가 없으면(Dapr 없이): 택시를 부르려면 택시 회사에, 공항 셔틀은 셔틀 회사에, 공연 티켓은 티켓 사이트에 각각 직접 연락해야 합니다. 모든 업체의 방식을 내가 알아야 합니다.
  • 컨시어지가 있으면(Dapr 사용): "택시 불러 주세요" 한마디면 컨시어지가 알아서 연락하고 결제합니다. 내일 택시 회사가 바뀌어도 나는 똑같이 "택시 불러 주세요"라고 말하면 됩니다.

Dapr가 바로 이 컨시어지 역할을 합니다.

1. Dapr가 없을 때와 있을 때

Dapr가 없을 때

Dapr 없이
[내 앱]
  ├── Redis SDK 설치
  ├── Kafka SDK 설치
  ├── Azure Service Bus SDK 설치
  ├── Key Vault SDK 설치
  └── 각각 연결 코드, 인증 코드, 재시도 코드 직접 작성

앱 코드가 인프라 지식으로 가득 찹니다. Redis 주소가 바뀌면 코드를 고쳐야 하고, Kafka를 Service Bus로 바꾸면 관련 코드를 다시 작성해야 합니다.

Dapr가 있을 때

Dapr 사용
[내 앱]
  └── "저장해 줘", "메시지 보내 줘", "시크릿 줘" 요청만
 
[Dapr 사이드카]  ← 내 앱 옆에 붙어서 실행
  ├── Redis에 저장 처리
  ├── Kafka에 메시지 전송
  └── Key Vault에서 시크릿 읽기

앱은 "무엇을 해 달라"만 말하고, Dapr가 "어떻게 할지"를 맡습니다.

2. 사이드카(Sidecar)란

사이드카는 오토바이 옆에 붙은 보조석을 떠올리면 됩니다. 내 앱 컨테이너 옆에 Dapr 컨테이너(daprd)가 하나 더 붙어서 실행됩니다.

Mermaid diagram
  • 두 컨테이너는 같은 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 정의입니다. 여기에 실제 리소스의 종류, 주소, 인증 정보가 들어갑니다.

statestore.yaml
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. 요청이 실제 리소스까지 가는 흐름

앱이 상태를 저장할 때 실제로 일어나는 일입니다.

Mermaid diagram
  1. 앱이 localhost:3500의 사이드카에 논리 이름(statestore)으로 HTTP 요청을 보냅니다.
  2. 사이드카가 그 이름에 맞는 Component 정의를 찾습니다.
  3. Component에 적힌 실제 주소와 인증 정보를 확인합니다.
  4. 사이드카가 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-operatorComponent 변경과 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 false
AKS 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의 어노테이션으로 지정합니다.

deployment.yaml (일부)
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를 제공합니다.

Mermaid diagram

8. AKS와 Azure Container Apps 비교

Azure Container Apps(ACA)는 Dapr를 플랫폼이 직접 관리합니다. 설치 없이 앱 설정에서 Dapr를 켜기만 하면 사이드카가 붙습니다.

구분AKSACA
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)가 이미 해결해 줌굳이 필요 없음

✨ 결론

한 장으로 정리하면 다음과 같습니다.

Mermaid diagram
  • 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 공식 문서에서 확인하실 수 있습니다.