마이그레이션 도구는 업그레이드 전에 주의가 필요한 워크플로와 설정을 확인하여 n8n 인스턴스를 버전 2.0으로 업그레이드할 준비를 하는 데 도움을 줍니다.

v2에 대한 모든 호환성 저해 변경 사항(breaking changes)은 이 페이지에서 확인할 수 있습니다.

도구에 접근하기#

Settings > Migration Report로 이동하여 호환성 상태를 확인합니다.

마이그레이션 상태 이해하기#

페이지 상단에는 다음이 표시됩니다.

"X out of Y workflows are compatible with n8n 2.0"

이는 업그레이드 후 변경 없이 계속 작동할 워크플로의 수를 알려줍니다. 목표는 나머지 워크플로가 호환되지 않게 만드는 문제와 인스턴스 전역 문제를 해결하는 것입니다.

문제 확인하기#

이 도구는 잠재적인 문제를 다음 두 가지 범주로 정리합니다.

Workflow Issues 탭#

인스턴스 내 특정 워크플로에 영향을 미치는 호환성 저해 변경 사항을 보여줍니다. 각 문제에 대해 다음 내용을 확인할 수 있습니다.

• Issue title: 문제에 대한 명확한 이름
• Severity badge(Critical/Medium/Low): 수정이 얼마나 시급한지
  • Critical: 업그레이드 전에 수정하지 않으면 워크플로가 실패함
  • Medium: 예기치 않은 동작을 일으키거나 조만간 조치가 필요할 수 있음
  • Low: 기능을 손상시키지 않는 사소한 변경 또는 지원 중단(deprecation) 사항
• Description: 무엇이 변경되고 왜 중요한지에 대한 설명
• Documentation link: 클릭하면 자세한 마이그레이션 설명을 읽을 수 있음
• Affected workflow count: 이 문제가 있는 워크플로 수

Workflow Issue 상세 페이지#

X workflows affected를 클릭하면 영향을 받는 모든 워크플로를 확인할 수 있습니다. 각 워크플로에 대해 다음 내용을 확인할 수 있습니다.

• Name: 워크플로 이름입니다. 이름을 클릭하면 워크플로 에디터가 열립니다.
• State: 워크플로가 게시(published)되었는지 여부
• Node affected: 이 문제의 영향을 받는 모든 워크플로 노드 목록입니다. 각 노드를 클릭하면 해당 노드 뷰가 열린 상태로 워크플로 에디터를 열 수 있습니다.
• Number of executions: 해당 워크플로의 총 실행 횟수
• Last executed: 워크플로가 마지막으로 실행된 날짜
• Last updated: 워크플로가 마지막으로 업데이트된 날짜

Instance Issues 탭#

특정 워크플로가 아니라 인스턴스 전체에 영향을 미치는 설정 변경 사항을 보여줍니다. 각 문제에 대해 다음 내용을 확인할 수 있습니다.

• Workflow Issues와 동일한 정보(제목, 심각도, 설명, 문서 링크)
• No workflow count: 인스턴스 전체에 적용되는 전역 설정이므로 워크플로 수는 표시되지 않습니다.

v2.0 마이그레이션 도구는 n8n 인스턴스를 스캔하여 v2.0으로 업그레이드하는 데 필요한 잠재적 호환성 문제와 설정 변경 사항을 식별합니다. 이 참조 문서는 도구가 수행하는 각 검사 항목을 자세히 설명하고, 발견된 문제의 영향을 설명하며, 마이그레이션을 위해 인스턴스를 준비하기 위한 권장 사항을 제공합니다.

빈 상태(Empty State) 이해하기#

워크플로 문제가 발견되지 않음#

모든 워크플로가 v2.0과 호환됩니다. 서버 설정도 준비되었는지 확인하려면 Instance Issues 탭을 확인하세요.

인스턴스 문제가 발견되지 않음#

인스턴스 설정이 v2.0과 호환됩니다. 모든 워크플로도 준비되었는지 확인하려면 Workflow Issues 탭을 확인하세요.

두 탭 모두 비어 있음#

n8n 인스턴스가 버전 2.0으로 업그레이드할 준비가 완전히 되었습니다.

권장 작업 흐름#

초기 평가#

• 호환성 요약을 검토합니다.
• 전체 범위를 파악하기 위해 두 탭의 모든 문제를 살펴봅니다.

심각도별 정렬#

• Critical 문제부터 시작합니다(워크플로가 손상됩니다).
• Medium 문제로 넘어갑니다(문제를 일으킬 수 있습니다).
• Low 문제는 마지막에 처리합니다(지원 중단 경고).

워크플로 문제 수정#

• 각 문제를 클릭하여 영향을 받는 워크플로를 확인합니다.
• 수정 방법에 대한 문서를 읽습니다.
• 필요에 따라 각 워크플로를 업데이트합니다.
• 개발 환경에서 워크플로를 테스트합니다.

인스턴스 문제 해결#

• 환경 변수 또는 서버 설정을 업데이트합니다.
• 각 인스턴스 수준 변경에 대한 문서를 따릅니다.

작업 확인#

• Refresh를 클릭하여 다시 스캔합니다. Refresh 버튼이 보이지 않으면 페이지를 새로고침하기만 하면 다시 스캔됩니다.
• 해결되지 않은 문제가 남아 있지 않은지 확인합니다.
• 호환성 수가 전체 워크플로 수와 일치하는지 확인합니다.

업그레이드 진행#

모든 문제를 해결한 후에는 n8n 2.0으로 업그레이드할 준비가 완료됩니다.