다음을 통해 공유


Container Apps - Update

컨테이너 앱의 속성 업데이트
JSON 병합 패치를 사용하여 컨테이너 앱 패치

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/containerApps/{containerAppName}?api-version=2024-03-01

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
containerAppName
path True

string

컨테이너 앱의 이름입니다.

resourceGroupName
path True

string

리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다.

subscriptionId
path True

string

대상 구독의 ID입니다.

api-version
query True

string

이 작업에 사용할 API 버전입니다.

요청 본문

Name 필수 형식 Description
location True

string

리소스가 있는 지리적 위치

extendedLocation

ExtendedLocation

확장된 위치의 복합 형식입니다.

identity

ManagedServiceIdentity

코드에서 비밀 또는 자격 증명을 유지 관리하지 않고 다른 Azure 서비스와 상호 작용하는 컨테이너 앱의 관리 ID입니다.

managedBy

string

이 리소스를 관리하는 리소스의 정규화된 리소스 ID입니다. 이 리소스가 다른 Azure 리소스에서 관리되는지를 나타냅니다. 이 경우 전체 모드 배포는 다른 리소스에서 관리되므로 템플릿에서 제거된 경우 리소스를 삭제하지 않습니다.

properties.configuration

Configuration

버전이 지정되지 않은 Container App 구성 속성입니다.

properties.environmentId

string

환경의 리소스 ID입니다.

properties.managedEnvironmentId

string

더 이상 사용되지 않습니다. 컨테이너 앱 환경의 리소스 ID입니다.

properties.template

Template

컨테이너 앱 버전이 지정된 애플리케이션 정의입니다.

properties.workloadProfileName

string

컨테이너 앱 실행을 위해 고정할 워크로드 프로필 이름입니다.

tags

object

리소스 태그.

응답

Name 형식 Description
200 OK

ContainerApp

확인

202 Accepted

패치 작업이 진행 중입니다.

헤더

Location: string

Other Status Codes

DefaultErrorResponse

일반적인 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

Patch Container App

샘플 요청

PATCH https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/testcontainerapp0?api-version=2024-03-01

{
  "location": "East US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "configuration": {
      "ingress": {
        "external": true,
        "targetPort": 3000,
        "customDomains": [
          {
            "name": "www.my-name.com",
            "bindingType": "SniEnabled",
            "certificateId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-name-dot-com"
          },
          {
            "name": "www.my-other-name.com",
            "bindingType": "SniEnabled",
            "certificateId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-other-name-dot-com"
          }
        ],
        "traffic": [
          {
            "weight": 100,
            "revisionName": "testcontainerapp0-ab1234",
            "label": "production"
          }
        ],
        "ipSecurityRestrictions": [
          {
            "name": "Allow work IP A subnet",
            "description": "Allowing all IP's within the subnet below to access containerapp",
            "ipAddressRange": "192.168.1.1/32",
            "action": "Allow"
          },
          {
            "name": "Allow work IP B subnet",
            "description": "Allowing all IP's within the subnet below to access containerapp",
            "ipAddressRange": "192.168.1.1/8",
            "action": "Allow"
          }
        ],
        "stickySessions": {
          "affinity": "sticky"
        }
      },
      "dapr": {
        "enabled": true,
        "appPort": 3000,
        "appProtocol": "http",
        "httpReadBufferSize": 30,
        "httpMaxRequestSize": 10,
        "logLevel": "debug",
        "enableApiLogging": true
      },
      "maxInactiveRevisions": 10,
      "service": {
        "type": "redis"
      }
    },
    "template": {
      "containers": [
        {
          "image": "repo/testcontainerapp0:v1",
          "name": "testcontainerapp0",
          "probes": [
            {
              "type": "Liveness",
              "httpGet": {
                "path": "/health",
                "port": 8080,
                "httpHeaders": [
                  {
                    "name": "Custom-Header",
                    "value": "Awesome"
                  }
                ]
              },
              "initialDelaySeconds": 3,
              "periodSeconds": 3
            }
          ]
        }
      ],
      "initContainers": [
        {
          "image": "repo/testcontainerapp0:v4",
          "name": "testinitcontainerApp0",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          }
        }
      ],
      "scale": {
        "minReplicas": 1,
        "maxReplicas": 5,
        "rules": [
          {
            "name": "httpscalingrule",
            "custom": {
              "type": "http",
              "metadata": {
                "concurrentRequests": "50"
              }
            }
          }
        ]
      },
      "serviceBinds": [
        {
          "serviceId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/service",
          "name": "service"
        }
      ]
    }
  }
}

샘플 응답

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/testcontainerapp0",
  "name": "testcontainerapp0",
  "type": "Microsoft.App/containerApps",
  "location": "East US",
  "properties": {
    "provisioningState": "Succeeded",
    "managedEnvironmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
    "workloadProfileName": "My-GP-01",
    "latestRevisionFqdn": "testcontainerapp0-pjxhsye.demokube-t24clv0g.eastus.containerApps.k4apps.io",
    "latestReadyRevisionName": "testcontainerapp0-pjxhsye",
    "configuration": {
      "ingress": {
        "fqdn": "testcontainerapp0.demokube-t24clv0g.eastus.containerApps.k4apps.io",
        "external": true,
        "targetPort": 3000,
        "transport": "auto",
        "customDomains": [
          {
            "name": "www.my-name.com",
            "bindingType": "SniEnabled",
            "certificateId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-name-dot-com"
          },
          {
            "name": "www.my--other-name.com",
            "bindingType": "SniEnabled",
            "certificateId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-other-name-dot-com"
          }
        ],
        "traffic": [
          {
            "weight": 80,
            "revisionName": "testcontainerapp0-ab1234"
          },
          {
            "weight": 20,
            "revisionName": "testcontainerapp0-ab4321",
            "label": "staging"
          }
        ],
        "ipSecurityRestrictions": [
          {
            "name": "Allow work IP A subnet",
            "description": "Allowing all IP's within the subnet below to access containerapp",
            "ipAddressRange": "192.168.1.1/32",
            "action": "Allow"
          },
          {
            "name": "Allow work IP B subnet",
            "description": "Allowing all IP's within the subnet below to access containerapp",
            "ipAddressRange": "192.168.1.1/8",
            "action": "Allow"
          }
        ]
      },
      "dapr": {
        "enabled": true,
        "appPort": 3000,
        "appProtocol": "http",
        "httpReadBufferSize": 30,
        "httpMaxRequestSize": 10,
        "logLevel": "debug",
        "enableApiLogging": true
      },
      "maxInactiveRevisions": 10
    },
    "template": {
      "containers": [
        {
          "image": "repo/testcontainerapp0:v4",
          "name": "testcontainerapp0",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          }
        }
      ],
      "initContainers": [
        {
          "image": "repo/testcontainerapp0:v4",
          "name": "testinitcontainerApp0",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          }
        }
      ],
      "scale": {
        "minReplicas": 1,
        "maxReplicas": 5,
        "rules": [
          {
            "name": "httpscalingrule",
            "http": {
              "metadata": {
                "concurrentRequests": "50"
              }
            }
          }
        ]
      }
    },
    "eventStreamEndpoint": "testEndpoint"
  }
}
azure-asyncoperation: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.App/locations/eastus/containerappOperationResults/62e4d893-d233-4005-988e-a428d9f77076?api-version=2024-03-01

정의

Name Description
action

들어오는 IP에 대해 규칙을 확인하도록 허용하거나 거부합니다. 참고: 규칙은 모든 허용 또는 모든 거부로만 구성됩니다.

ActiveRevisionsMode

ActiveRevisionsMode는 컨테이너 앱에 대해 활성 수정 버전을 처리하는 방법을 제어합니다. 다중: 여러 수정 버전을 활성화할 수 있습니다.단일: 한 번에 하나의 수정 버전만 활성화할 수 있습니다. 이 모드에서는 수정 가중치를 사용할 수 없습니다. 값이 제공되지 않으면 기본값입니다.

affinity

고정 세션 선호도

appProtocol

애플리케이션에서 사용 중인 프로토콜을 Dapr에 알려줍니다. 유효한 옵션은 http 및 grpc입니다. 기본값은 http입니다.

bindingType

Custom Domain 바인딩 형식입니다.

Configuration

컨테이너 앱의 변경 가능한 설정을 정의하는 버전이 지정되지 않은 컨테이너 앱 구성 속성

Container

컨테이너 앱 컨테이너 정의

ContainerApp

컨테이너 앱.

ContainerAppProbe

프로브는 컨테이너에 대해 수행할 상태 검사 설명하여 활성 상태인지 아니면 트래픽을 받을 준비가 되었는지 확인합니다.

ContainerAppProvisioningState

컨테이너 앱의 프로비전 상태입니다.

ContainerResources

컨테이너 앱 컨테이너 리소스 요구 사항.

CorsPolicy

원본 간 리소스 공유 정책

createdByType

리소스를 만든 ID의 형식입니다.

CustomDomain

컨테이너 앱의 Custom Domain

CustomScaleRule

컨테이너 앱 컨테이너 사용자 지정 크기 조정 규칙입니다.

Dapr

컨테이너 앱 Dapr 구성.

DefaultErrorResponse

오류 응답을 App Service.

Details

세부 정보 또는 오류

EnvironmentVar

컨테이너 앱 컨테이너 환경 변수입니다.

Error

오류 모델.

ExtendedLocation

확장된 위치의 복합 형식입니다.

ExtendedLocationTypes

확장된 위치의 형식입니다.

HttpGet

HTTPGet은 수행할 http 요청을 지정합니다.

HttpHeaders

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복되는 헤더를 허용합니다.

HttpScaleRule

컨테이너 앱 컨테이너 Http 크기 조정 규칙입니다.

Ingress

컨테이너 앱 수신 구성.

IngressClientCertificateMode

mTLS 인증을 위한 클라이언트 인증서 모드. 무시는 전달 시 서버가 클라이언트 인증서를 삭제함을 나타냅니다. 수락은 서버가 클라이언트 인증서를 전달하지만 클라이언트 인증서가 필요하지 않음을 나타냅니다. 필요는 서버에 클라이언트 인증서가 필요함을 나타냅니다.

IngressPortMapping

컨테이너 앱 수신의 포트 매핑

IngressTransportMethod

수신 전송 프로토콜

InitContainer

컨테이너 앱 init 컨테이너 정의

IpSecurityRestrictionRule

들어오는 IP 주소를 제한하는 규칙입니다.

logLevel

Dapr 사이드카의 로그 수준을 설정합니다. 허용되는 값은 디버그, 정보, 경고, 오류입니다. 기본값은 정보입니다.

ManagedServiceIdentity

관리 서비스 ID(시스템 할당 및/또는 사용자 할당 ID)

ManagedServiceIdentityType

관리 서비스 ID 유형(SystemAssigned 및 UserAssigned 형식이 모두 허용됨).

QueueScaleRule

컨테이너 앱 컨테이너 Azure Queue 기반 크기 조정 규칙.

RegistryCredentials

Container App Private Registry

Scale

컨테이너 앱 크기 조정 구성.

ScaleRule

컨테이너 앱 컨테이너 크기 조정 규칙.

ScaleRuleAuth

크기 조정 규칙에 대한 인증 비밀

Scheme

호스트에 연결하는 데 사용할 체계입니다. 기본값은 HTTP입니다.

Secret

비밀 정의.

SecretVolumeItem

볼륨에 추가할 비밀입니다.

Service

개발 서비스로 사용할 컨테이너 앱

ServiceBind

ContainerApp을 개발 ContainerApp Service에 바인딩하는 구성

StickySessions

단일 수정 모드에 대한 고정 세션

StorageType

볼륨의 스토리지 유형입니다. 제공되지 않은 경우 EmptyDir을 사용합니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

TcpScaleRule

컨테이너 앱 컨테이너 Tcp 크기 조정 규칙.

TcpSocket

TCPSocket은 TCP 포트와 관련된 작업을 지정합니다. TCP 후크는 아직 지원되지 않습니다.

Template

컨테이너 앱 버전이 지정된 애플리케이션 정의입니다. 변경할 수 없는 수정 버전의 원하는 상태를 정의합니다. 이 섹션을 변경하면 새 수정 버전이 만들어집니다.

TrafficWeight

수정 버전에 할당된 트래픽 가중치

Type

프로브의 유형입니다.

UserAssignedIdentity

사용자 할당 ID 속성

Volume

컨테이너 앱에 대한 볼륨 정의입니다.

VolumeMount

컨테이너 앱에 대한 볼륨 탑재입니다.

action

들어오는 IP에 대해 규칙을 확인하도록 허용하거나 거부합니다. 참고: 규칙은 모든 허용 또는 모든 거부로만 구성됩니다.

Name 형식 Description
Allow

string

Deny

string

ActiveRevisionsMode

ActiveRevisionsMode는 컨테이너 앱에 대해 활성 수정 버전을 처리하는 방법을 제어합니다. 다중: 여러 수정 버전을 활성화할 수 있습니다.단일: 한 번에 하나의 수정 버전만 활성화할 수 있습니다. 이 모드에서는 수정 가중치를 사용할 수 없습니다. 값이 제공되지 않으면 기본값입니다.

Name 형식 Description
Multiple

string

Single

string

affinity

고정 세션 선호도

Name 형식 Description
none

string

sticky

string

appProtocol

애플리케이션에서 사용 중인 프로토콜을 Dapr에 알려줍니다. 유효한 옵션은 http 및 grpc입니다. 기본값은 http입니다.

Name 형식 Description
grpc

string

http

string

bindingType

Custom Domain 바인딩 형식입니다.

Name 형식 Description
Disabled

string

SniEnabled

string

Configuration

컨테이너 앱의 변경 가능한 설정을 정의하는 버전이 지정되지 않은 컨테이너 앱 구성 속성

Name 형식 Default value Description
activeRevisionsMode

ActiveRevisionsMode

Single

ActiveRevisionsMode는 컨테이너 앱에 대해 활성 수정 버전을 처리하는 방법을 제어합니다. 다중: 여러 수정 버전을 활성화할 수 있습니다.단일: 한 번에 하나의 수정 버전만 활성화할 수 있습니다. 이 모드에서는 수정 가중치를 사용할 수 없습니다. 값이 제공되지 않으면 기본값입니다.

dapr

Dapr

컨테이너 앱에 대한 Dapr 구성입니다.

ingress

Ingress

수신 구성.

maxInactiveRevisions

integer

선택 사항입니다. 컨테이너 앱에 사용할 수 있는 최대 비활성 수정 버전입니다.

registries

RegistryCredentials[]

컨테이너 앱에서 사용하는 컨테이너에 대한 프라이빗 컨테이너 레지스트리 자격 증명 컬렉션

secrets

Secret[]

컨테이너 앱에서 사용하는 비밀 컬렉션

service

Service

개발 컨테이너 앱이 될 컨테이너 App Service

Container

컨테이너 앱 컨테이너 정의

Name 형식 Description
args

string[]

컨테이너 시작 명령 인수입니다.

command

string[]

컨테이너 시작 명령입니다.

env

EnvironmentVar[]

컨테이너 환경 변수.

image

string

컨테이너 이미지 태그입니다.

name

string

사용자 지정 컨테이너 이름입니다.

probes

ContainerAppProbe[]

컨테이너에 대한 프로브 목록입니다.

resources

ContainerResources

컨테이너 리소스 요구 사항.

volumeMounts

VolumeMount[]

컨테이너 볼륨 탑재.

ContainerApp

컨테이너 앱.

Name 형식 Description
extendedLocation

ExtendedLocation

확장된 위치의 복합 형식입니다.

id

string

리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

ManagedServiceIdentity

코드에서 비밀 또는 자격 증명을 유지 관리하지 않고 다른 Azure 서비스와 상호 작용하는 컨테이너 앱의 관리 ID입니다.

location

string

리소스가 있는 지리적 위치

managedBy

string

이 리소스를 관리하는 리소스의 정규화된 리소스 ID입니다. 이 리소스가 다른 Azure 리소스에서 관리되는지를 나타냅니다. 이 경우 전체 모드 배포는 다른 리소스에서 관리되므로 템플릿에서 제거된 경우 리소스를 삭제하지 않습니다.

name

string

리소스의 이름입니다.

properties.configuration

Configuration

버전이 지정되지 않은 Container App 구성 속성입니다.

properties.customDomainVerificationId

string

도메인 이름 소유권을 확인하는 데 사용되는 ID

properties.environmentId

string

환경의 리소스 ID입니다.

properties.eventStreamEndpoint

string

컨테이너 앱의 eventstream 엔드포인트입니다.

properties.latestReadyRevisionName

string

컨테이너 앱의 최신 준비 수정 버전 이름입니다.

properties.latestRevisionFqdn

string

컨테이너 앱의 최신 수정 버전에 대한 정규화된 도메인 이름입니다.

properties.latestRevisionName

string

컨테이너 앱의 최신 수정 버전 이름입니다.

properties.managedEnvironmentId

string

더 이상 사용되지 않습니다. 컨테이너 앱 환경의 리소스 ID입니다.

properties.outboundIpAddresses

string[]

컨테이너 앱에 대한 아웃바운드 IP 주소입니다.

properties.provisioningState

ContainerAppProvisioningState

컨테이너 앱의 프로비전 상태입니다.

properties.template

Template

컨테이너 앱 버전이 지정된 애플리케이션 정의입니다.

properties.workloadProfileName

string

컨테이너 앱 실행을 위해 고정할 워크로드 프로필 이름입니다.

systemData

systemData

createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.

tags

object

리소스 태그.

type

string

리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

ContainerAppProbe

프로브는 컨테이너에 대해 수행할 상태 검사 설명하여 활성 상태인지 아니면 트래픽을 받을 준비가 되었는지 확인합니다.

Name 형식 Description
failureThreshold

integer

프로브에 대한 최소 연속 실패는 성공한 후 실패했습니다. 기본값은 3입니다. 최솟값은 1입니다. 최대값은 10입니다.

httpGet

HttpGet

HTTPGet은 수행할 http 요청을 지정합니다.

initialDelaySeconds

integer

컨테이너가 시작된 후 활동성 프로브가 시작되기 전까지의 시간(초)입니다. 최솟값은 1입니다. 최대값은 60입니다.

periodSeconds

integer

프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최솟값은 1입니다. 최대값은 240입니다.

successThreshold

integer

실패한 후 프로브가 성공한 것으로 간주될 최소 연속 성공입니다. 기본값은 1입니다. 활동성 및 시작의 경우 1이어야 합니다. 최솟값은 1입니다. 최대값은 10입니다.

tcpSocket

TcpSocket

TCPSocket은 TCP 포트와 관련된 작업을 지정합니다. TCP 후크는 아직 지원되지 않습니다.

terminationGracePeriodSeconds

integer

선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후의 기간(초)과 종료 신호로 프로세스가 강제로 중단되는 시간입니다. 이 값을 프로세스의 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 재정의합니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 기회가 없음). 알파 필드이며 ProbeTerminationGracePeriod 기능 게이트를 사용하도록 설정해야 합니다. 최대값은 3600초(1시간)입니다.

timeoutSeconds

integer

프로브 시간이 초과된 후의 시간(초)입니다. 기본값은 1초입니다. 최솟값은 1입니다. 최대값은 240입니다.

type

Type

프로브 유형입니다.

ContainerAppProvisioningState

컨테이너 앱의 프로비전 상태입니다.

Name 형식 Description
Canceled

string

Deleting

string

Failed

string

InProgress

string

Succeeded

string

ContainerResources

컨테이너 앱 컨테이너 리소스 요구 사항.

Name 형식 Description
cpu

number

코어의 필수 CPU(예: 0.5)

ephemeralStorage

string

임시 스토리지(예: "1Gi"

memory

string

필수 메모리(예: "250Mb"

CorsPolicy

원본 간 리소스 공유 정책

Name 형식 Description
allowCredentials

boolean

리소스에서 자격 증명을 허용하는지 여부를 지정합니다.

allowedHeaders

string[]

access-control-allow-headers 헤더의 콘텐츠를 지정합니다.

allowedMethods

string[]

access-control-allow-methods 헤더의 콘텐츠를 지정합니다.

allowedOrigins

string[]

access-control-allow-origins 헤더의 콘텐츠를 지정합니다.

exposeHeaders

string[]

access-control-expose-headers 헤더의 콘텐츠를 지정합니다.

maxAge

integer

access-control-max-age 헤더의 콘텐츠를 지정합니다.

createdByType

리소스를 만든 ID의 형식입니다.

Name 형식 Description
Application

string

Key

string

ManagedIdentity

string

User

string

CustomDomain

컨테이너 앱의 Custom Domain

Name 형식 Description
bindingType

bindingType

바인딩 형식을 Custom Domain.

certificateId

string

이 호스트 이름에 바인딩할 인증서의 리소스 ID입니다. 관리되는 환경에 있어야 합니다.

name

string

호스트 이름

CustomScaleRule

컨테이너 앱 컨테이너 사용자 지정 크기 조정 규칙입니다.

Name 형식 Description
auth

ScaleRuleAuth[]

사용자 지정 크기 조정 규칙에 대한 인증 비밀입니다.

metadata

object

사용자 지정 크기 조정 규칙을 설명하는 메타데이터 속성입니다.

type

string

사용자 지정 크기 조정 규칙의 유형(예: azure-servicebus, redis 등).

Dapr

컨테이너 앱 Dapr 구성.

Name 형식 Default value Description
appId

string

Dapr 애플리케이션 식별자

appPort

integer

애플리케이션이 수신 대기 중인 포트를 Dapr에 알릴 수 있습니다.

appProtocol

appProtocol

http

애플리케이션에서 사용 중인 프로토콜을 Dapr에 알려줍니다. 유효한 옵션은 http 및 grpc입니다. 기본값은 http입니다.

enableApiLogging

boolean

Dapr 사이드카에 대한 API 로깅 사용

enabled

boolean

False

Dapr 사이드카를 사용할 수 있는지 여부를 나타내는 부울

httpMaxRequestSize

integer

큰 파일 업로드를 처리하기 위해 요청 본문 http 및 grpc servers 매개 변수의 최대 크기를 MB로 늘입니다. 기본값은 4MB입니다.

httpReadBufferSize

integer

다중 KB 헤더를 보낼 때 처리할 HTTP 헤더 읽기 버퍼의 Dapr 최대 크기입니다. 기본값은 65KB입니다.

logLevel

logLevel

Dapr 사이드카의 로그 수준을 설정합니다. 허용되는 값은 디버그, 정보, 경고, 오류입니다. 기본값은 정보입니다.

DefaultErrorResponse

오류 응답을 App Service.

Name 형식 Description
error

Error

오류 모델.

Details

세부 정보 또는 오류

Name 형식 Description
code

string

프로그래밍 방식으로 오류를 식별하는 표준화된 문자열입니다.

message

string

자세한 오류 설명 및 디버깅 정보입니다.

target

string

자세한 오류 설명 및 디버깅 정보입니다.

EnvironmentVar

컨테이너 앱 컨테이너 환경 변수입니다.

Name 형식 Description
name

string

환경 변수 이름입니다.

secretRef

string

환경 변수 값을 끌어올 컨테이너 앱 비밀의 이름입니다.

value

string

비밀이 아닌 환경 변수 값입니다.

Error

오류 모델.

Name 형식 Description
code

string

프로그래밍 방식으로 오류를 식별하는 표준화된 문자열입니다.

details

Details[]

세부 정보 또는 오류

innererror

string

디버그 오류에 대한 자세한 정보입니다.

message

string

자세한 오류 설명 및 디버깅 정보입니다.

target

string

자세한 오류 설명 및 디버깅 정보입니다.

ExtendedLocation

확장된 위치의 복합 형식입니다.

Name 형식 Description
name

string

확장된 위치의 이름입니다.

type

ExtendedLocationTypes

확장된 위치의 형식입니다.

ExtendedLocationTypes

확장된 위치의 형식입니다.

Name 형식 Description
CustomLocation

string

HttpGet

HTTPGet은 수행할 http 요청을 지정합니다.

Name 형식 Description
host

string

연결할 호스트 이름이며, 기본적으로 Pod IP로 설정됩니다. 대신 httpHeaders에서 "호스트"를 설정하려고 할 수 있습니다.

httpHeaders

HttpHeaders[]

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복되는 헤더를 허용합니다.

path

string

HTTP 서버에서 액세스하는 경로입니다.

port

integer

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1에서 65535까지의 범위에 있어야 합니다. 이름은 IANA_SVC_NAME 합니다.

scheme

Scheme

호스트에 연결하는 데 사용할 체계입니다. 기본값은 HTTP입니다.

HttpHeaders

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복되는 헤더를 허용합니다.

Name 형식 Description
name

string

헤더 필드 이름

value

string

헤더 필드 값

HttpScaleRule

컨테이너 앱 컨테이너 Http 크기 조정 규칙입니다.

Name 형식 Description
auth

ScaleRuleAuth[]

사용자 지정 크기 조정 규칙에 대한 인증 비밀입니다.

metadata

object

http 크기 조정 규칙을 설명하는 메타데이터 속성입니다.

Ingress

컨테이너 앱 수신 구성.

Name 형식 Default value Description
additionalPortMappings

IngressPortMapping[]

컨테이너 앱에 추가 포트를 노출하는 설정

allowInsecure

boolean

False

에 대한 HTTP 연결이 허용되는지 여부를 나타내는 부울입니다. false HTTP 연결로 설정하면 HTTPS 연결로 자동 리디렉션됩니다.

clientCertificateMode

IngressClientCertificateMode

mTLS 인증을 위한 클라이언트 인증서 모드. 무시는 전달 시 서버가 클라이언트 인증서를 삭제함을 나타냅니다. 수락은 서버가 클라이언트 인증서를 전달하지만 클라이언트 인증서가 필요하지 않음을 나타냅니다. 필요는 서버에 클라이언트 인증서가 필요함을 나타냅니다.

corsPolicy

CorsPolicy

컨테이너 앱에 대한 CORS 정책

customDomains

CustomDomain[]

Container Apps의 호스트 이름에 대한 사용자 지정 도메인 바인딩입니다.

exposedPort

integer

수신에서 TCP 트래픽에 대한 컨테이너의 노출된 포트

external

boolean

False

앱이 외부 http 엔드포인트를 노출하는지 여부를 나타내는 Bool

fqdn

string

호스트 이름

ipSecurityRestrictions

IpSecurityRestrictionRule[]

들어오는 IP 주소를 제한하는 규칙입니다.

stickySessions

StickySessions

단일 수정 모드에 대한 고정 세션

targetPort

integer

수신 트래픽에 대한 컨테이너의 대상 포트

traffic

TrafficWeight[]

앱의 수정 버전에 대한 트래픽 가중치

transport

IngressTransportMethod

auto

수신 전송 프로토콜

IngressClientCertificateMode

mTLS 인증을 위한 클라이언트 인증서 모드. 무시는 전달 시 서버가 클라이언트 인증서를 삭제함을 나타냅니다. 수락은 서버가 클라이언트 인증서를 전달하지만 클라이언트 인증서가 필요하지 않음을 나타냅니다. 필요는 서버에 클라이언트 인증서가 필요함을 나타냅니다.

Name 형식 Description
accept

string

ignore

string

require

string

IngressPortMapping

컨테이너 앱 수신의 포트 매핑

Name 형식 Description
exposedPort

integer

대상 포트에 대해 노출된 포트를 지정합니다. 지정하지 않으면 기본적으로 대상 포트로 설정됩니다.

external

boolean

환경 외부에서 앱 포트에 액세스할 수 있는지 여부를 지정합니다.

targetPort

integer

사용자의 컨테이너가 수신 대기하는 포트를 지정합니다.

IngressTransportMethod

수신 전송 프로토콜

Name 형식 Description
auto

string

http

string

http2

string

tcp

string

InitContainer

컨테이너 앱 init 컨테이너 정의

Name 형식 Description
args

string[]

컨테이너 시작 명령 인수입니다.

command

string[]

컨테이너 시작 명령입니다.

env

EnvironmentVar[]

컨테이너 환경 변수.

image

string

컨테이너 이미지 태그입니다.

name

string

사용자 지정 컨테이너 이름입니다.

resources

ContainerResources

컨테이너 리소스 요구 사항.

volumeMounts

VolumeMount[]

컨테이너 볼륨 탑재.

IpSecurityRestrictionRule

들어오는 IP 주소를 제한하는 규칙입니다.

Name 형식 Description
action

action

들어오는 IP를 결정하는 규칙을 허용하거나 거부합니다. 참고: 규칙은 모든 허용 또는 모든 거부로만 구성됩니다.

description

string

container-app으로 전송되는 IP 제한 규칙을 설명합니다. 옵션 필드입니다.

ipAddressRange

string

들어오는 IP 주소와 일치하는 CIDR 표기법

name

string

IP 제한 규칙의 이름입니다.

logLevel

Dapr 사이드카의 로그 수준을 설정합니다. 허용되는 값은 디버그, 정보, 경고, 오류입니다. 기본값은 정보입니다.

Name 형식 Description
debug

string

error

string

info

string

warn

string

ManagedServiceIdentity

관리 서비스 ID(시스템 할당 및/또는 사용자 할당 ID)

Name 형식 Description
principalId

string

시스템 할당 ID의 서비스 주체 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다.

tenantId

string

시스템 할당 ID의 테넌트 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다.

type

ManagedServiceIdentityType

관리 서비스 ID 유형(SystemAssigned 및 UserAssigned 형식이 모두 허용됨).

userAssignedIdentities

<string,  UserAssignedIdentity>

User-Assigned ID
리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다.

ManagedServiceIdentityType

관리 서비스 ID 유형(SystemAssigned 및 UserAssigned 형식이 모두 허용됨).

Name 형식 Description
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

QueueScaleRule

컨테이너 앱 컨테이너 Azure Queue 기반 크기 조정 규칙.

Name 형식 Description
auth

ScaleRuleAuth[]

큐 크기 조정 규칙에 대한 인증 비밀입니다.

queueLength

integer

큐 길이입니다.

queueName

string

큐 이름입니다.

RegistryCredentials

Container App Private Registry

Name 형식 Description
identity

string

Azure Container Registry 인증하는 데 사용할 관리 ID입니다. 사용자 할당 ID의 경우 전체 사용자 할당 ID 리소스 ID를 사용합니다. 시스템 할당 ID의 경우 '시스템'을 사용합니다.

passwordSecretRef

string

레지스트리 로그인 암호를 포함하는 비밀의 이름입니다.

server

string

Container Registry Server

username

string

Container Registry 사용자 이름

Scale

컨테이너 앱 크기 조정 구성.

Name 형식 Default value Description
maxReplicas

integer

10

선택 사항입니다. 최대 컨테이너 복제본 수입니다. 설정하지 않으면 기본값은 10입니다.

minReplicas

integer

선택 사항입니다. 최소 컨테이너 복제본 수입니다.

rules

ScaleRule[]

크기 조정 규칙.

ScaleRule

컨테이너 앱 컨테이너 크기 조정 규칙.

Name 형식 Description
azureQueue

QueueScaleRule

Azure Queue 기반 크기 조정.

custom

CustomScaleRule

사용자 지정 크기 조정 규칙입니다.

http

HttpScaleRule

HTTP 요청 기반 크기 조정.

name

string

눈금 규칙 이름

tcp

TcpScaleRule

Tcp 요청 기반 크기 조정.

ScaleRuleAuth

크기 조정 규칙에 대한 인증 비밀

Name 형식 Description
secretRef

string

인증 매개 변수를 가져올 비밀의 이름입니다.

triggerParameter

string

비밀을 사용하는 트리거 매개 변수

Scheme

호스트에 연결하는 데 사용할 체계입니다. 기본값은 HTTP입니다.

Name 형식 Description
HTTP

string

HTTPS

string

Secret

비밀 정의.

Name 형식 Description
identity

string

Azure Key Vault 인증할 관리 ID의 리소스 ID 또는 시스템 할당 ID를 사용하는 시스템입니다.

keyVaultUrl

string

컨테이너 앱에서 참조하는 비밀을 가리키는 Azure Key Vault URL입니다.

name

string

비밀 이름입니다.

value

string

비밀 값입니다.

SecretVolumeItem

볼륨에 추가할 비밀입니다.

Name 형식 Description
path

string

프로젝트 비밀 경로입니다. 경로가 제공되지 않으면 경로는 기본적으로 secretRef에 나열된 비밀의 이름으로 설정됩니다.

secretRef

string

비밀 값을 끌어올 컨테이너 앱 비밀의 이름입니다.

Service

개발 서비스로 사용할 컨테이너 앱

Name 형식 Description
type

string

Dev ContainerApp 서비스 유형

ServiceBind

ContainerApp을 개발 ContainerApp Service에 바인딩하는 구성

Name 형식 Description
name

string

서비스 바인딩의 이름

serviceId

string

대상 서비스의 리소스 ID

StickySessions

단일 수정 모드에 대한 고정 세션

Name 형식 Description
affinity

affinity

고정 세션 선호도

StorageType

볼륨의 스토리지 유형입니다. 제공되지 않은 경우 EmptyDir을 사용합니다.

Name 형식 Description
AzureFile

string

EmptyDir

string

Secret

string

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

Name 형식 Description
createdAt

string

UTC(리소스 만들기)의 타임스탬프입니다.

createdBy

string

리소스를 만든 ID입니다.

createdByType

createdByType

리소스를 만든 ID의 형식입니다.

lastModifiedAt

string

리소스 마지막 수정의 타임스탬프(UTC)

lastModifiedBy

string

리소스를 마지막으로 수정한 ID입니다.

lastModifiedByType

createdByType

리소스를 마지막으로 수정한 ID 유형입니다.

TcpScaleRule

컨테이너 앱 컨테이너 Tcp 크기 조정 규칙.

Name 형식 Description
auth

ScaleRuleAuth[]

tcp 크기 조정 규칙에 대한 인증 비밀입니다.

metadata

object

tcp 크기 조정 규칙을 설명하는 메타데이터 속성입니다.

TcpSocket

TCPSocket은 TCP 포트와 관련된 작업을 지정합니다. TCP 후크는 아직 지원되지 않습니다.

Name 형식 Description
host

string

선택 사항: 연결할 호스트 이름이며, 기본값은 Pod IP입니다.

port

integer

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1에서 65535까지의 범위에 있어야 합니다. 이름은 IANA_SVC_NAME 합니다.

Template

컨테이너 앱 버전이 지정된 애플리케이션 정의입니다. 변경할 수 없는 수정 버전의 원하는 상태를 정의합니다. 이 섹션을 변경하면 새 수정 버전이 만들어집니다.

Name 형식 Description
containers

Container[]

컨테이너 앱에 대한 컨테이너 정의 목록입니다.

initContainers

InitContainer[]

앱 컨테이너 이전에 실행되는 특수 컨테이너 목록입니다.

revisionSuffix

string

수정 이름에 추가된 사용자에게 친숙한 접미사

scale

Scale

컨테이너 앱의 크기 조정 속성입니다.

serviceBinds

ServiceBind[]

앱에 바인딩된 컨테이너 앱 서비스 목록

terminationGracePeriodSeconds

integer

Container App Instance가 정상적으로 종료되어야 하는 시간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 기회가 없음). 이 값이 nil이면 기본 유예 기간이 대신 사용됩니다. 이 값을 프로세스의 예상 정리 시간보다 길게 설정합니다. 기본값은 30초입니다.

volumes

Volume[]

컨테이너 앱에 대한 볼륨 정의 목록입니다.

TrafficWeight

수정 버전에 할당된 트래픽 가중치

Name 형식 Default value Description
label

string

트래픽 레이블을 수정 버전과 연결

latestRevision

boolean

False

트래픽 가중치가 안정적인 최신 수정 버전에 속한다는 것을 나타냅니다.

revisionName

string

수정 버전 이름

weight

integer

수정 버전에 할당된 트래픽 가중치

Type

프로브의 유형입니다.

Name 형식 Description
Liveness

string

Readiness

string

Startup

string

UserAssignedIdentity

사용자 할당 ID 속성

Name 형식 Description
clientId

string

할당된 ID의 클라이언트 ID입니다.

principalId

string

할당된 ID의 보안 주체 ID입니다.

Volume

컨테이너 앱에 대한 볼륨 정의입니다.

Name 형식 Description
mountOptions

string

AzureFile을 탑재하는 동안 사용되는 탑재 옵션입니다. 쉼표로 구분된 문자열이어야 합니다.

name

string

볼륨 이름입니다.

secrets

SecretVolumeItem[]

볼륨에 추가할 비밀 목록입니다. 비밀이 제공되지 않으면 컬렉션의 모든 비밀이 볼륨에 추가됩니다.

storageName

string

스토리지 리소스의 이름입니다. EmptyDir 및 Secret을 제공할 필요가 없습니다.

storageType

StorageType

볼륨의 스토리지 유형입니다. 제공되지 않은 경우 EmptyDir을 사용합니다.

VolumeMount

컨테이너 앱에 대한 볼륨 탑재입니다.

Name 형식 Description
mountPath

string

볼륨을 탑재해야 하는 컨테이너 내의 경로입니다. ':'을 포함하지 않아야 합니다.

subPath

string

컨테이너 볼륨을 탑재해야 하는 볼륨 내의 경로입니다. 기본값은 ""(볼륨의 루트)입니다.

volumeName

string

볼륨의 이름과 일치해야 합니다.