Azure Container Apps에서 수정 버전 관리
Azure Container Apps를 사용하면 컨테이너 앱에서 여러 수정 버전을 지원할 수 있습니다. 이 기능을 사용하면 수정 버전을 활성화 및 비활성화하고 각 수정 버전으로 전송되는 트래픽의 양을 제어할 수 있습니다. 수정 버전에 관한 자세한 내용은 Azure Container Apps의 수정 버전을 참조하세요.
애플리케이션을 처음 배포할 때 수정 버전이 만들어집니다. 수정 버전 범위 변경 내용으로 애플리케이션을 업데이트하면 새 수정 버전이 만들어집니다. 특정 수정 버전에 따라 컨테이너 앱을 업데이트할 수도 있습니다.
이 문서에서는 컨테이너 앱의 수정 버전을 관리하는 명령을 설명합니다. Container Apps 명령에 대한 자세한 내용은 az containerapp을 참조하세요. 수정 버전을 관리하는 명령에 대한 자세한 내용은 az containerapp revision을 참조하세요.
컨테이너 앱 업데이트
컨테이너 앱을 업데이트하려면 az containerapp update 명령을 사용합니다. 이 명령을 사용하면 환경 변수를 수정하고, 리소스를 계산하고, 매개 변수를 크기 조정하고, 다른 이미지를 배포할 수 있습니다. 컨테이너 앱 업데이트에 수정 버전 범위 변경 내용이 포함된 경우 새 수정 버전이 생성됩니다.
이 예제에서는 컨테이너 이미지를 업데이트합니다. <자리 표시자>를 해당 값으로 바꿉니다.
az containerapp update \
--name <APPLICATION_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--image <IMAGE_NAME>
수정 버전 복사 명령을 사용하여 컨테이너 앱을 업데이트할 수도 있습니다.
수정 버전 목록
az containerapp revision list을 사용하여 컨테이너 앱과 연결된 모든 수정 버전을 나열합니다. 이 명령에 대한 자세한 내용은 az containerapp revision list를 참조하세요.
<자리 표시자>를 해당 값으로 바꿉니다.
az containerapp revision list \
--name <APPLICATION_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
-o table
수정 버전 표시
az containerapp revision show 명령을 사용하여 특정 수정 버전에 대한 세부 정보를 표시하세요.
<자리 표시자>를 해당 값으로 바꿉니다.
az containerapp revision show \
--name <APPLICATION_NAME> \
--revision <REVISION_NAME> \
--resource-group <RESOURCE_GROUP_NAME>
수정 버전 복사
기존 수정 버전을 기반으로 새 수정 버전을 만들려면 az containerapp revision copy를 사용합니다. Container Apps는 기존 수정 버전의 구성을 사용하며 이후 수정할 수 있습니다.
이 명령을 사용하면 환경 변수를 수정하고, 리소스를 계산하고, 매개 변수를 크기 조정하고, 다른 이미지를 배포할 수 있습니다. YAML 파일을 사용하여 이러한 구성 옵션과 매개 변수를 정의할 수도 있습니다. 이 명령에 대한 자세한 내용은 az containerapp revision copy를 참조하세요.
이 예제에서는 최신 수정 버전을 복사하고 컴퓨팅 리소스 매개 변수를 설정합니다. (<자리 표시자>를 해당 값으로 바꿉니다.)
az containerapp revision copy \
--name <APPLICATION_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--cpu 0.75 \
--memory 1.5Gi
수정 버전 활성화
az containerapp revision activate 명령을 사용하여 수정 버전을 활성화하세요.
예: (<자리 표시자>를 해당 값으로 바꿉니다.)
az containerapp revision activate \
--revision <REVISION_NAME> \
--resource-group <RESOURCE_GROUP_NAME>
수정 버전 비활성화
az containerapp revision deactivate 명령을 사용하여 더 이상 사용되지 않는 수정 버전을 비활성화하세요. 비활성화는 수정 버전의 실행 중인 모든 복제본을 중지합니다.
예: (<자리 표시자>를 해당 값으로 바꿉니다.)
az containerapp revision deactivate \
--revision <REVISION_NAME> \
--resource-group <RESOURCE_GROUP_NAME>
수정 버전 다시 시작
az containerapp revision restart 명령은 수정 버전을 다시 시작합니다.
컨테이너 앱에서 비밀을 수정하는 경우 비밀에 액세스할 수 있도록 활성 수정 버전을 다시 시작해야 합니다.
예: (<자리 표시자>를 해당 값으로 바꿉니다.)
az containerapp revision restart \
--revision <REVISION_NAME> \
--resource-group <RESOURCE_GROUP_NAME>
수정 버전 설정 모드
수정 모드는 컨테이너 앱의 단일 수정 버전만 활성화될 수 있는지 여러 버전이 동시에 활성화될 수 있는지를 제어합니다. 단일 수정 모드 또는 여러 수정 모드를 지원하도록 컨테이너 앱을 설정하려면 az containerapp revision set-mode 명령을 사용합니다.
기본 설정은 단일 수정 모드입니다. 이 명령에 대한 자세한 내용은 az containerapp revision set-mode를 참조하세요.
모드 값은 single 또는 multiple입니다. 수정 버전 모드를 변경해도 새 수정 버전이 만들어지지는 않습니다.
예: (<자리 표시자>를 해당 값으로 바꿉니다.)
예: (<자리 표시자>를 해당 값으로 바꿉니다.)
az containerapp revision set-mode \
--name <APPLICATION_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--mode <REVISION_MODE>
수정 버전 레이블
레이블은 트래픽을 수정 버전으로 전송하는 데 사용할 수 있는 고유한 URL을 제공합니다. 수정 버전 간에 레이블을 이동하여 레이블의 URL로 전달되는 트래픽을 다른 수정 버전으로 다시 라우팅할 수 있습니다. 수정 버전 레이블에 대한 자세한 내용은 수정 레이블을 참조하세요.
수정 버전에서 레이블을 추가하고 제거할 수 있습니다. label 명령에 대한 자세한 내용은 az containerapp revision label을 참조하세요.
수정 버전 레이블 추가
수정 버전에 레이블을 추가하려면 az containerapp revision label add 명령을 사용합니다.
한 번에 하나의 수정 버전에만 레이블을 할당할 수 있으며 수정 버전에는 하나의 레이블만 할당할 수 있습니다. 지정한 수정 버전에 레이블이 있는 경우 add 명령은 기존 레이블을 대체합니다.
이 예제에서는 수정 버전에 레이블을 추가합니다.(<자리 표시자>를 해당 값으로 바꿉니다.)
az containerapp revision label add \
--revision <REVISION_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--label <LABEL_NAME>
수정 버전 레이블 제거
수정 버전에서 레이블을 제거하려면 az containerapp revision label remove 명령을 사용합니다.
이 예제에서는 수정 버전에 대한 레이블을 제거합니다.(<자리 표시자>를 해당 값으로 바꿉니다.)
az containerapp revision label remove \
--revision <REVISION_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--label <LABEL_NAME>
트래픽 분할
백분율 값을 할당하여 적용하면 여러 수정 버전 간에 트래픽의 균형을 맞추는 방법을 결정할 수 있습니다. 트래픽 분할 규칙은 이름 또는 레이블로 여러 수정 버전에 가중치를 설정하여 할당됩니다. 자세한 내용은 트래픽 분할을 참조하세요.