기존 컨테이너 앱에서 Dapr 사용

런타임 컨텍스트에 따라 다양한 인수 및 주석을 사용하여 Dapr을 구성할 수 있습니다. Azure Container Apps는 Dapr을 사용하도록 설정할 수 있는 세 가지 채널을 제공합니다.

다음 표에서는 Azure Container Apps에서 Dapr을 사용하도록 설정하기 위해 현재 지원되는 Dapr 사이드카 구성 목록을 간략하게 설명합니다.

Container Apps CLI	템플릿 필드	설명
`--enable-dapr`	`dapr.enabled`	컨테이너 앱에서 Dapr을 사용하도록 설정합니다.
`--dapr-app-port`	`dapr.appPort`	애플리케이션이 수신하는 포트는 Dapr이 애플리케이션과 통신하는 데 사용할 것입니다.
`--dapr-app-protocol`	`dapr.appProtocol`	애플리케이션에서 사용 중인 프로토콜을 Dapr에 알려줍니다. 유효한 옵션은 `http` 또는 `grpc`입니다. 기본값은 `http`입니다.
`--dapr-app-id`	`dapr.appId`	서비스 검색, 상태 캡슐화 및 pub/sub 소비자 ID에 사용되는 컨테이너 앱에 대한 고유한 Dapr 식별자입니다.
`--dapr-max-request-size`	`dapr.httpMaxRequestSize`	대용량 파일 업로드를 처리하기 위해 요청 본문 http 및 grpc 서버의 최대 크기를 설정합니다. 기본값은 4MB입니다.
`--dapr-read-buffer-size`	`dapr.httpReadBufferSize`	다중 KB 헤더를 보낼 때 처리할 http 헤더 읽기 버퍼의 최대 크기를 설정합니다. 기본값은 4KB입니다.
`--dapr-api-logging`	`dapr.enableApiLogging`	애플리케이션에서 Dapr 사이드카로의 API 호출을 볼 수 있습니다.
`--dapr-log-level`	`dapr.logLevel`	Dapr 사이드카의 로그 수준을 설정합니다. 허용되는 값: 디버그, 오류, 정보, 경고 기본값은 `info`입니다.

CLI 사용

Azure CLI를 사용하여 컨테이너 앱에서 Dapr을 사용하도록 설정할 수 있습니다.

az containerapp dapr enable

IaC 템플릿을 사용하는 경우 컨테이너 앱 리소스 정의의 properties.configuration 섹션에서 다음 인수를 지정합니다.

 dapr: {
   enabled: true
   appId: 'nodeapp'
   appProtocol: 'http'
   appPort: 3000
 }

  "dapr": {
    "enabled": true,
    "appId": "nodeapp",
    "appProtocol": "http",
    "appPort": 3000
  }

위의 Dapr 구성 값은 애플리케이션 범위 변경으로 간주됩니다. 여러 수정 모드에서 컨테이너 앱을 실행하는 경우 이러한 설정을 변경해도 새 수정 버전이 만들어지지 않습니다. 대신, 모든 기존 수정 버전이 최신 값으로 구성되도록 다시 시작됩니다.

컨테이너 앱의 포털 보기를 통해 Dapr을 사용하도록 설정할 수도 있습니다.

참고 항목

시작하기 전에 사용자 고유의 Dapr 구성 요소를 이미 만들었는지 확인합니다. 포털에서 컨테이너 앱 환경을 통해 Dapr 구성 요소를 연결할 수 있습니다.

Azure Portal에서 컨테이너 앱으로 이동하고 왼쪽 메뉴의 설정 아래에서 Dapr을 선택합니다.

기본적으로 Dapr은 사용되지 않습니다. 사용을 선택하여 Dapr 설정을 확장합니다.

기본적으로 사용하지 않도록 설정되는 Dapr의 스크린샷과 사용하도록 설정할 위치를 클릭합니다.

구성 요소 앱 ID를 입력하고 적절한 제목을 선택합니다. 해당하는 경우 구성 요소 헤더 아래에서 컨테이너 앱 환경에 Dapr 구성 요소를 추가하고 관리하는 링크를 선택합니다.

컨테이너 앱에서 Dapr을 사용하도록 설정하기 위한 몇 가지 기본 설정을 보여 주는 스크린샷