큐 모드 활성화

n8n에서 확장성이 가장 뛰어난 큐 모드를 설정하고 사용하는 방법을 설명합니다.

필요에 따라 n8n을 다양한 모드로 실행할 수 있습니다. 큐 모드는 최고의 확장성을 제공합니다. Note 바이너리 데이터 저장소 n8n은 파일 시스템에 바이너리 데이터를 저장하는 방식과 큐 모드를 함께 지원하지 않습니다. 워크플로에서 큐 모드로 바이너리 데이터를 유지해야 하는 경우 S3 외부 저장소 를 사용할 수 있습니다. 작동 방식 # 큐 모드로 실행할 때는 여러 n8n 인스턴스를 설정하며, 하나의 메인 인스턴스가 워크플로 정보(예: 트리거)를 수신하고 워커 인스턴스가 실행을 수행합니다. 각 워커는 자체 Node.js 인스턴스로, main 모드로 실행되지만 높은 IOPS(초당 입출력 작업 수) 덕분에 여러 워크플로 실행을 동시에 처리할 수 있습니다. 워커 인스턴스를 사용하고 큐 모드로 실행하면 워크로드를 처리하기 위해 필요에 따라 워커를 추가하여 확장하거나(scale up) 워커를 제거하여 축소(scale down)할 수 있습니다. 처리 흐름은 다음과 같습니다. 메인 n8n 인스턴스가 타이머와 웹훅 호출을 처리하여 워크플로 실행을 생성합니다(실행하지는 않음). 실행 ID를 메시지 브로커인 Redis 에 전달하며, Redis는 대기 중인 실행의 큐를 유지하고 다음 가용 워커가 이를 가져갈 수 있도록 합니다. 풀에 있는 워커 하나가 Redis에서 메시지를 가져옵니다. 워커는 실행 ID를 사용하여 데이터베이스에서 워크플로 정보를 가져옵니다. 워크플로 실행을 완료한 후 워커는 다음을 수행합니다. 결과를 데이터베이스에 씁니다. 실행이 완료되었다는 내용을 Redis에 게시합니다. Redis가 메인 인스턴스에 알립니다. 워커 구성 # 워커는 실제 작업을 수행하는 n8n 인스턴스입니다. 메인 n8n 프로세스로부터 실행해야 할 워크플로에 대한 정보를 수신하고, 워크플로를 실행하며, 각 실행이 완료된 후 상태를 업데이트합니다. Note 프로세스별 이벤트 로그 파일 워커가 쓰기 가능한 파일 시스템을 공유하는 경우, 각 워커 프로세스에 고유한 이벤트 로그 경로를 지정하세요. 자세한 내용은 프로세스별 이벤트 로그 파일 을 참조하세요. 암호화 키 설정 # n8n은 최초 시작 시 암호화 키를 자동으로 생성합니다. 원한다면 환경 변수 를 사용해 직접 사용자 지정 키를 제공할 수도 있습니다. 워커 노드가 데이터베이스에 저장된 자격 증명에 접근할 수 있도록, 메인 n8n 인스턴스의 암호화 키를 모든 워커 및 웹훅 프로세서 노드와 공유해야 합니다. 구성 파일 에서 각 워커 노드의 암호화 키를 설정하거나, 해당 환경 변수를 설정하세요. export N8N_ENCRYPTION_KEY=<main_instance_encryption_key> 실행 모드 설정 # Note 데이터베이스 관련 고려 사항 n8n은 Postgres 13 이상 사용을 권장합니다. SQLite 데이터베이스와 함께 실행 모드를 queue 로 설정하여 n8n을 실행하는 것은 권장하지 않습니다. 다음 명령을 사용하여 메인 인스턴스와 모든 워커에서 환경 변수 EXECUTIONS_MODE 를 queue 로