자습서: Azure Container Apps를 사용하여 이벤트 기반 작업 배포

아티클
02/23/2024

Azure Container Apps 작업을 사용하면 한정된 기간 동안 실행되고 종료되는 컨테이너화된 작업을 실행할 수 있습니다. 수동으로, 일정에 따라 또는 이벤트를 기반으로 작업 실행을 트리거할 수 있습니다. 작업은 데이터 처리, 기계 학습, 리소스 정리 또는 서버리스 임시 컴퓨팅 리소스가 필요한 모든 시나리오와 같은 작업에 가장 적합합니다.

이 자습서에서는 이벤트 기반 작업을 수행하는 방법을 알아봅니다.

컨테이너 앱을 배포하기 위한 Container Apps 환경 만들기
컨테이너 앱에 메시지를 보내는 Azure Storage 큐 만들기
작업을 실행하는 컨테이너 이미지 빌드
Container Apps 환경에 작업 배포
큐 메시지가 컨테이너 앱에서 처리되는지 확인

만든 작업은 Azure Storage 큐로 전송되는 각 메시지에 대한 실행을 시작합니다. 각 작업 실행은 다음 단계를 수행하는 컨테이너를 실행합니다.

큐에서 하나의 메시지를 가져옵니다.
작업 실행 로그에 메시지를 기록합니다.
큐에서 메시지를 삭제합니다.
종료합니다.

Important

스케일러는 큐의 길이를 모니터링하여 시작할 작업 수를 결정합니다. 정확한 스케일링을 위해 작업 실행이 완료될 때까지 큐에서 메시지를 삭제하지 마세요.

이 자습서에서 실행하는 작업의 소스 코드는 Azure 샘플 GitHub 리포지토리에서 사용할 수 있습니다.

필수 조건

활성 구독이 있는 Azure 계정.
- GitHub 계정이 없는 경우 무료로 만들 수 있습니다.
Azure CLI를 설치합니다.
제한 사항 목록은 작업 제한 사항을 참조하세요.

설정

CLI에서 Azure에 로그인하려면 다음 명령을 실행하고 프롬프트에 따라 인증 프로세스를 완료합니다.
```
az login
```
업그레이드 명령을 통해 최신 버전의 CLI를 실행하고 있는지 확인합니다.
```
az upgrade
```
최신 버전의 Azure Container Apps CLI 확장을 설치합니다.
```
az extension add --name containerapp --upgrade
```
Azure 구독에 아직 등록하지 않은 경우 Microsoft.App 및 Microsoft.OperationalInsights 네임스페이스를 등록합니다.
```
az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights
```
이제 Azure CLI 설정이 완료되었으므로 이 문서 전체에서 사용되는 환경 변수를 정의할 수 있습니다.
```
RESOURCE_GROUP="jobs-quickstart"
LOCATION="northcentralus"
ENVIRONMENT="env-jobs-quickstart"
JOB_NAME="my-job"
```

컨테이너 앱 환경 만들기

Azure Container Apps 환경은 Container Apps와 작업 주위의 보안 경계 역할을 하므로 동일한 네트워크를 공유하고 서로 통신할 수 있습니다.

다음 명령을 사용하여 리소스 그룹을 만듭니다.

az group create \
    --name "$RESOURCE_GROUP" \
    --location "$LOCATION"

다음 명령을 사용하여 Container Apps 환경을 만듭니다.

az containerapp env create \
    --name "$ENVIRONMENT" \
    --resource-group "$RESOURCE_GROUP" \
    --location "$LOCATION"

스토리지 큐 설정

작업은 Azure Storage 큐를 사용하여 메시지를 수신합니다. 이 섹션에서는 스토리지 계정과 큐를 만듭니다.

스토리지 계정의 이름을 정의합니다.
```
STORAGE_ACCOUNT_NAME="<STORAGE_ACCOUNT_NAME>"
QUEUE_NAME="myqueue"
```
<STORAGE_ACCOUNT_NAME>을 스토리지 계정의 고유한 이름으로 바꿉니다. Storage 계정 이름은 Azure 내에서 고유하고, 길이가 3자에서 24자 사이여야 하며, 숫자 및 소문자만 포함해야 합니다.

Azure Storage 계정을 만듭니다.

az storage account create \
    --name "$STORAGE_ACCOUNT_NAME" \
    --resource-group "$RESOURCE_GROUP" \
    --location "$LOCATION" \
    --sku Standard_LRS \
    --kind StorageV2

큐의 연결 문자열을 변수에 저장합니다.

QUEUE_CONNECTION_STRING=`az storage account show-connection-string -g $RESOURCE_GROUP --name $STORAGE_ACCOUNT_NAME --query connectionString --output tsv`

메시지 큐를 만듭니다.

az storage queue create \
    --name "$QUEUE_NAME" \
    --account-name "$STORAGE_ACCOUNT_NAME" \
    --connection-string "$QUEUE_CONNECTION_STRING"

작업 빌드 및 배포

작업을 배포하려면 먼저 작업에 대한 컨테이너 이미지를 빌드하고 이를 레지스트리에 푸시해야 합니다. 그런 다음 작업을 Container Apps 환경에 배포할 수 있습니다.

컨테이너 이미지 및 레지스트리의 이름을 정의합니다.
```
CONTAINER_IMAGE_NAME="queue-reader-job:1.0"
CONTAINER_REGISTRY_NAME="<CONTAINER_REGISTRY_NAME>"
```
<CONTAINER_REGISTRY_NAME>을 컨테이너 레지스트리의 고유 이름으로 바꿉니다. 컨테이너 레지스트리 이름은 Azure 내에서 고유해야 하며 숫자와 소문자만 포함하여 5~50자여야 합니다.

컨테이너 레지스트리를 만듭니다.

az acr create \
    --name "$CONTAINER_REGISTRY_NAME" \
    --resource-group "$RESOURCE_GROUP" \
    --location "$LOCATION" \
    --sku Basic \
    --admin-enabled true

작업의 소스 코드는 GitHub에서 확인할 수 있습니다. 다음 명령을 실행하여 리포지토리를 복제하고 az acr build 명령을 사용하여 클라우드에 컨테이너 이미지를 빌드합니다.
```
az acr build \
    --registry "$CONTAINER_REGISTRY_NAME" \
    --image "$CONTAINER_IMAGE_NAME" \
    "https://github.com/Azure-Samples/container-apps-event-driven-jobs-tutorial.git"
```
이제 컨테이너 레지스트리에서 이미지를 사용할 수 있습니다.

Container Apps 환경에서 작업을 만듭니다.

az containerapp job create \
    --name "$JOB_NAME" \
    --resource-group "$RESOURCE_GROUP" \
    --environment "$ENVIRONMENT" \
    --trigger-type "Event" \
    --replica-timeout "1800" \
    --min-executions "0" \
    --max-executions "10" \
    --polling-interval "60" \
    --scale-rule-name "queue" \
    --scale-rule-type "azure-queue" \
    --scale-rule-metadata "accountName=$STORAGE_ACCOUNT_NAME" "queueName=$QUEUE_NAME" "queueLength=1" \
    --scale-rule-auth "connection=connection-string-secret" \
    --image "$CONTAINER_REGISTRY_NAME.azurecr.io/$CONTAINER_IMAGE_NAME" \
    --cpu "0.5" \
    --memory "1Gi" \
    --secrets "connection-string-secret=$QUEUE_CONNECTION_STRING" \
    --registry-server "$CONTAINER_REGISTRY_NAME.azurecr.io" \
    --env-vars "AZURE_STORAGE_QUEUE_NAME=$QUEUE_NAME" "AZURE_STORAGE_CONNECTION_STRING=secretref:connection-string-secret"

다음 표에서는 명령에 사용되는 주요 매개 변수를 설명합니다.

매개 변수	설명
`--replica-timeout`	복제본을 실행할 수 있는 최대 기간입니다.
`--min-executions`	폴링 간격당 실행할 최소 작업 실행 수입니다.
`--max-executions`	폴링 간격당 실행할 최대 작업 실행 수입니다.
`--polling-interval`	크기 조정 규칙을 평가할 폴링 간격입니다.
`--scale-rule-name`	크기 조정 규칙의 이름입니다.
`--scale-rule-type`	사용할 배율 규칙의 형식입니다.
`--scale-rule-metadata`	크기 조정 규칙의 메타데이터입니다.
`--scale-rule-auth`	크기 조정 규칙에 대한 인증입니다.
`--secrets`	작업에 사용할 비밀입니다.
`--registry-server`	작업에 사용할 컨테이너 레지스트리 서버입니다. Azure Container Registry의 경우 명령은 자동으로 인증을 구성합니다.
`--env-vars`	작업에 사용할 환경 변수입니다.

크기 조정 규칙 구성은 모니터링할 이벤트 원본을 정의합니다. 각 폴링 간격마다 평가되어 트리거할 작업 실행 수를 결정합니다. 자세한 내용은 크기 조정 규칙 설정을 참조하세요.

이제 이벤트 기반 작업이 Container Apps 환경에서 만들어집니다.

배포 확인

작업은 60초마다 크기 조정 규칙을 평가하여 큐의 메시지 수를 확인하도록 구성됩니다. 각 평가 기간 동안 큐의 각 메시지에 대해 최대 10회 실행까지 새 작업 실행을 시작합니다.

작업이 올바르게 구성되었는지 확인하려면 일부 메시지를 큐에 보내고 작업 실행이 시작되었는지 확인하면 해당 메시지가 작업 실행 로그에 기록됩니다.

큐에 메시지를 보냅니다.

az storage message put \
    --content "Hello Queue Reader Job" \
    --queue-name "$QUEUE_NAME" \
    --connection-string "$QUEUE_CONNECTION_STRING"

작업 실행을 나열합니다.
```
az containerapp job execution list \
    --name "$JOB_NAME" \
    --resource-group "$RESOURCE_GROUP" \
    --output json
```
작업은 60초마다 크기 조정 규칙을 평가하도록 구성되어 있으므로 작업 실행이 시작되는 데 최대 1분이 걸릴 수 있습니다. 작업 실행이 표시되고 해당 상태가 Succeeded가 될 때까지 명령을 반복합니다.
기록된 메시지를 보려면 다음 명령을 실행합니다. 이러한 명령에는 로그 분석 확장이 필요하므로 요청 시 확장을 설치하라는 메시지를 수락합니다.
```
LOG_ANALYTICS_WORKSPACE_ID=`az containerapp env show --name $ENVIRONMENT --resource-group $RESOURCE_GROUP --query properties.appLogsConfiguration.logAnalyticsConfiguration.customerId --out tsv`

az monitor log-analytics query \
    --workspace "$LOG_ANALYTICS_WORKSPACE_ID" \
    --analytics-query "ContainerAppConsoleLogs_CL | where ContainerJobName_s == '$JOB_NAME' | order by _timestamp_d asc"
```
ContainerAppConsoleLogs_CL 테이블이 준비될 때까지 명령은 오류 BadArgumentError: The request had some invalid properties를 반환합니다. 잠시 기다린 다음 다시 시도하십시오.

팁

문제가 있나요? Azure Container Apps 리포지토리에서 문제를 열어 GitHub에 알려주세요.

리소스 정리

완료되면 다음 명령을 실행하여 Container Apps 리소스가 포함된 리소스 그룹을 삭제합니다.

주의

다음 명령은 지정된 리소스 그룹과 그 안에 포함된 모든 리소스를 삭제합니다. 지정된 리소스 그룹에 이 자습서의 범위에 속하지 않는 리소스가 포함된 경우 해당 리소스도 삭제됩니다.

az group delete \
    --resource-group $RESOURCE_GROUP

다음 단계

Container Apps 작업

다음을 통해 공유