Azure Logic Apps에서 상태 비저장 기본 제공 커넥터에 대해 상태 저장 모드를 사용하도록 설정합니다.

아티클
07/06/2024

적용 대상: Azure Logic Apps(표준)

표준 논리 앱 워크플로에서 다음과 같은 기본 제공 서비스 공급자 기반 커넥터는 기본적으로 상태 비저장입니다.

Azure Service Bus
SAP
IBM MQ

상태 저장 모드에서 이러한 커넥터 작업을 실행하려면 이 기능을 사용하도록 설정해야 합니다. 이 방법 가이드에서는 이러한 커넥터에 대해 상태 저장 모드를 사용하도록 설정하는 방법을 보여 줍니다.

필수 조건

Azure 계정 및 구독 구독이 없는 경우 Azure 체험 계정에 등록합니다.
상태 저장 모드 지원 커넥터 작업을 사용하는 워크플로를 만들려는 표준 논리 앱 리소스입니다. 이 리소스가 없으면 지금 표준 논리 앱 리소스를 만듭니다.
논리 앱과 통합할 서브넷이 있는 Azure Virtual Network입니다. 이러한 항목이 없으면 다음 설명서를 참조하세요.
- 빠른 시작: Azure Portal을 사용하여 가상 네트워크 만들기
- 가상 네트워크 서브넷 추가, 변경 또는 삭제

Azure Portal에서 상태 저장 모드 사용

참고 항목

가상 네트워크에서 네트워크 보안 그룹을 사용하는 경우 상태 저장 모드를 사용하려면 포트 20,000~30,000을 열어 야 합니다.

Azure Portal에서 이러한 커넥터 작업에 대해 상태 저장 모드를 사용하도록 설정하려는 표준 논리 앱 리소스를 엽니다.
논리 앱에 대한 가상 네트워크 통합을 사용하도록 설정하고 이전에 만든 서브넷에 논리 앱을 추가하려면 다음 단계를 수행합니다.
1. 논리 앱 메뉴 리소스의 설정에서 네트워킹을 선택합니다.
2. 아웃바운드 트래픽 구성 섹션에서 가상 네트워크 통합 옆에 있는 구성되지 않음>가상 네트워크 통합 추가를 선택합니다.
3. 열리는 가상 네트워크 통합 추가 창에서 Azure 구독과 가상 네트워크를 선택합니다.
4. 서브넷 목록에서 논리 앱을 추가하려는 서브넷을 선택합니다.
5. 완료되면 연결을 선택하고 네트워킹 페이지로 돌아갑니다.
  
  이제 가상 네트워크 통합 속성이 선택한 가상 네트워크 및 서브넷으로 설정됩니다. 예를 들면 다음과 같습니다.
앱과 가상 네트워크 통합 사용하도록 설정에 대한 일반적인 정보는 Azure App Service에서 가상 네트워크 통합 사용을 참조하세요.
다음으로, 다음 도구 중 하나를 사용하여 논리 앱의 기본 웹 사이트 구성(<logic-app-name>.azurewebsites.net))을 업데이트합니다.

논리 앱에 대한 웹 사이트 구성 업데이트

논리 앱에 대해 가상 네트워크 통합을 사용하도록 설정한 후에는 다음 방법 중 하나를 사용하여 논리 앱의 기본 웹 사이트 구성(<logic-app-name>.azurewebsites.net)을 업데이트해야 합니다.

Azure Portal(전달자 토큰이 필요하지 않음)
Azure Resource 관리 API(전달자 토큰 필요)
Azure PowerShell(전달자 토큰이 필요하지 않음)

Azure Portal

Azure Portal을 사용하여 가상 네트워크 프라이빗 포트를 구성하려면 다음 단계를 따릅니다.

Azure Portal에서 표준 논리 앱 리소스를 찾아서 엽니다.
논리 앱 메뉴의 설정에서 구성을 선택합니다.
구성 페이지에서 일반 설정을 선택합니다.
플랫폼 설정 아래의 VNet 프라이빗 포트 상자에 사용하려는 포트를 입력합니다.

Azure 리소스 관리 API

Azure Resource 관리 API - ID별 업데이트를 사용하여 이 작업을 완료하려면 다음 요구 사항, 구문 및 매개 변수 값을 검토합니다.

요구 사항

OAuth 권한 부여 및 전달자 토큰이 필요합니다. 전달자 토큰을 가져오려면 다음 단계를 따릅니다.

Azure Portal에 로그인한 상태에서 웹 브라우저의 개발자 도구(F12)를 엽니다.
예를 들어, 표준 논리 앱에 워크플로를 저장하여 관리 요청을 보내 토큰을 가져옵니다.

구문

지정된 리소스 ID를 사용하여 리소스를 업데이트합니다.

PATCH https://management.azure.com/{resourceId}?api-version=2021-04-01

매개 변수 값

요소	값
HTTP 요청 메서드	패치
<resourceId>	subscriptions/{yourSubscriptionID}/resourcegroups/{yourResourceGroup}/providers/Microsoft.Web/sites/{websiteName}/config/web
<yourSubscriptionId>	Azure 구독의 ID
<yourResourceGroup>	논리 앱 리소스를 포함하는 리소스 그룹
<websiteName>	논리 앱 리소스의 이름(이 예에서는 mystandardlogicapp)
HTTP 요청 본문	{"properties": {"vnetPrivatePortsCount": "2"}}

예시

https://management.azure.com/subscriptions/XXxXxxXX-xXXx-XxxX-xXXX-XXXXxXxXxxXX/resourcegroups/My-Standard-RG/providers/Microsoft.Web/sites/mystandardlogicapp/config/web?api-version=2021-02-01

Azure PowerShell

Azure PowerShell을 사용하여 이 작업을 완료하려면 다음 요구 사항, 구문 및 값을 검토합니다. 이 방법에서는 전달자 토큰을 수동으로 가져올 필요가 없습니다.

구문

Set-AzContext -Subscription {yourSubscriptionID}
$webConfig = Get-AzResource -ResourceId {resourceId}
$webConfig.Properties.vnetPrivatePortsCount = 2
$webConfig | Set-AzResource -ResourceId {resourceId}

자세한 내용은 다음 설명서를 참조하세요.

매개 변수 값

요소	값
<yourSubscriptionID>	Azure 구독의 ID
<resourceId>	subscriptions/{yourSubscriptionID}/resourcegroups/{yourResourceGroup}/providers/Microsoft.Web/sites/{websiteName}/config/web
<yourResourceGroup>	논리 앱 리소스를 포함하는 리소스 그룹
<websiteName>	논리 앱 리소스의 이름(이 예에서는 mystandardlogicapp)

예시

https://management.azure.com/subscriptions/XXxXxxXX-xXXx-XxxX-xXXX-XXXXxXxXxxXX/resourcegroups/My-Standard-RG/providers/Microsoft.Web/sites/mystandardlogicapp/config/web?api-version=2021-02-01

오류 문제 해결

오류: 예약 인스턴스 수가 잘못되었습니다.

예약 인스턴스 수가 잘못되었습니다라는 오류가 발생하는 경우 다음 해결 방법을 사용합니다.

$webConfig.Properties.preWarmedInstanceCount = $webConfig.Properties.reservedInstanceCount
$webConfig.Properties.reservedInstanceCount = $null
$webConfig | Set-AzResource -ResourceId {resourceId}

오류 예:

Set-AzResource :
{
   "Code":"BadRequest",
   "Message":"siteConfig.ReservedInstanceCount is invalid.  Please use the new property siteConfig.PreWarmedInstanceCount.",
   "Target": null,
   "Details":
   [
      {
         "Message":"siteConfig.ReservedInstanceCount is invalid. Please use the new property siteConfig.PreWarmedInstanceCount."
      },
      {
         "Code":"BadRequest"
      },
      {
         "ErrorEntity":
         {
            "ExtendedCode":"51021",
            "MessageTemplate":"{0} is invalid. {1}",
            "Parameters":
            [
               "siteConfig.ReservedInstanceCount", "Please use the new property siteConfig.PreWarmedInstanceCount."
            ],
            "Code":"BadRequest",
            "Message":"siteConfig.ReservedInstanceCount is invalid. Please use the new property siteConfig.PreWarmedInstanceCount."
         }
      }
   ],
   "Innererror": null
}

리소스 스케일 인 이벤트 중 컨텍스트 손실 방지

리소스 스케일 인 이벤트로 인해 상태 저장 모드가 사용하도록 설정된 기본 제공 커넥터에 대한 컨텍스트가 손실될 수 있습니다. 이러한 이벤트가 발생하기 전에 이러한 잠재적인 손실을 방지하려면 논리 앱 리소스에 사용할 수 있는 인스턴스 수를 수정합니다. 이렇게 하면 잠재적인 컨텍스트 손실을 유발하는 스케일 인 이벤트가 발생하지 않습니다.

논리 앱 리소스 메뉴의 설정에서 스케일 아웃을 선택합니다.
스케일 아웃 페이지의 앱 규모 스케일 아웃 섹션에서 다음 단계를 따릅니다.
1. 스케일 아웃 한도 적용을 예로 설정하면 최대 스케일 아웃 한도가 표시됩니다.
2. 항상 준비된 인스턴스를 계획 스케일 아웃 섹션에 표시되는 최대 스케일 아웃 한도 및 최대 버스트와 동일한 숫자로 설정합니다. 예를 들면 다음과 같습니다.
완료되면 스케일 아웃 도구 모음에서 저장을 선택합니다.

다음을 통해 공유

Azure Logic Apps에서 상태 비저장 기본 제공 커넥터에 대해 상태 저장 모드를 사용하도록 설정합니다.

필수 조건

Azure Portal에서 상태 저장 모드 사용

논리 앱에 대한 웹 사이트 구성 업데이트

Azure Portal

Azure 리소스 관리 API

요구 사항

구문

매개 변수 값

예시

Azure PowerShell

구문

매개 변수 값

예시

오류 문제 해결

오류: 예약 인스턴스 수가 잘못되었습니다.

리소스 스케일 인 이벤트 중 컨텍스트 손실 방지

다음 단계

피드백

추가 리소스