단일 테넌트 Azure Logic Apps에서 표준 논리 앱의 호스트 및 앱 설정 편집

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

단일 테넌트 Azure Logic Apps에서 표준 논리 앱의 앱 설정에는 해당 논리 앱의 모든 워크플로에 영향을 주는 글로벌 구성 옵션을 지정합니다. 단, 이 설정은 로컬 개발 환경에서 이러한 워크플로가 실행될 때에만 적용됩니다. 로컬에서 실행 중인 워크플로는 로컬 환경 변수로 이러한 앱 설정에 액세스할 수 있으며, 이는 환경 간에 자주 변경될 수 있는 값의 로컬 개발 도구에서 사용됩니다. 예를 들어 이러한 값에는 연결 문자열이 포함될 수 있습니다. Azure에 배포할 경우 앱 설정은 무시되며 배포에 포함되지 않습니다.

또한 논리 앱에는 해당 논리 앱의 모든 워크플로에 적용되는 런타임 구성 설정 및 값을 지정하는 호스트 설정도 있습니다(예: 처리량, 용량, 데이터 크기 등의 기본값, 로컬에서 또는 Azure에서 실행되는지 여부).

앱 설정, 매개 변수 및 배포

다중 테넌트 Azure Logic Apps에서 배포는 논리 앱과 인프라 둘 다에 대한 리소스 프로비전을 결합하고 처리하는 ARM 템플릿(Azure Resource Manager 템플릿)을 바탕으로 합니다. 이 설계는 다양한 개발, 테스트 및 프로덕션 환경에서 논리 앱의 환경 변수를 유지 관리해야 할 때 문제가 됩니다. ARM 템플릿의 모든 항목은 배포 시 정의됩니다. 따라서 한 가지 변수만 변경해야 하더라도 모든 항목을 다시 배포해야 합니다.

단일 테넌트 Azure Logic Apps에서는 앱과 인프라 간에 리소스 프로비전을 구분할 수 있으므로 배포가 더 쉬워집니다. 매개 변수를 사용하여 환경 간에 바뀔 수 있는 값을 추출할 수 있습니다. 워크플로에서 사용할 매개 변수를 정의하면 먼저 워크플로 설계에 집중하고 나중에 환경별 변수를 삽입할 수 있습니다. 앱 설정 및 매개 변수를 사용하면 런타임에서 환경 변수를 호출하고 참조할 수 있습니다. 이렇게 하면 자주 다시 배포할 필요가 없습니다.

앱 설정은 Azure Key Vault와 통합됩니다. 연결 문자열 및 키와 같은 보안 문자열을 직접 참조할 수 있습니다. 배포 시 환경 변수를 정의할 수 있는 ARM 템플릿(Azure Resource Manager 템플릿)과 마찬가지로 논리 앱 워크플로 정의 내에서 앱 설정을 정의할 수 있습니다. 그런 다음, 연결 엔드포인트, 스토리지 문자열 등 동적으로 생성된 인프라 값을 캡처할 수 있습니다. 단, 앱 설정에는 크기 제한이 있으며 Azure Logic Apps의 특정 영역에서는 참조가 불가능합니다.

배포를 위한 논리 앱 설정에 대한 자세한 내용은 다음 설명서를 참조하세요.

• 환경마다 워크플로에서 바뀌는, 단일 테넌트 Azure Logic Apps 값에 대한 매개 변수 만들기
• 단일 테넌트 기반 논리 앱에 대한 DevOps 배포 개요
• 단일 테넌트 기반 논리 앱에 대한 DevOps 배포 설정

Visual Studio Code 프로젝트 구조

Visual Studio Code에서 논리 앱 프로젝트에는 다음 형식 중 하나가 있습니다.

• 기본 형식인 확장 번들 기반(Node.js)
• 기본 형식에서 변환할 수 있는 NuGet 패키지 기반(.NET)

이러한 형식에 따라 프로젝트에는 약간 다른 폴더와 파일이 포함됩니다. NuGet 기반 프로젝트에는 패키지 및 기타 라이브러리 파일이 포함된 .bin 폴더가 포함되어 있습니다. 번들 기반 프로젝트에는 .bin 폴더 및 기타 파일이 포함되지 않습니다. 일부 시나리오에서는 사용자 지정 기본 제공 작업을 개발하고 실행하려는 경우와 같이 앱을 실행하기 위해 NuGet 기반 프로젝트가 필요합니다. NuGet을 사용하도록 프로젝트를 변환하는 방법을 자세히 알아보려면 기본 제공 커넥터 작성 사용을 검토하세요.

기본 번들 기반 프로젝트의 경우 프로젝트에는 다음 예제와 유사한 폴더 및 파일 구조가 있습니다.

MyBundleBasedLogicAppProjectName
| .vscode
| Artifacts
  || Maps 
     ||| MapName1
     ||| ...
  || Schemas
     ||| SchemaName1
     ||| ...
| WorkflowName1
  || workflow.json
  || ...
| WorkflowName2
  || workflow.json
  || ...
| workflow-designtime
| .funcignore
| connections.json
| host.json
| local.settings.json

프로젝트의 루트 수준에서 다른 항목이 있는 다음 파일 및 폴더를 찾을 수 있습니다.

앱 설정 참조 - local.settings.json

Visual Studio Code의 논리 앱 프로젝트의 루트 수준에서 local.settings.json 파일에는 로컬 개발 환경에서 실행되는 동안 해당 논리 앱의 모든 워크플로에 영향을 주는 전역 구성 옵션이 포함됩니다. 워크플로가 로컬에서 실행될 때 이러한 설정은 로컬 환경 변수로 액세스되며, 워크플로를 실행하는 다양한 환경 간에 해당 값이 바뀔 수 있습니다. 이러한 설정을 보고 관리하려면 앱 설정 관리 - local.settings.json을 참조하세요.

Azure Logic Apps의 앱 설정은 Azure Functions 또는 Azure Web Apps의 앱 설정과 유사하게 작동합니다. 이러한 다른 서비스를 이전에 사용한 적이 있다면 앱 설정에 이미 익숙할 수 있습니다. 자세한 내용은 Azure Functions의 앱 설정 참조 및 Azure Functions Core Tools 작업 - 로컬 설정 파일을 참조하세요.

워크플로가 제대로 실행되려면 일부 앱 설정이 필요합니다.

앱 설정 관리 - local.settings.json

앱 설정을 추가, 업데이트 또는 삭제하려면 Azure Portal, Visual Studio Code, Azure CLI 또는 ARM(Bicep) 템플릿에 대한 다음 섹션을 선택하고 검토합니다. 논리 앱별 앱 설정은 사용할 수 있는 앱 설정에 대한 참조 가이드 - local.settings.json을 참조하세요.

az logicapp config appsettings list --name MyLogicApp --resource-group MyResourceGroup

az logicapp config appsettings set --name MyLogicApp --resource-group MyResourceGroup --settings CUSTOM_LOGIC_APP_SETTING=12345 

호스트 설정에 대한 참조 - host.json

Visual Studio Code에서는 논리 앱 프로젝트의 루트 수준에서 host.json 메타데이터 파일에 로컬에서 또는 Azure에서 실행하든 관계 없이 논리 앱 리소스의 모든 워크플로에 적용되는 런타임 설정 및 기본값이 포함됩니다. 이러한 설정을 보고 관리하려면 호스트 설정 관리 - host.json을 참조하세요. 또한 Azure Logic Apps 설명서의 제한 및 구성에서 관련 제한 정보를 확인할 수 있습니다.

작업 오케스트레이션 처리량

다음 설정은 단일 테넌트 Azure Logic Apps에서 워크플로 작업을 실행할 때의 처리량 및 용량에 영향을 미칩니다.

다음 설정은 모두 표준 논리 앱에서 지정된 워크플로를 수동으로 중지하고 즉시 삭제하는 데 사용됩니다.

다음 예에서는 각 워크플로 ID 뒤에 콜론(:)이 오고 세미콜론(;)으로 구분되는 이러한 설정의 구문을 보여 줍니다.

"Jobs.CleanupJobPartitionPrefixes": "<workflow-ID-1>:; <workflow-ID-2:",
"Jobs.SuspendedJobPartitionPrefixes": "<workflow-ID-1>:; <workflow-ID-2>:"

되풀이 기반 트리거

트리거 동시 실행

다음 설정은 기본 제공된 서비스 공급자 기반 커넥터에 대한 되풀이 기반 트리거로 시작하는 워크플로에만 적용됩니다. 함수 기반 트리거로 시작하는 워크플로의 경우 지원되는 경우 일괄 처리를 설정해 볼 수 있습니다. 그러나 일괄 처리가 항상 올바른 솔루션은 아닙니다. 예를 들어, Azure Service Bus 트리거를 사용하면 일괄 처리에서 잠금 기간이 지난 메시지를 보관할 수 있습니다. 결과적으로 해당 메시지에서는 완료 또는 포기와 같은 모든 작업이 실패합니다.

실행 기간 및 기록 보존

동작 실행

입력 및 출력

페이지 매김

청크

콘텐츠를 인라인으로 저장하거나 Blob 사용

for each 루프

until 루프

variables

기본 제공 HTTP 작업

기본 제공 HTTP 웹후크 작업

기본 제공 Azure Storage 작업

Blob Storage

테이블 및 큐 스토리지

파일 공유

기본 제공 Azure Functions 작업

기본 제공 Azure Service Bus 작업

기본 제공 SFTP 작업

관리형 커넥터 작업

다른 모든 작업에 대한 다시 시도 정책

제한 사항

• 최대 콘텐츠 크기

  기본적으로 HTTP 또는 요청과 같은 기본 제공 트리거는 한도 및 구성 참조 - 메시지에 설명된 메시지 크기로 제한됩니다. 한도보다 큰 파일을 처리하려면 콘텐츠를 Azure Blob Storage에 Blob으로 업로드한 다음 Azure Blob 커넥터를 사용하여 콘텐츠를 가져옵니다.

호스트 설정 관리 - host.json

또한 해당 논리 앱의 모든 워크플로에 적용되는 런타임 구성 설정 및 값을 지정하는 호스트 설정을 추가, 업데이트 또는 삭제할 수 있습니다(예: 처리량, 용량, 데이터 크기 등의 기본값, 로컬에서 또는 Azure에서 실행되는지 여부). 논리 앱별 호스트 설정은 사용할 수 있는 런타임 및 배포 설정에 대한 참조 가이드 - host.json을 참조하세요.

Azure Portal - host.json

Azure Portal에서 단일 테넌트 기반 논리 앱의 호스트 설정을 검토하려면 다음 단계를 수행합니다.

1. Azure Portal 검색 상자에서 논리 앱을 찾아 선택합니다.

2. 리소스 메뉴의 개발 도구에서 고급 도구를 선택합니다.

3. 고급 도구 창에서 Go를 선택합니다. 그러면 논리 앱에 대한 Kudu 환경이 열립니다.

4. Kudu 도구 모음에서 디버그 콘솔 메뉴를 열고 CMD를 선택합니다.

   명령 프롬프트를 사용하여 wwwroot 폴더로 이동할 수 있도록 콘솔 창이 열립니다. 또는 콘솔 창 위에 표시된 디렉터리 구조를 찾아볼 수도 있습니다.

5. wwwroot 폴더의 경로 ...\home\site\wwwroot에서 찾아봅니다.

6. 콘솔 창 위의 디렉터리 테이블에서 host.json 파일 옆에 있는 편집을 선택합니다.

7. host.json 파일이 열리면 이전에 논리 앱에 추가된 모든 호스트 설정을 검토합니다.

   호스트 설정에 대한 자세한 내용은 사용할 수 있는 호스트 설정에 대한 참조 가이드 - host.json을 참조하세요.

설정을 추가하려면 다음 단계를 수행합니다.

1. 설정을 추가하거나 편집하기 전에 Azure Portal에서 논리 앱을 중지합니다.

   1. 리소스 메뉴에서 개요를 선택합니다.

   2. 개요 창의 도구 모음에서 중지를 선택합니다.

2. host.json 파일이 이미 열려 있으면 host.json 파일로 돌아갑니다. 그렇지 않으면 이전 단계에 따라 host.json 파일을 엽니다.

3. extensionBundle 개체 아래에 workflow 및 settings 개체를 포함하는 extensions 개체를 추가합니다. 예를 들면 다음과 같습니다.

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
            }
         }
      }
   }
   

4. settings 개체에서 논리 앱의 모든 워크플로에 사용하려는 호스트 설정이 포함된 플랫 목록을 추가합니다. 이러한 워크플로는 로컬에서 또는 Azure에서 실행됩니다. 예를 들면 다음과 같습니다.

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
               "Runtime.Trigger.MaximumWaitingRuns": "100"
            }
         }
      }
   }
   

5. 완료되었으면 논리 앱을 저장해야 합니다.

6. 이제 논리 앱을 다시 시작합니다. 논리 앱의 개요 페이지로 돌아가서 다시 시작을 선택합니다.

Visual Studio Code - host.json

Visual Studio Code에서 논리 앱의 호스트 설정을 검토하려면 다음 단계를 수행합니다.

1. 논리 앱 프로젝트의 루트 프로젝트 수준에서 host.json 파일을 찾아 엽니다.

2. extensions 개체의 workflows 및 settings 아래에서 논리 앱에 대해 이전에 추가된 호스트 설정을 검토합니다. 그렇지 않으면 extensions 개체가 파일에 표시되지 않습니다.

   호스트 설정에 대한 자세한 내용은 사용할 수 있는 호스트 설정에 대한 참조 가이드 - host.json을 참조하세요.

호스트 설정을 추가하려면 다음 단계를 수행합니다.

1. host.json 파일의 extensionBundle 개체 아래에 workflow 및 settings 개체를 포함하는 extensions 개체를 추가합니다. 예를 들면 다음과 같습니다.

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
            }
         }
      }
   }
   

2. settings 개체에서 논리 앱의 모든 워크플로에 사용하려는 호스트 설정이 포함된 플랫 목록을 추가합니다. 이러한 워크플로는 로컬에서 또는 Azure에서 실행됩니다. 예를 들면 다음과 같습니다.

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
               "Runtime.Trigger.MaximumWaitingRuns": "100"
            }
         }
      }
   }
   

다음 단계

• 환경마다 워크플로에서 바뀌는, 단일 테넌트 Azure Logic Apps 값에 대한 매개 변수 만들기
• 단일 테넌트 Azure Logic Apps의 DevOps 배포 설정