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

v2의 모든 호환성 변경 사항은 이 페이지에서 확인할 수 있습니다.

도구 접근 방법#

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: 기능을 중단시키지 않는 사소한 변경 사항이나 사용 중단 경고
• Description: 무엇이 변경되고 왜 중요한지에 대한 설명
• Documentation link: 클릭하면 자세한 마이그레이션 설명을 볼 수 있습니다
• Affected workflow count: 이 문제가 있는 워크플로의 수

워크플로 문제 상세 페이지#

X workflows affected를 클릭하면 영향을 받는 모든 워크플로를 볼 수 있습니다. 각 워크플로에 대해 표시되는 정보:

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

Instance Issues 탭#

특정 워크플로가 아닌 n8n 인스턴스 전체에 영향을 미치는 설정 변경 사항을 표시합니다. 각 문제에 대해 표시되는 정보:

• 워크플로 문제와 동일한 정보 (제목, 심각도, 설명, 문서)
• 워크플로 수 없음: 인스턴스 전체에 적용되는 전역 설정입니다

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

빈 상태 이해#

워크플로 문제 없음#

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

인스턴스 문제 없음#

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

두 탭 모두 비어있음#

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

권장 워크플로#

초기 평가#

• 호환성 요약 검토
• 두 탭의 모든 문제를 탐색하여 범위 파악

심각도별 정렬#

• Critical 문제부터 시작 (워크플로가 중단됩니다)
• Medium 문제로 이동 (문제를 일으킬 수 있습니다)
• Low 문제는 마지막에 처리 (사용 중단 경고)

워크플로 문제 수정#

• 각 문제를 클릭하여 영향을 받는 워크플로 확인
• 수정 지침을 위한 문서 읽기
• 필요에 따라 각 워크플로 업데이트
• 개발 환경에서 워크플로 테스트

인스턴스 문제 처리#

• 환경 변수 또는 서버 설정 업데이트
• 각 인스턴스 수준 변경에 대한 문서 따르기

작업 확인#

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

업그레이드 진행#

모든 문제를 처리한 후 n8n 2.0으로 업그레이드할 준비가 되었습니다.