마이그레이션 도구는 업그레이드 전에 살펴 봐야 할 워크플로와 구성을 찾아내어 n8n 인스턴스를 n8n 2.0으로 업그레이드할 준비를 도와줍니다.

n8n 2.0의 모든 호환성을 깨는 변경은 이 페이지에서 확인할 수 있습니다.

도구 사용하기#

설정(Settings) > Migration Report로 이동하면 호환 상태를 볼 수 있습니다.

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

페이지 상단에서 다음 문구를 볼 수 있습니다:

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

이 문구는 업그레이드 후에도 그대로 작동하는 워크플로가 몇 개인지 알려 줍니다. 나머지 워크플로가 호환되지 않는 이유와 전역 인스턴스 이슈까지 해결하는 것이 목표입니다.

이슈 보기#

도구는 잠재적인 문제를 두 종류로 나눕니다:

워크플로 이슈 탭#

인스턴스 안의 특정 워크플로에 영향을 주는 호환성을 깨는 변경을 보여 줍니다. 각 이슈에 표시되는 내용:

• 이슈 제목: 문제를 잘 설명하는 이름
• 심각도 배지(Critical/Medium/Low): 얼마나 시급하게 고쳐야 하는지
  • Critical: 업그레이드 전에 고치지 않으면 워크플로가 실패합니다
  • Medium: 예상치 못한 동작이 생기거나 조만간 확인이 필요할 수 있습니다
  • Low: 기능을 깨지 않는 사소한 변경이나 권장 중단 항목입니다
• 설명: 무엇이 바뀌는지, 왜 중요한지에 대한 설명
• 문서 링크: 클릭하면 자세한 마이그레이션 설명을 읽을 수 있습니다
• 영향받는 워크플로 수: 이 이슈가 있는 워크플로가 몇 개인지

워크플로 이슈 상세 페이지#

X workflows affected를 클릭하면 영향받는 워크플로 전체를 볼 수 있습니다. 각 워크플로에 표시되는 내용:

• 이름: 워크플로 이름입니다. 이름을 클릭하면 워크플로 편집기가 열립니다.
• 상태: 워크플로가 게시되었는지 여부입니다
• 영향받는 노드: 이 이슈로 영향받는 워크플로의 노드 목록입니다. 각 노드를 클릭하면 해당 노드 화면이 열린 상태로 워크플로 편집기가 열립니다.
• 실행 횟수: 워크플로의 총 실행 횟수입니다
• 마지막 실행: 워크플로가 마지막으로 실행된 날짜입니다
• 마지막 업데이트: 워크플로가 마지막으로 업데이트된 날짜입니다

인스턴스 이슈 탭#

특정 워크플로가 아니라 전체 n8n 인스턴스에 영향을 주는 구성 변경을 보여 줍니다. 각 이슈에 표시되는 내용:

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

n8n 2.0 마이그레이션 도구는 n8n 인스턴스를 스캔해 잠재적인 호환성 이슈와 n8n 2.0으로 업그레이드에 필요한 구성 변경을 찾아 냅니다. 이 참조 문서는 도구가 수행하는 각 검사를 설명하고, 발견된 이슈의 영향을 알려 주며, 인스턴스를 마이그레이션에 준비하는 방법을 제안합니다.

빈 상태 이해하기#

워크플로 이슈 없음#

모든 워크플로가 n8n 2.0과 호환됩니다. 서버 구성도 준비됐는지 Instance Issues 탭을 확인하세요.

인스턴스 이슈 없음#

인스턴스 구성이 n8n 2.0과 호환됩니다. 모든 워크플로도 준비됐는지 Workflow Issues 탭을 확인하세요.

두 탭 모두 비어 있음#

n8n 인스턴스가 n8n 2.0으로 업그레이드할 완전한 준비가 됐습니다.

권장 작업 순서#

초기 평가#

• 호환성 요약을 검토하세요
• 두 탭의 모든 이슈를 훑어 본며 범위를 파악하세요

심각도 순으로 정렬#

• Critical 이슈부터 시작하세요(워크플로가 깨집니다)
• 다음은 Medium 이슈입니다(문제를 일으킬 수 있습니다)
• Low 이슈는 마지막에 처리하세요(권장 중단 경고)

워크플로 이슈 수정#

• 각 이슈를 클릭해 영향받는 워크플로를 확인하세요
• 수정 방법은 문서를 읽으세요
• 필요에 따라 각 워크플로를 수정하세요
• 개발 환경에서 워크플로를 테스트하세요

인스턴스 이슈 처리#

• 환경 변수나 서버 구성을 수정하세요
• 각 인스턴스 수준 변경에 대해 문서를 따라 하세요

작업 확인#

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

업그레이드 진행#

모든 이슈를 해결했으면 n8n 2.0으로 업그레이드할 준비가 된 것입니다.