태스크 러너

태스크 러너는 안전하고 성능이 우수한 방식으로 태스크를 실행하기 위한 범용 메커니즘입니다. Code node 에서 사용자가 제공한 JavaScript 및 Python 코드를 실행하는 데 사용됩니다. 이 문서에서는 태스크 러너의 작동 방식과 구성 방법을 설명합니다. Warning 내부 모드는 프로덕션 환경에 권장되지 않습니다 프로덕션 환경에서 내부 모드를 사용하면 보안 위험이 발생할 수 있습니다. 프로덕션 배포에서는 n8n과 태스크 러너 프로세스 간의 적절한 격리를 보장하기 위해 외부 모드 를 사용하세요. 추가 보안 조치는 태스크 러너 강화 를 참고하세요. 작동 방식 # 태스크 러너 기능은 하나 이상의 태스크 러너, 태스크 브로커, 태스크 요청자로 구성됩니다. 태스크 러너는 웹소켓 연결을 사용하여 태스크 브로커에 연결합니다. 태스크 요청자는 브로커에 태스크 요청을 제출하고, 사용 가능한 태스크 러너가 이를 가져와 실행합니다. 러너는 태스크를 실행하고 결과를 태스크 요청자에게 제출합니다. 태스크 브로커는 러너와 요청자 간의 통신을 조율합니다. n8n 인스턴스(main 및 worker)가 브로커 역할을 합니다. 이 경우 Code node가 태스크 요청자입니다. 태스크 러너 모드 # 태스크 러너는 내부(internal) 모드와 외부(external) 모드, 두 가지 방식으로 사용할 수 있습니다. 내부 모드 # 내부 모드에서는 n8n 인스턴스가 태스크 러너를 자식 프로세스로 실행합니다. n8n 프로세스가 태스크 러너의 수명 주기를 모니터링하고 관리합니다. 태스크 러너 프로세스는 n8n과 동일한 uid 및 gid 를 공유합니다. 이 방식은 프로덕션 환경에서 권장되지 않습니다 . 외부 모드 # 외부 모드에서는 런처 애플리케이션 이 필요에 따라 태스크 러너를 실행하고 그 수명 주기를 관리합니다. 일반적으로 이는 n8n 옆에 런처, JS 태스크 러너, Python 태스크 러너를 포함하는 n8nio/runners 이미지를 실행하는 사이드카 컨테이너를 추가하는 것을 의미합니다. 이 사이드카 컨테이너는 n8n 인스턴스와 독립적입니다. 큐 모드 를 사용할 때는 각 워커가 태스크 러너용 사이드카 컨테이너를 자체적으로 가지고 있어야 합니다. 또한 OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS=false 로 설정된 경우, 메인 인스턴스가 수동 실행을 처리하므로 태스크 러너용 사이드카 컨테이너를 자체적으로 가지고 있어야 합니다. 오프로딩을 비활성화한 상태로 n8n을 실행하는 것은 프로덕션 환경에 권장되지 않으니 참고하세요. 외부 모드 설정하기 # 외부 모드에서는 n8n 옆에 n8nio/runners 이미지를 사이드카 컨테이너로 실행합니다. 아래에서 참고할 수 있는 docker compose 예시를 확인하세요. n8nio/runners 이미지 버전은 n8nio/n8n 이미지의 버전과 일치해야 하며, n8n 버전은 1.111.0 이상이어야 한다는 점에 유의하세요. services: n8n: image: n8nio/n8n:1.111.0 container