Azure Logic Apps의 워크플로에서 SFTP 파일 서버에 연결
적용 대상: Azure Logic Apps(사용량 + 표준)
이 방법 가이드에서는 Azure Logic Apps의 워크플로에서 SFTP(SSH 파일 전송 프로토콜) 서버에 액세스하는 방법을 보여 줍니다. SFTP는 신뢰할 수 있는 데이터 스트림을 통해 파일 액세스, 파일 전송, 파일 관리를 제공하고 SSH(보안 셸) 프로토콜을 사용하는 네트워크 프로토콜입니다.
소비 논리 앱 워크플로에서는 SFTP-SSH관리형 커넥터를 사용할 수 있지만 표준 논리 앱 워크플로에서는 SFTP 기본 제공 커넥터 또는 SFTP-SSH 관리형 커넥터를 사용할 수 있습니다. 이러한 커넥터 작업을 사용하여 FTP 서버 또는 다른 시스템의 이벤트에 의해 트리거될 때 실행되는 자동화된 워크플로를 만들고 FTP 서버에서 작업을 실행하여 파일을 관리할 수 있습니다. 관리형 커넥터와 기본 제공 커넥터 모두 SSH 프로토콜을 사용합니다.
참고 항목
SFTP관리형 커넥터는 더 이상 사용되지 않으므로 이 커넥터의 작업이 워크플로 디자이너에 더 이상 표시되지 않습니다.
예를 들어 워크플로는 SFTP 서버의 이벤트를 모니터링하고 응답하는 SFTP 트리거로 시작할 수 있습니다. 트리거를 사용하면 워크플로의 후속 작업에 출력을 사용할 수 있습니다. 워크플로는 SFTP 서버 계정을 통해 파일을 가져와서 만들고 관리하는 SFTP 작업을 실행할 수 있습니다. 다음 목록에는 더 많은 예제 작업이 포함되어 있습니다.
- 파일이 추가되거나 변경될 때 모니터링합니다.
- 파일 가져오기/만들기/복사/이름 바꾸기/업데이트/나열/삭제를 수행합니다.
- 폴더를 만듭니다.
- 파일 콘텐츠 및 메타데이터를 가져옵니다.
- 보관을 폴더로 추출합니다.
다음 단계에서는 Azure Portal을 사용합니다. 그러나 적절한 Azure Logic Apps 확장이 있으면 다음 도구를 사용하여 논리 앱 워크플로를 만들고 편집할 수도 있습니다.
사용량 논리 앱 워크플로: Visual Studio 또는 Visual Studio Code
표준 논리 앱 워크플로: Visual Studio Code
커넥터 기술 참조
SFTP 커넥터는 논리 앱 유형 및 호스트 환경에 따라 여러 버전이 있습니다.
| 논리 앱 유형(계획) | 환경 | 커넥터 버전 |
|---|---|---|
| 소비 | 다중 테넌트 Azure Logic Apps | 디자이너에서 표준 레이블 아래에 표시되는 관리형 커넥터. 자세한 내용은 다음 설명서를 검토하세요. - SFTP-SSH 관리형 커넥터 참조 - Azure Logic Apps의 관리형 커넥터 |
| 소비 | ISE(통합 서비스 환경) | 표준 레이블 아래 디자이너에 표시되는 관리형 커넥터 및 ISE 레이블이 있는 디자이너에 표시되고 관리형 커넥터와 메시지 제한이 다른 ISE 버전 자세한 내용은 다음 설명서를 검토하세요. - SFTP-SSH 관리형 커넥터 참조 - ISE 메시지 제한 - Azure Logic Apps의 관리형 커넥터 |
| Standard | 단일 테넌트 Azure Logic Apps 및 App Service Environment v3(Windows 플랜만 해당) | 런타임>공유 아래의 커넥터 갤러리에 표시되는 관리형 커넥터 및 런타임>앱 내의 커넥터 갤러리에 표시되고 서비스 공급자 기반인 기본 제공 커넥터. 기본 제공 커넥터는 온-프레미스 데이터 게이트웨이 없이 연결 문자열을 사용하여 SFTP 서버에 직접 연결하고 Azure 가상 네트워크에 액세스할 수 있습니다. 자세한 내용은 다음 설명서를 검토하세요. - SFTP-SSH 관리형 커넥터 참조 - SFTP 기본 제공 커넥터 참조 - Azure Logic Apps의 관리형 커넥터 - Azure Logic Apps의 기본 제공 커넥터 |
일반적인 제한 사항
SFTP-SSH 관리형 커넥터를 사용하기 전에 SFTP-SSH 관리형 커넥터 참조의 알려진 문제 및 제한 사항을 검토합니다.
SFTP 기본 제공 커넥터를 사용하기 전에 SFTP 기본 제공 커넥터 참조의 알려진 문제 및 제한 사항을 검토합니다.
알려진 문제
기본적으로 배열을 반환하는 트리거에는 이미 사용하도록 설정된 분할 켜기 설정이 있습니다. 이 설정을 사용하도록 설정하면 트리거는 내부적으로 각 배열 항목을 처리하는 별도의 워크플로 인스턴스를 만들어 배열을 자동으로 분리합니다. 모든 워크플로 인스턴스는 병렬로 실행되므로 배열 항목이 동시에 처리됩니다.
그러나 분할 켜기 설정을 사용하도록 설정하면 관리형 커넥터 트리거는 모든 배열 항목에 대한 출력을 목록으로 반환합니다. 이러한 출력을 참조하는 후속 작업은 먼저 이러한 출력을 목록으로 처리해야 합니다. 각 배열 항목을 개별적으로 처리하기 위해 다른 작업을 추가할 수 있습니다. 예를 들어 이러한 배열 항목을 반복하려면 For each 루프를 사용할 수 있습니다. 메타데이터 또는 속성만 반환하는 트리거의 경우 먼저 배열 항목의 메타데이터를 가져오는 작업을 사용한 다음, 작업을 사용하여 항목 콘텐츠를 가져옵니다.
분할 켜기 설정을 사용할 때 한 번에 하나의 배열 항목에 대한 출력을 반환하는 기본 제공 커넥터 트리거가 아닌 관리형 커넥터 트리거에 대해서만 이 방법을 적용해야 합니다.
예를 들어 새 파일 또는 업데이트된 파일에 대한 메타데이터 또는 속성을 배열로 반환하는 파일이 추가되거나 수정될 때(속성만)라는 관리형 커넥터 트리거가 있다고 가정해 보겠습니다. 각 파일에 대해 메타데이터를 별도로 가져오기 위해 배열을 반복하는 For each 루프를 사용할 수 있습니다. 이 루프에서는 다음 관리형 커넥터 작업을 지정된 순서로 사용합니다.
각 파일의 메타데이터를 가져오는 파일 메타데이터 가져오기
각 파일의 콘텐츠를 가져오는 파일 콘텐츠 가져오기 작업
청크
SFTP-SSH 관리형 커넥터가 기본 크기 제한을 초과하는 대용량 파일을 처리하는 방법에 대한 자세한 내용은 SFTP-SSH 관리형 커넥터 참조 - 청크를 참조하세요.
필수 조건
Azure 계정 및 구독 Azure 구독이 없는 경우 체험 Azure 계정에 등록합니다.
예: 서버 주소, 계정 자격 증명, SSH 프라이빗 키에 대한 액세스, SSH 프라이빗 키 암호 등 SFTP 서버에 액세스하기 위한 연결 및 인증 정보 자세한 내용은 SFTP-SSH 관리 커넥터 참조 - 인증 및 권한을 참조하세요.
Important
연결을 만들고 SSH 프라이빗 키 속성에 SSH 프라이빗 키를 입력하는 경우 이 속성에 대한 완전하고 올바른 값을 제공하는 단계를 수행해야 합니다. 그렇지 않으면, 유효하지 않은 키로 인해 연결에 실패합니다.
SFTP 계정에 액세스하려는 논리 앱 워크플로. SFTP-SSH 트리거를 사용하여 시작하려면 빈 워크플로로 시작해야 합니다. SFTP-SSH 작업을 사용하려면 되풀이 트리거와 같은 다른 트리거를 통해 워크플로를 시작합니다.
SFTP 트리거 추가
Azure Portal의 디자이너에서 빈 워크플로를 사용하여 사용량 논리 앱을 엽니다.
메시지가 표시되면 필요한 연결 정보를 제공합니다. 완료되면 만들기를 선택합니다.
트리거 정보 상자가 나타나면 선택한 트리거의 필요한 세부 정보를 입력합니다. 자세한 내용은 SFTP-SSH 관리형 커넥터 트리거 참조를 참조하세요.
완료되면 워크플로를 저장합니다. 디자이너 도구 모음에서 저장을 선택합니다.
워크플로를 저장하면 이 단계는 Azure에 있는 배포된 논리 앱에 업데이트 내용을 자동으로 게시합니다. 트리거만 있으면 워크플로는 지정된 일정에 따라 FTP 서버를 확인합니다. 트리거에 응답하고 트리거 출력을 사용하여 수행하는 작업을 추가해야 합니다.
파일이 추가되거나 수정되는 경우라는 트리거는 SFTP 서버에서 파일이 추가되거나 변경되면 워크플로를 시작합니다. 후속 작업으로 파일 콘텐츠가 지정된 조건을 충족하는지 여부를 확인하는 조건을 추가할 수 있습니다. 콘텐츠가 조건을 충족하는 경우 파일 콘텐츠 가져오기라는 작업을 사용하여 파일 콘텐츠를 가져온 다음, 다른 동작을 사용하여 해당 파일 콘텐츠를 SFTP 서버의 다른 폴더에 배치할 수 있습니다.
SFTP 작업 추가
SFTP 작업을 사용하려면 먼저 워크플로가 이미 트리거로 시작해야 합니다. 이 트리거는 원하는 종류일 수 있습니다. 예를 들어 일반 되풀이 기본 제공 트리거를 사용하여 특정 일정에 따라 워크플로를 시작할 수 있습니다.
Azure Portal의 디자이너에서 워크플로를 사용하여 사용량 논리 앱을 엽니다.
메시지가 표시되면 필요한 연결 정보를 제공합니다. 완료되면 만들기를 선택합니다.
작업 정보 상자가 나타나면 선택한 작업의 필요한 세부 정보를 입력합니다. 자세한 내용은 SFTP-SSH 관리형 커넥터 작업 참조를 참조하세요.
완료되면 워크플로를 저장합니다. 디자이너 도구 모음에서 저장을 선택합니다.
예를 들어 경로를 사용하여 파일 콘텐츠 가져오기라는 작업은 파일 경로를 지정하여 SFTP 서버의 파일에서 콘텐츠를 가져옵니다. 이전 예제의 트리거와 파일의 콘텐츠가 충족해야 하는 조건을 사용할 수 있습니다. 조건이 true이면 후속 작업을 통해 콘텐츠를 가져올 수 있습니다.
문제 해결
자세한 내용은 다음 설명서를 참조하세요.