노드 다루기

노드 다루기

노드는 데이터를 가져오는 진입점, 데이터를 처리하는 함수, 또는 데이터를 보내는 출구 역할을 해요. 노드[^1]는 워크플로[^2]를 구성하는 핵심 빌딩 블록이에요. 노드는 다양한 작업을 수행해요.

  • 워크플로 시작하기.
  • 데이터 가져오기와 보내기.
  • 데이터 처리와 조작하기.

n8n은 내장 노드 컬렉션을 제공하고, 직접 자신만의 노드를 만들 수도 있어요. 아래를 참고하세요.

워크플로에 노드 추가하기

빈 워크플로에 노드 추가하기

  1. Add first step을 선택하세요. n8n이 노드 패널을 열고, 여기서 트리거 노드[^3]를 검색하거나 둘러볼 수 있어요.
  2. 사용하고 싶은 트리거를 선택하세요.

앱 이벤트 선택하기

On App Event를 선택하면 n8n이 지원하는 모든 서비스 목록을 보여줘요. 이 목록으로 n8n의 통합을 탐색하고, 선택한 서비스의 이벤트에 응답해서 워크플로를 트리거할 수 있어요. 모든 통합에 트리거가 있는 건 아니에요. 트리거로 쓸 수 있는 노드가 있는지 확인하려면 노드를 선택해 보세요. 트리거가 있으면 사용 가능한 작업 목록의 맨 위에 표시돼요.

예를 들어 이건 Asana의 트리거예요.

Asana 노드 작업 목록 스크린샷, 목록 맨 위에 Recommended 섹션이 보임

기존 워크플로에 노드 추가하기

Add node Add node icon 커넥터를 선택하세요. n8n이 노드 패널을 열고, 여기서 모든 노드를 검색하거나 둘러볼 수 있어요.

노드 작업: 트리거와 액션

워크플로에 노드를 추가하면 n8n이 사용 가능한 작업 목록을 보여줘요. 작업(operation)은 노드가 하는 일, 예를 들어 데이터를 가져오거나 보내는 일을 말해요.

두 가지 유형의 작업이 있어요.

  • 트리거(Triggers) 는 서비스의 특정 이벤트나 조건에 응답해서 워크플로를 시작해요. 트리거를 선택하면 n8n이 선택한 트리거 작업이 미리 선택된 상태로 트리거 노드를 워크플로에 추가해요. n8n에서 노드를 검색하면 트리거 작업에는 번개 아이콘 Trigger icon 이 표시돼요.
  • 액션(Actions) 은 워크플로 내의 특정 작업을 나타내는 작업이에요. 데이터를 조작하고, 외부 시스템에 작업을 수행하고, 워크플로의 일부로 다른 시스템에서 이벤트를 트리거하는 데 사용할 수 있어요. 액션을 선택하면 n8n이 선택한 액션 작업이 미리 선택된 상태로 노드를 워크플로에 추가해요.

노드 컨트롤

캔버스에서 노드를 가리키면(호버) 노드 컨트롤을 볼 수 있어요.

  • Execute step Execute step icon: 노드 실행.
  • Deactivate Deactivate node icon: 노드 비활성화.
  • Delete Delete node icon: 노드 삭제.
  • Node context menu Node context menu icon: 노드 작업 선택. 사용 가능한 작업:
    • Open node
    • Execute step
    • Rename node
    • Deactivate node
    • Pin node
    • Copy node
    • Duplicate node
    • Tidy up workflow
    • Convert node to sub-workflow
    • Select all
    • Clear selection
    • Delete node

노드 설정

Settings 탭 아래의 노드 설정은 노드 동작을 제어하고 노드 노트를 추가할 수 있게 해줘요.

활성화하거나 설정하면 다음과 같이 동작해요.

  • Always Output Data: 실행 중 노드가 데이터를 반환하지 않아도 빈 항목을 반환해요. IF 노드에 이 설정을 켜면 무한 루프가 생길 수 있으니 주의하세요.
  • Execute Once: 노드가 처음 받은 항목의 데이터로 한 번만 실행돼요. 추가 항목은 처리하지 않아요.
  • Retry On Fail: 실행이 실패하면 성공할 때까지 노드를 다시 실행해요.
  • On Error:
    • Stop Workflow: 오류가 발생하면 전체 워크플로를 중단해서 이후 노드 실행을 막아요.
    • Continue: 오류가 있어도 마지막 유효 데이터를 사용해 다음 노드로 진행해요.
    • Continue (using error output): 워크플로 실행을 계속하면서 오류 정보를 다음 노드로 전달해 잠재적으로 처리할 수 있게 해요.
  • Custom Span Attributes: 노드의 OpenTelemetry 스팬(span)에 커스텀 키-값 속성을 추가해요. 키는 일반 텍스트이고, 값은 표현식을 지원해요. 이 설정은 OpenTelemetry 추적을 활성화하고 self-hosted Enterprise 라이선스가 있을 때만 표시돼요. 자세한 내용은 Custom span attributes를 참고하세요.

노드 노트로 워크플로를 문서화할 수 있어요.

  • Notes: 노드와 함께 저장할 노트.
  • Display note in flow: 활성화하면 n8n이 노트를 워크플로의 부제목으로 표시해요.

[^1]: n8n에서 노드는 워크플로를 만들기 위해 조합하는 개별 컴포넌트예요. 노드는 워크플로가 언제 실행되어야 하는지 정의하고, 데이터를 가져오고·보내고·처리하게 하며, 흐름 제어 로직을 정의하고, 외부 서비스와 연결할 수 있어요.

[^2]: n8n 워크플로는 프로세스를 자동화하는 노드의 모음이에요. 워크플로는 트리거 조건이 발생하면 실행을 시작하고 순차적으로 실행되어 복잡한 작업을 달성해요.

[^3]: 트리거 노드는 특정 조건에 응답해서 워크플로를 실행하는 특수 노드예요. 모든 프로덕션 워크플로는 워크플로가 언제 실행되어야 하는지 결정하는 트리거가 최소 하나 필요해요.