n8n 패키지
n8n v2.42요약
n8n 패키지는 n8n 2.27.0부터 사용할 수 있으며, 이후 대부분의 릴리즈에서 옵션이 추가되었습니다. n8n 패키지는 프리뷰 상태입니다. n8n 패키지는 n8n 인스턴스의 일부, 즉 일부 워크플로와 그 워크플로를 실행하는 데 필요한 구조 및 참조를 담은 단일 파일입니다.
기능 제공 여부
n8n 패키지는 n8n 2.27.0부터 사용할 수 있으며, 이후 대부분의 릴리즈에서 옵션이 추가되었습니다. 여기에 나온 옵션이 인식되지 않으면 사용 중인 버전을 확인하세요.
프리뷰 상태
n8n 패키지는 프리뷰 상태입니다. 패키지 형식과 API는 이후 릴리즈에서 바뀔 수 있으므로, 업데이트 계획 없이 핵심 자동화에서 이에 의존하지 마세요.
n8n 패키지는 n8n 인스턴스의 일부, 즉 일부 워크플로와 그 워크플로를 실행하는 데 필요한 구조 및 참조를 담은 단일 파일입니다. 한 인스턴스에서 패키지를 내보내고, 파일을 옮긴 다음, 다른 인스턴스로 가져옵니다. n8n 인스턴스 일부를 위한 npm 패키지라고 생각하면 됩니다.
패키지는 .n8np 확장자를 가진 gzip 압축 tar 아카이브입니다. 내부의 각 엔티티는 작은 JSON 파일이며, manifest.json에 패키지에 포함된 항목과 대상 인스턴스가 제공해야 하는 항목이 나열됩니다. 전체 구성은 패키지 형식을 참고하세요.
패키지는 API 기능입니다. n8n API나 같은 두 엔드포인트를 감싼 n8n CLI를 통해 패키지를 내보내고 가져옵니다. n8n 에디터에서는 패키지를 내보내거나 가져올 수 없습니다.
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
세 가지 패키지 형태#
무엇을 내보내는지에 따라 패키지의 형태가 정해지고, 그 형태에 따라 가져올 때 내용이 배치되는 방식이 정해집니다.
- 워크플로 패키지: 워크플로 하나 이상. 가져올 때 선택한 프로젝트와 폴더에 배치됩니다.
- 폴더 패키지: 폴더 하나 이상이며, 폴더 안에 중첩된 모든 항목을 항상 포함합니다. 가져올 때 폴더 트리가 선택한 프로젝트에 배치됩니다.
- 프로젝트 패키지: 전체 프로젝트 하나 이상. 패키지가 자체 프로젝트를 담고 있으므로 내용이 배치될 위치를 스스로 결정하며, 전달한 대상 프로젝트는 무시합니다.
워크플로와 폴더는 한 번의 내보내기에 함께 담을 수 있습니다. 둘 중 어느 것도 프로젝트와 함께 담을 수는 없습니다.
패키지에 포함되는 항목#
| 포함됨 | 포함되지 않음 |
|---|---|
| 워크플로: 노드, 연결, 설정, 게시 상태, 보관 상태 | 자격 증명 시크릿과 구성 |
| 폴더와 중첩 구조 | 데이터 테이블 행 |
| 프로젝트: 이름, 설명, 아이콘 | 실행과 실행 기록 |
| 자격 증명 참조: ID, 이름, 유형만 | 사용자, 프로젝트 멤버, 역할, 공유 |
| 데이터 테이블 스키마: 칼럼 ID, 이름, 유형 | 고정된 데이터와 워크플로 정적 데이터 |
| 변수: 이름과 유형, 제외하지 않으면 값도 포함 | 워크플로 버전 기록 |
| 태그 | 워크플로를 즐겨찾기로 표시했는지 여부 |
자격 증명 시크릿은 절대 포함되지 않습니다. 패키지의 자격 증명 파일에는 ID, 이름, 유형의 세 필드만 들어 있습니다. 호스트, 기본 URL, 리전 같은 비밀이 아닌 구성도 시크릿과 같은 암호화 저장소에 있으므로 포함되지 않습니다. 가져올 때 n8n은 각 참조를 대상 인스턴스에 이미 있는 자격 증명과 매칭하거나, 사용자가 채울 수 있도록 빈 자리 표시자를 만듭니다.
데이터 테이블 행은 절대 포함되지 않습니다. 스키마만 포함됩니다. 가져온 데이터 테이블은 비어 있는 상태로 시작합니다.
패키지를 사용해야 하는 경우#
인스턴스 간에 작업을 옮기는 반복 가능하고 자동화할 수 있는 방법이 필요할 때 패키지를 사용합니다.
- 환경 간 승격. 파이프라인의 일부로 워크플로를 개발에서 스테이징, 프로덕션으로 푸시합니다. 반복해서 가져오면 중복을 만들지 않고 그 자리에서 업데이트되므로 같은 명령이 처음에도 이후에도 똑같이 동작합니다.
- 새 인스턴스로 마이그레이션. 프로젝트와 그 폴더, 워크플로를 파일 하나로 옮깁니다.
- 시크릿 공유 없이 작업 공유. 파일에 자격 증명 데이터가 없다는 점을 알고 다른 팀에 워크플로를 전달합니다.
- 구조 백업. 다시 구축하는 데 필요한 워크플로와 구조의 사본을 보관합니다. 다만 실행 데이터는 포함되지 않으므로 패키지는 전체 백업이 아닙니다.
빠른 시작#
CLI가 원본 인스턴스를 가리키도록 설정한 다음 워크플로를 내보냅니다.
n8n-cli config set-url https://source.example.com
n8n-cli config set-api-key <your-api-key>
n8n-cli package export --workflow-id=<workflow-id> --output=triage.n8np
대상 인스턴스를 가리키도록 설정한 다음 파일을 가져옵니다.
n8n-cli config set-url https://target.example.com
n8n-cli config set-api-key <your-api-key>
n8n-cli package import --file=triage.n8np --project-id=<target-project-id>
n8n은 아무것도 쓰기 전에 패키지 전체를 확인합니다. 대상 인스턴스에 없는 노드 유형을 사용하는 워크플로처럼 가져오기를 막는 문제가 있으면, 명령이 0이 아닌 상태 코드로 종료되고 발견한 모든 문제를 한 번에 나열합니다.
이 섹션의 페이지#
- 패키지 형식:
.n8np파일의 내부 구성, 세 가지 패키지 형태, 매니페스트. - 패키지 내보내기: 워크플로, 폴더, 전체 프로젝트를 패키지로 내보내기.
- 패키지 가져오기: 패키지를 가져오고 내용이 배치될 위치 제어하기.
- 가져오기 동작 방식: n8n이 패키지를 쓰기 전에 확인하고 의존성을 해결하는 방식.
- 제한 및 권한: 크기 제한, 라이선스 기능, API 키 스코프.
복사해서 붙여 넣기, 에디터의 다운로드 및 가져오기 옵션 등 워크플로를 옮기는 다른 방법은 내보내기 및 가져오기를 참고하세요.