Microsoft.App sessionPools

2025-05-14

Bicep 리소스 정의

sessionPools 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

리소스 그룹 - 리소스 그룹 배포 명령 참조

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.App/sessionPools 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.App/sessionPools@2025-02-02-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    containerType: 'string'
    customContainerTemplate: {
      containers: [
        {
          args: [
            'string'
          ]
          command: [
            'string'
          ]
          env: [
            {
              name: 'string'
              secretRef: 'string'
              value: 'string'
            }
          ]
          image: 'string'
          name: 'string'
          probes: [
            {
              failureThreshold: int
              httpGet: {
                host: 'string'
                httpHeaders: [
                  {
                    name: 'string'
                    value: 'string'
                  }
                ]
                path: 'string'
                port: int
                scheme: 'string'
              }
              initialDelaySeconds: int
              periodSeconds: int
              successThreshold: int
              tcpSocket: {
                host: 'string'
                port: int
              }
              terminationGracePeriodSeconds: int
              timeoutSeconds: int
              type: 'string'
            }
          ]
          resources: {
            cpu: int
            memory: 'string'
          }
        }
      ]
      ingress: {
        targetPort: int
      }
      registryCredentials: {
        identity: 'string'
        passwordSecretRef: 'string'
        server: 'string'
        username: 'string'
      }
    }
    dynamicPoolConfiguration: {
      lifecycleConfiguration: {
        cooldownPeriodInSeconds: int
        lifecycleType: 'string'
        maxAlivePeriodInSeconds: int
      }
    }
    environmentId: 'string'
    managedIdentitySettings: [
      {
        identity: 'string'
        lifecycle: 'string'
      }
    ]
    poolManagementType: 'string'
    scaleConfiguration: {
      maxConcurrentSessions: int
      readySessionInstances: int
    }
    secrets: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    sessionNetworkConfiguration: {
      status: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

속성 값

Microsoft.App/sessionPools

이름	설명	가치
정체성	코드에서 비밀 또는 자격 증명을 유지 관리하지 않기 위해 세션 풀이 다른 Azure 서비스와 상호 작용하는 데 필요한 관리 ID입니다.	ManagedServiceIdentity
위치	리소스가 있는 지리적 위치	string(필수)
이름	리소스 이름	문자열 제약 조건: 최소 길이 = 3 최대 길이 = 63 패턴 = `^[a-z][a-z0-9]*$`(필수)
속성	컨테이너 앱 세션 풀 리소스 관련 속성	세션 풀 속성
태그	리소스 태그	태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.

CustomContainerTemplate

이름	설명	가치
컨테이너	세션 풀의 세션에 대한 컨테이너 정의 목록입니다.	세션 컨테이너[]
입구	세션 풀 수신 구성입니다.	세션 인그레스
registry자격 증명	세션 풀의 세션에서 사용하는 컨테이너에 대한 프라이빗 컨테이너 레지스트리 자격 증명입니다.	세션 레지스트리자격 증명

DynamicPoolConfiguration

이름	설명	가치
lifecycleConfiguration	동적 세션 풀에서 세션의 수명 주기 구성	수명 주기 구성

환경 변수

이름	설명	가치
이름	환경 변수 이름입니다.	문자열
시크릿Ref	환경 변수 값을 끌어올 컨테이너 앱 비밀의 이름입니다.	문자열
가치	비밀이 아닌 환경 변수 값입니다.	문자열

수명 주기 구성

이름	설명	가치
쿨다운기간InSeconds	수명 주기 유형이 'Timed'인 세션의 쿨다운 기간(초)입니다.	정수 (int)
lifecycleType을 선택합니다.	세션 풀의 수명 주기 유형입니다.	'컨테이너 출구' '시간 초과'
maxAlivePeriodInSeconds	수명 주기 유형이 'OnContainerExit'인 경우 세션의 최대 활성 기간(초)입니다.	정수 (int)

ManagedIdentitySetting

이름	설명	가치
정체성	세션 풀에 할당된 사용자 할당 관리 ID의 리소스 ID이거나 시스템 할당 ID에 대한 '시스템'입니다.	string(필수)
수명 주기	관리 ID를 사용할 수 있어야 하는 세션 풀의 수명 주기 단계를 선택하는 데 사용합니다.	'모두' '초기화' '메인' '없음'

ManagedServiceIdentity (관리형 서비스 ID)

이름	설명	가치
유형	관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우).	'없음' '시스템 할당됨' '시스템 할당, 사용자 할당' 'UserAssigned'(필수)
userAssignedIdentities	리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다.	UserAssignedIdentities

스케일구성

이름	설명	가치
maxConcurrentSessions (최대동시 세션 수)	동시에 최대 세션 수입니다.	정수 (int)
readySession인스턴스	준비된 세션 인스턴스의 최소 수입니다.	정수 (int)

세션 컨테이너

이름	설명	가치
인수(args)	컨테이너 시작 명령 인수입니다.	문자열[]
명령어	컨테이너 시작 명령입니다.	문자열[]
환경	컨테이너 환경 변수입니다.	환경Var[]
이미지	컨테이너 이미지 태그입니다.	문자열
이름	사용자 지정 컨테이너 이름입니다.	문자열
프로브	컨테이너에 대한 프로브 목록입니다.	세션 프로브[]
리소스	컨테이너 리소스 요구 사항.	sessionContainerResources

SessionContainerResources

이름	설명	가치
cpu(cpu)	코어의 필수 CPU(예: 0.5)	정수 (int)
메모리	필요한 메모리(예: "250Mb")	문자열

세션 인그레스

이름	설명	가치
타겟 포트	수신 트래픽에 대한 컨테이너의 대상 포트	정수 (int)

세션 네트워크 구성

이름	설명	가치
상태	세션의 네트워크 상태입니다.	'송신 비활성화' '송신 활성화됨'

세션 풀 속성

이름	설명	가치
컨테이너 유형	세션의 컨테이너 형식입니다.	'사용자 지정 컨테이너' '파이썬LTS'
customContainerTemplate	containerType이 CustomContainer인 경우 사용자 지정 컨테이너 구성입니다.	CustomContainerTemplate
dynamicPoolConfiguration	poolManagementType이 동적인 경우 풀 구성입니다.	DynamicPoolConfiguration
환경 ID	세션 풀 환경의 리소스 ID입니다.	문자열
관리 아이덴티티 설정	세션 풀에 할당된 관리 ID에 대한 선택적 설정입니다.	관리신원설정[]
풀 관리 유형	세션 풀의 풀 관리 유형입니다.	'동적' '수동'
스케일구성	세션 풀의 크기 조정 구성입니다.	ScaleConfiguration
비밀	세션 풀의 비밀입니다.	세션 풀 시크릿[]
세션 네트워크 구성	세션 풀에 있는 세션의 네트워크 구성입니다.	sessionNetworkConfiguration

세션 풀시크릿

이름	설명	가치
이름	비밀 이름입니다.	문자열
가치	비밀 값입니다.	문자열 제약 조건: 중요한 값입니다. 보안 매개 변수로 전달합니다.

세션프로브

이름	설명	가치
failureThreshold	프로브를 고려할 최소 연속 실패는 성공한 후 실패했습니다. 기본값은 3입니다. 최소값은 1입니다. 최대값은 10입니다.	정수 (int)
httpGet	HTTPGet은 수행할 http 요청을 지정합니다.	SessionProbeHttpGet을 참조하십시오.
initialDelaySeconds	활동성 프로브가 시작되기 전에 컨테이너가 시작된 후의 시간(초)입니다. 최소값은 1입니다. 최대값은 60입니다.	정수 (int)
기간초	프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다. 최대값은 240입니다.	정수 (int)
successThreshold	실패한 후 프로브가 성공한 것으로 간주될 최소 연속 성공입니다. 기본값은 1입니다. 활동성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다. 최대값은 10입니다.	정수 (int)
tcp소켓	TCPSocket은 TCP 포트와 관련된 작업을 지정합니다. TCP 후크는 아직 지원되지 않습니다.	SessionProbeTcp소켓
종료GracePeriodSeconds	선택적 기간(초)은 프로브 실패 시 Pod가 정상적으로 종료되어야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후의 기간(초)이며 프로세스가 종료 신호로 강제로 중단되는 시간입니다. 이 값을 프로세스의 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 재정의합니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 kill 신호를 통해 즉시 중지됨을 나타냅니다(종료할 기회가 없음). 알파 필드이며 ProbeTerminationGracePeriod 기능 게이트를 사용하도록 설정해야 합니다. 최대값은 3600초(1시간)입니다.	정수 (int)
타임아웃초	프로브 시간이 초과된 후의 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 최대값은 240입니다.	정수 (int)
유형	프로브의 유형을 나타냅니다. Liveness 또는 Startup일 수 있으며, Readiness 프로브는 세션에서 지원되지 않습니다. 유형은 프로브 목록(SessionProbes)의 컨텍스트 내에서 각 프로브에 대해 고유해야 합니다.	'활기' '스타트업'

SessionProbeHttpGet을 참조하십시오.

이름	설명	가치
주최자 / 호스트	연결할 호스트 이름입니다. 기본적으로 Pod IP가 사용됩니다. 대신 httpHeaders에서 "호스트"를 설정하려고 할 것입니다.	문자열
HTTP 헤더	요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복되는 헤더를 허용합니다.	SessionProbeHttpGetHttpHeadersItem[]
길	HTTP 서버에서 액세스하는 경로입니다.	문자열
항구	컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 번호는 1에서 65535까지의 범위에 있어야 합니다. 이름은 IANA_SVC_NAME 합니다.	int(필수)
계획	호스트에 연결하는 데 사용할 체계입니다. 기본값은 HTTP입니다.	'HTTP' 'HTTPS'입니다.

SessionProbeHttpGetHttpHeaders항목

이름	설명	가치
이름	헤더 필드 이름	string(필수)
가치	헤더 필드 값	string(필수)

SessionProbeTcp소켓

이름	설명	가치
주최자 / 호스트	선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.	문자열
항구	컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 번호는 1에서 65535까지의 범위에 있어야 합니다. 이름은 IANA_SVC_NAME 합니다.	int(필수)

세션 레지스트리자격 증명

이름	설명	가치
정체성	Azure Container Registry로 인증하는 데 사용할 관리 ID입니다. 사용자 할당 ID의 경우 전체 사용자 할당 ID 리소스 ID를 사용합니다. 시스템 할당 ID의 경우 'system'을 사용합니다.	문자열
passwordSecretRef	레지스트리 로그인 암호를 포함하는 비밀의 이름입니다.	문자열
서버	컨테이너 레지스트리 서버.	문자열
사용자 이름	컨테이너 레지스트리 사용자 이름입니다.	문자열

TrackedResource태그

이름	설명	가치

UserAssignedIdentities

이름	설명	가치

사용자 할당 ID

이름	설명	가치

사용 예제

Azure 확인된 모듈

다음 Azure 확인된 모듈 사용하여 이 리소스 유형을 배포할 수 있습니다.

모듈	설명
앱 세션 풀	앱 세션 풀용 AVM 리소스 모듈

ARM 템플릿 리소스 정의

sessionPools 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

리소스 그룹 - 리소스 그룹 배포 명령 참조

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.App/sessionPools 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.App/sessionPools",
  "apiVersion": "2025-02-02-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "containerType": "string",
    "customContainerTemplate": {
      "containers": [
        {
          "args": [ "string" ],
          "command": [ "string" ],
          "env": [
            {
              "name": "string",
              "secretRef": "string",
              "value": "string"
            }
          ],
          "image": "string",
          "name": "string",
          "probes": [
            {
              "failureThreshold": "int",
              "httpGet": {
                "host": "string",
                "httpHeaders": [
                  {
                    "name": "string",
                    "value": "string"
                  }
                ],
                "path": "string",
                "port": "int",
                "scheme": "string"
              },
              "initialDelaySeconds": "int",
              "periodSeconds": "int",
              "successThreshold": "int",
              "tcpSocket": {
                "host": "string",
                "port": "int"
              },
              "terminationGracePeriodSeconds": "int",
              "timeoutSeconds": "int",
              "type": "string"
            }
          ],
          "resources": {
            "cpu": "int",
            "memory": "string"
          }
        }
      ],
      "ingress": {
        "targetPort": "int"
      },
      "registryCredentials": {
        "identity": "string",
        "passwordSecretRef": "string",
        "server": "string",
        "username": "string"
      }
    },
    "dynamicPoolConfiguration": {
      "lifecycleConfiguration": {
        "cooldownPeriodInSeconds": "int",
        "lifecycleType": "string",
        "maxAlivePeriodInSeconds": "int"
      }
    },
    "environmentId": "string",
    "managedIdentitySettings": [
      {
        "identity": "string",
        "lifecycle": "string"
      }
    ],
    "poolManagementType": "string",
    "scaleConfiguration": {
      "maxConcurrentSessions": "int",
      "readySessionInstances": "int"
    },
    "secrets": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "sessionNetworkConfiguration": {
      "status": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

속성 값

Microsoft.App/sessionPools

이름	설명	가치
API버전	api 버전	'2025-02-02-미리보기'
정체성	코드에서 비밀 또는 자격 증명을 유지 관리하지 않기 위해 세션 풀이 다른 Azure 서비스와 상호 작용하는 데 필요한 관리 ID입니다.	ManagedServiceIdentity
위치	리소스가 있는 지리적 위치	string(필수)
이름	리소스 이름	문자열 제약 조건: 최소 길이 = 3 최대 길이 = 63 패턴 = `^[a-z][a-z0-9]*$`(필수)
속성	컨테이너 앱 세션 풀 리소스 관련 속성	세션 풀 속성
태그	리소스 태그	태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
유형	리소스 종류	'Microsoft.App/sessionPools'

CustomContainerTemplate

이름	설명	가치
컨테이너	세션 풀의 세션에 대한 컨테이너 정의 목록입니다.	세션 컨테이너[]
입구	세션 풀 수신 구성입니다.	세션 인그레스
registry자격 증명	세션 풀의 세션에서 사용하는 컨테이너에 대한 프라이빗 컨테이너 레지스트리 자격 증명입니다.	세션 레지스트리자격 증명

DynamicPoolConfiguration

이름	설명	가치
lifecycleConfiguration	동적 세션 풀에서 세션의 수명 주기 구성	수명 주기 구성

환경 변수

이름	설명	가치
이름	환경 변수 이름입니다.	문자열
시크릿Ref	환경 변수 값을 끌어올 컨테이너 앱 비밀의 이름입니다.	문자열
가치	비밀이 아닌 환경 변수 값입니다.	문자열

수명 주기 구성

이름	설명	가치
쿨다운기간InSeconds	수명 주기 유형이 'Timed'인 세션의 쿨다운 기간(초)입니다.	정수 (int)
lifecycleType을 선택합니다.	세션 풀의 수명 주기 유형입니다.	'컨테이너 출구' '시간 초과'
maxAlivePeriodInSeconds	수명 주기 유형이 'OnContainerExit'인 경우 세션의 최대 활성 기간(초)입니다.	정수 (int)

ManagedIdentitySetting

이름	설명	가치
정체성	세션 풀에 할당된 사용자 할당 관리 ID의 리소스 ID이거나 시스템 할당 ID에 대한 '시스템'입니다.	string(필수)
수명 주기	관리 ID를 사용할 수 있어야 하는 세션 풀의 수명 주기 단계를 선택하는 데 사용합니다.	'모두' '초기화' '메인' '없음'

ManagedServiceIdentity (관리형 서비스 ID)

이름	설명	가치
유형	관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우).	'없음' '시스템 할당됨' '시스템 할당, 사용자 할당' 'UserAssigned'(필수)
userAssignedIdentities	리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다.	UserAssignedIdentities

스케일구성

이름	설명	가치
maxConcurrentSessions (최대동시 세션 수)	동시에 최대 세션 수입니다.	정수 (int)
readySession인스턴스	준비된 세션 인스턴스의 최소 수입니다.	정수 (int)

세션 컨테이너

이름	설명	가치
인수(args)	컨테이너 시작 명령 인수입니다.	문자열[]
명령어	컨테이너 시작 명령입니다.	문자열[]
환경	컨테이너 환경 변수입니다.	환경Var[]
이미지	컨테이너 이미지 태그입니다.	문자열
이름	사용자 지정 컨테이너 이름입니다.	문자열
프로브	컨테이너에 대한 프로브 목록입니다.	세션 프로브[]
리소스	컨테이너 리소스 요구 사항.	sessionContainerResources

SessionContainerResources

이름	설명	가치
cpu(cpu)	코어의 필수 CPU(예: 0.5)	정수 (int)
메모리	필요한 메모리(예: "250Mb")	문자열

세션 인그레스

이름	설명	가치
타겟 포트	수신 트래픽에 대한 컨테이너의 대상 포트	정수 (int)

세션 네트워크 구성

이름	설명	가치
상태	세션의 네트워크 상태입니다.	'송신 비활성화' '송신 활성화됨'

세션 풀 속성

이름	설명	가치
컨테이너 유형	세션의 컨테이너 형식입니다.	'사용자 지정 컨테이너' '파이썬LTS'
customContainerTemplate	containerType이 CustomContainer인 경우 사용자 지정 컨테이너 구성입니다.	CustomContainerTemplate
dynamicPoolConfiguration	poolManagementType이 동적인 경우 풀 구성입니다.	DynamicPoolConfiguration
환경 ID	세션 풀 환경의 리소스 ID입니다.	문자열
관리 아이덴티티 설정	세션 풀에 할당된 관리 ID에 대한 선택적 설정입니다.	관리신원설정[]
풀 관리 유형	세션 풀의 풀 관리 유형입니다.	'동적' '수동'
스케일구성	세션 풀의 크기 조정 구성입니다.	ScaleConfiguration
비밀	세션 풀의 비밀입니다.	세션 풀 시크릿[]
세션 네트워크 구성	세션 풀에 있는 세션의 네트워크 구성입니다.	sessionNetworkConfiguration

세션 풀시크릿

이름	설명	가치
이름	비밀 이름입니다.	문자열
가치	비밀 값입니다.	문자열 제약 조건: 중요한 값입니다. 보안 매개 변수로 전달합니다.

세션프로브

이름	설명	가치
failureThreshold	프로브를 고려할 최소 연속 실패는 성공한 후 실패했습니다. 기본값은 3입니다. 최소값은 1입니다. 최대값은 10입니다.	정수 (int)
httpGet	HTTPGet은 수행할 http 요청을 지정합니다.	SessionProbeHttpGet을 참조하십시오.
initialDelaySeconds	활동성 프로브가 시작되기 전에 컨테이너가 시작된 후의 시간(초)입니다. 최소값은 1입니다. 최대값은 60입니다.	정수 (int)
기간초	프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다. 최대값은 240입니다.	정수 (int)
successThreshold	실패한 후 프로브가 성공한 것으로 간주될 최소 연속 성공입니다. 기본값은 1입니다. 활동성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다. 최대값은 10입니다.	정수 (int)
tcp소켓	TCPSocket은 TCP 포트와 관련된 작업을 지정합니다. TCP 후크는 아직 지원되지 않습니다.	SessionProbeTcp소켓
종료GracePeriodSeconds	선택적 기간(초)은 프로브 실패 시 Pod가 정상적으로 종료되어야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후의 기간(초)이며 프로세스가 종료 신호로 강제로 중단되는 시간입니다. 이 값을 프로세스의 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 재정의합니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 kill 신호를 통해 즉시 중지됨을 나타냅니다(종료할 기회가 없음). 알파 필드이며 ProbeTerminationGracePeriod 기능 게이트를 사용하도록 설정해야 합니다. 최대값은 3600초(1시간)입니다.	정수 (int)
타임아웃초	프로브 시간이 초과된 후의 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 최대값은 240입니다.	정수 (int)
유형	프로브의 유형을 나타냅니다. Liveness 또는 Startup일 수 있으며, Readiness 프로브는 세션에서 지원되지 않습니다. 유형은 프로브 목록(SessionProbes)의 컨텍스트 내에서 각 프로브에 대해 고유해야 합니다.	'활기' '스타트업'

SessionProbeHttpGet을 참조하십시오.

이름	설명	가치
주최자 / 호스트	연결할 호스트 이름입니다. 기본적으로 Pod IP가 사용됩니다. 대신 httpHeaders에서 "호스트"를 설정하려고 할 것입니다.	문자열
HTTP 헤더	요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복되는 헤더를 허용합니다.	SessionProbeHttpGetHttpHeadersItem[]
길	HTTP 서버에서 액세스하는 경로입니다.	문자열
항구	컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 번호는 1에서 65535까지의 범위에 있어야 합니다. 이름은 IANA_SVC_NAME 합니다.	int(필수)
계획	호스트에 연결하는 데 사용할 체계입니다. 기본값은 HTTP입니다.	'HTTP' 'HTTPS'입니다.

SessionProbeHttpGetHttpHeaders항목

이름	설명	가치
이름	헤더 필드 이름	string(필수)
가치	헤더 필드 값	string(필수)

SessionProbeTcp소켓

이름	설명	가치
주최자 / 호스트	선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.	문자열
항구	컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 번호는 1에서 65535까지의 범위에 있어야 합니다. 이름은 IANA_SVC_NAME 합니다.	int(필수)

세션 레지스트리자격 증명

이름	설명	가치
정체성	Azure Container Registry로 인증하는 데 사용할 관리 ID입니다. 사용자 할당 ID의 경우 전체 사용자 할당 ID 리소스 ID를 사용합니다. 시스템 할당 ID의 경우 'system'을 사용합니다.	문자열
passwordSecretRef	레지스트리 로그인 암호를 포함하는 비밀의 이름입니다.	문자열
서버	컨테이너 레지스트리 서버.	문자열
사용자 이름	컨테이너 레지스트리 사용자 이름입니다.	문자열

TrackedResource태그

이름	설명	가치

UserAssignedIdentities

이름	설명	가치

사용자 할당 ID

이름	설명	가치

사용 예제

Terraform(AzAPI 공급자) 리소스 정의

sessionPools 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

리소스 그룹

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.App/sessionPools 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.App/sessionPools@2025-02-02-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      containerType = "string"
      customContainerTemplate = {
        containers = [
          {
            args = [
              "string"
            ]
            command = [
              "string"
            ]
            env = [
              {
                name = "string"
                secretRef = "string"
                value = "string"
              }
            ]
            image = "string"
            name = "string"
            probes = [
              {
                failureThreshold = int
                httpGet = {
                  host = "string"
                  httpHeaders = [
                    {
                      name = "string"
                      value = "string"
                    }
                  ]
                  path = "string"
                  port = int
                  scheme = "string"
                }
                initialDelaySeconds = int
                periodSeconds = int
                successThreshold = int
                tcpSocket = {
                  host = "string"
                  port = int
                }
                terminationGracePeriodSeconds = int
                timeoutSeconds = int
                type = "string"
              }
            ]
            resources = {
              cpu = int
              memory = "string"
            }
          }
        ]
        ingress = {
          targetPort = int
        }
        registryCredentials = {
          identity = "string"
          passwordSecretRef = "string"
          server = "string"
          username = "string"
        }
      }
      dynamicPoolConfiguration = {
        lifecycleConfiguration = {
          cooldownPeriodInSeconds = int
          lifecycleType = "string"
          maxAlivePeriodInSeconds = int
        }
      }
      environmentId = "string"
      managedIdentitySettings = [
        {
          identity = "string"
          lifecycle = "string"
        }
      ]
      poolManagementType = "string"
      scaleConfiguration = {
        maxConcurrentSessions = int
        readySessionInstances = int
      }
      secrets = [
        {
          name = "string"
          value = "string"
        }
      ]
      sessionNetworkConfiguration = {
        status = "string"
      }
    }
  }
}

속성 값

Microsoft.App/sessionPools

이름	설명	가치
정체성	코드에서 비밀 또는 자격 증명을 유지 관리하지 않기 위해 세션 풀이 다른 Azure 서비스와 상호 작용하는 데 필요한 관리 ID입니다.	ManagedServiceIdentity
위치	리소스가 있는 지리적 위치	string(필수)
이름	리소스 이름	문자열 제약 조건: 최소 길이 = 3 최대 길이 = 63 패턴 = `^[a-z][a-z0-9]*$`(필수)
속성	컨테이너 앱 세션 풀 리소스 관련 속성	세션 풀 속성
태그	리소스 태그	태그 이름 및 값의 사전입니다.
유형	리소스 종류	"Microsoft.App/sessionPools@2025-02-02-preview"

CustomContainerTemplate

이름	설명	가치
컨테이너	세션 풀의 세션에 대한 컨테이너 정의 목록입니다.	세션 컨테이너[]
입구	세션 풀 수신 구성입니다.	세션 인그레스
registry자격 증명	세션 풀의 세션에서 사용하는 컨테이너에 대한 프라이빗 컨테이너 레지스트리 자격 증명입니다.	세션 레지스트리자격 증명

DynamicPoolConfiguration

이름	설명	가치
lifecycleConfiguration	동적 세션 풀에서 세션의 수명 주기 구성	수명 주기 구성

환경 변수

이름	설명	가치
이름	환경 변수 이름입니다.	문자열
시크릿Ref	환경 변수 값을 끌어올 컨테이너 앱 비밀의 이름입니다.	문자열
가치	비밀이 아닌 환경 변수 값입니다.	문자열

수명 주기 구성

이름	설명	가치
쿨다운기간InSeconds	수명 주기 유형이 'Timed'인 세션의 쿨다운 기간(초)입니다.	정수 (int)
lifecycleType을 선택합니다.	세션 풀의 수명 주기 유형입니다.	'컨테이너 출구' '시간 초과'
maxAlivePeriodInSeconds	수명 주기 유형이 'OnContainerExit'인 경우 세션의 최대 활성 기간(초)입니다.	정수 (int)

ManagedIdentitySetting

이름	설명	가치
정체성	세션 풀에 할당된 사용자 할당 관리 ID의 리소스 ID이거나 시스템 할당 ID에 대한 '시스템'입니다.	string(필수)
수명 주기	관리 ID를 사용할 수 있어야 하는 세션 풀의 수명 주기 단계를 선택하는 데 사용합니다.	'모두' '초기화' '메인' '없음'

ManagedServiceIdentity (관리형 서비스 ID)

이름	설명	가치
유형	관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우).	'없음' '시스템 할당됨' '시스템 할당, 사용자 할당' 'UserAssigned'(필수)
userAssignedIdentities	리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다.	UserAssignedIdentities

스케일구성

이름	설명	가치
maxConcurrentSessions (최대동시 세션 수)	동시에 최대 세션 수입니다.	정수 (int)
readySession인스턴스	준비된 세션 인스턴스의 최소 수입니다.	정수 (int)

세션 컨테이너

이름	설명	가치
인수(args)	컨테이너 시작 명령 인수입니다.	문자열[]
명령어	컨테이너 시작 명령입니다.	문자열[]
환경	컨테이너 환경 변수입니다.	환경Var[]
이미지	컨테이너 이미지 태그입니다.	문자열
이름	사용자 지정 컨테이너 이름입니다.	문자열
프로브	컨테이너에 대한 프로브 목록입니다.	세션 프로브[]
리소스	컨테이너 리소스 요구 사항.	sessionContainerResources

SessionContainerResources

이름	설명	가치
cpu(cpu)	코어의 필수 CPU(예: 0.5)	정수 (int)
메모리	필요한 메모리(예: "250Mb")	문자열

세션 인그레스

이름	설명	가치
타겟 포트	수신 트래픽에 대한 컨테이너의 대상 포트	정수 (int)

세션 네트워크 구성

이름	설명	가치
상태	세션의 네트워크 상태입니다.	'송신 비활성화' '송신 활성화됨'

세션 풀 속성

이름	설명	가치
컨테이너 유형	세션의 컨테이너 형식입니다.	'사용자 지정 컨테이너' '파이썬LTS'
customContainerTemplate	containerType이 CustomContainer인 경우 사용자 지정 컨테이너 구성입니다.	CustomContainerTemplate
dynamicPoolConfiguration	poolManagementType이 동적인 경우 풀 구성입니다.	DynamicPoolConfiguration
환경 ID	세션 풀 환경의 리소스 ID입니다.	문자열
관리 아이덴티티 설정	세션 풀에 할당된 관리 ID에 대한 선택적 설정입니다.	관리신원설정[]
풀 관리 유형	세션 풀의 풀 관리 유형입니다.	'동적' '수동'
스케일구성	세션 풀의 크기 조정 구성입니다.	ScaleConfiguration
비밀	세션 풀의 비밀입니다.	세션 풀 시크릿[]
세션 네트워크 구성	세션 풀에 있는 세션의 네트워크 구성입니다.	sessionNetworkConfiguration

세션 풀시크릿

이름	설명	가치
이름	비밀 이름입니다.	문자열
가치	비밀 값입니다.	문자열 제약 조건: 중요한 값입니다. 보안 매개 변수로 전달합니다.

세션프로브

이름	설명	가치
failureThreshold	프로브를 고려할 최소 연속 실패는 성공한 후 실패했습니다. 기본값은 3입니다. 최소값은 1입니다. 최대값은 10입니다.	정수 (int)
httpGet	HTTPGet은 수행할 http 요청을 지정합니다.	SessionProbeHttpGet을 참조하십시오.
initialDelaySeconds	활동성 프로브가 시작되기 전에 컨테이너가 시작된 후의 시간(초)입니다. 최소값은 1입니다. 최대값은 60입니다.	정수 (int)
기간초	프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다. 최대값은 240입니다.	정수 (int)
successThreshold	실패한 후 프로브가 성공한 것으로 간주될 최소 연속 성공입니다. 기본값은 1입니다. 활동성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다. 최대값은 10입니다.	정수 (int)
tcp소켓	TCPSocket은 TCP 포트와 관련된 작업을 지정합니다. TCP 후크는 아직 지원되지 않습니다.	SessionProbeTcp소켓
종료GracePeriodSeconds	선택적 기간(초)은 프로브 실패 시 Pod가 정상적으로 종료되어야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후의 기간(초)이며 프로세스가 종료 신호로 강제로 중단되는 시간입니다. 이 값을 프로세스의 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 재정의합니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 kill 신호를 통해 즉시 중지됨을 나타냅니다(종료할 기회가 없음). 알파 필드이며 ProbeTerminationGracePeriod 기능 게이트를 사용하도록 설정해야 합니다. 최대값은 3600초(1시간)입니다.	정수 (int)
타임아웃초	프로브 시간이 초과된 후의 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 최대값은 240입니다.	정수 (int)
유형	프로브의 유형을 나타냅니다. Liveness 또는 Startup일 수 있으며, Readiness 프로브는 세션에서 지원되지 않습니다. 유형은 프로브 목록(SessionProbes)의 컨텍스트 내에서 각 프로브에 대해 고유해야 합니다.	'활기' '스타트업'

SessionProbeHttpGet을 참조하십시오.

이름	설명	가치
주최자 / 호스트	연결할 호스트 이름입니다. 기본적으로 Pod IP가 사용됩니다. 대신 httpHeaders에서 "호스트"를 설정하려고 할 것입니다.	문자열
HTTP 헤더	요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복되는 헤더를 허용합니다.	SessionProbeHttpGetHttpHeadersItem[]
길	HTTP 서버에서 액세스하는 경로입니다.	문자열
항구	컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 번호는 1에서 65535까지의 범위에 있어야 합니다. 이름은 IANA_SVC_NAME 합니다.	int(필수)
계획	호스트에 연결하는 데 사용할 체계입니다. 기본값은 HTTP입니다.	'HTTP' 'HTTPS'입니다.

SessionProbeHttpGetHttpHeaders항목

이름	설명	가치
이름	헤더 필드 이름	string(필수)
가치	헤더 필드 값	string(필수)

SessionProbeTcp소켓

이름	설명	가치
주최자 / 호스트	선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.	문자열
항구	컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 번호는 1에서 65535까지의 범위에 있어야 합니다. 이름은 IANA_SVC_NAME 합니다.	int(필수)

세션 레지스트리자격 증명

이름	설명	가치
정체성	Azure Container Registry로 인증하는 데 사용할 관리 ID입니다. 사용자 할당 ID의 경우 전체 사용자 할당 ID 리소스 ID를 사용합니다. 시스템 할당 ID의 경우 'system'을 사용합니다.	문자열
passwordSecretRef	레지스트리 로그인 암호를 포함하는 비밀의 이름입니다.	문자열
서버	컨테이너 레지스트리 서버.	문자열
사용자 이름	컨테이너 레지스트리 사용자 이름입니다.	문자열

TrackedResource태그

이름	설명	가치

UserAssignedIdentities

이름	설명	가치

사용자 할당 ID

이름	설명	가치

다음을 통해 공유

Microsoft.App sessionPools

Bicep 리소스 정의

리소스 형식

속성 값

Microsoft.App/sessionPools

CustomContainerTemplate

DynamicPoolConfiguration

환경 변수

수명 주기 구성

ManagedIdentitySetting

ManagedServiceIdentity (관리형 서비스 ID)

스케일구성

세션 컨테이너

SessionContainerResources

세션 인그레스

세션 네트워크 구성

세션 풀 속성

세션 풀시크릿

세션프로브

SessionProbeHttpGet을 참조하십시오.

SessionProbeHttpGetHttpHeaders항목

SessionProbeTcp소켓

세션 레지스트리자격 증명

TrackedResource태그

UserAssignedIdentities

사용자 할당 ID

사용 예제

Azure 확인된 모듈

ARM 템플릿 리소스 정의

리소스 형식

속성 값

Microsoft.App/sessionPools

CustomContainerTemplate

DynamicPoolConfiguration

환경 변수

수명 주기 구성

ManagedIdentitySetting

ManagedServiceIdentity (관리형 서비스 ID)

스케일구성

세션 컨테이너

SessionContainerResources

세션 인그레스

세션 네트워크 구성

세션 풀 속성

세션 풀시크릿

세션프로브

SessionProbeHttpGet을 참조하십시오.

SessionProbeHttpGetHttpHeaders항목

SessionProbeTcp소켓

세션 레지스트리자격 증명

TrackedResource태그

UserAssignedIdentities

사용자 할당 ID

사용 예제

Terraform(AzAPI 공급자) 리소스 정의

리소스 형식

속성 값

Microsoft.App/sessionPools

CustomContainerTemplate

DynamicPoolConfiguration

환경 변수

수명 주기 구성

ManagedIdentitySetting

ManagedServiceIdentity (관리형 서비스 ID)

스케일구성

세션 컨테이너

SessionContainerResources

세션 인그레스

세션 네트워크 구성

세션 풀 속성

세션 풀시크릿

세션프로브

SessionProbeHttpGet을 참조하십시오.

SessionProbeHttpGetHttpHeaders항목

SessionProbeTcp소켓

세션 레지스트리자격 증명

TrackedResource태그

UserAssignedIdentities

사용자 할당 ID