커뮤니티 노드는 npm 레지스트리에 호스팅되는 npm 패키지입니다.

커뮤니티 노드 저장소에 제출할 노드를 빌드할 때, 노드 설정이 올바른지 확인하려면 다음 리소스를 활용하세요:

• n8n은 노드 빌드 및 테스트를 위해 n8n-node CLI 도구를 사용하도록 권장합니다. 특히 검증을 위해 노드를 제출할 계획이라면 중요합니다. 이 도구는 노드가 올바른 구조를 갖추고 커뮤니티 노드 요구사항을 충족하도록 보장합니다. 또한 린팅과 테스트를 단순화합니다.
• 노드에서 사용할 수 있는 패턴 예시는 n8n의 자체 노드를 참고하세요.
• 자체 노드 빌드 문서를 참고하세요.
• 노드가 커뮤니티 노드의 표준을 따르는지 확인하세요.

표준#

n8n-node 도구로 개발하면 노드가 n8n 커뮤니티 노드 저장소에서 사용 가능하도록 요구되는 다음 표준을 준수하게 됩니다:

• 패키지 이름이 n8n-nodes- 또는 @<scope>/n8n-nodes-로 시작하는지 확인하세요. 예: n8n-nodes-weather 또는 @weatherPlugins/n8n-nodes-weather.
• 패키지 키워드에 n8n-community-node-package를 포함하세요.
• package.json 파일의 n8n 속성 내에 노드와 자격증명을 추가했는지 확인하세요.
• 린터(npm run lint)로 노드를 확인하고 로컬에서 테스트(npm run dev)하여 작동하는지 확인하세요.
• 패키지를 npm에 배포하세요. n8n Creator Portal을 통해 검증을 위해 노드를 제출할 계획이라면 출처 명세서를 사용하여 GitHub Actions 워크플로우로 배포해야 합니다. 아래 npm에 배포하기를 참고하세요.

npm에 배포하기#

n8n Creator Portal을 통해 노드를 검증 제출하려면 출처 명세서가 포함된 GitHub Actions 워크플로우를 사용하여 배포하세요. 출처는 특정 워크플로우가 특정 저장소와 커밋에서 패키지를 빌드했음을 암호화 방식으로 검증할 수 있도록 합니다. GitHub Actions는 OIDC 인프라를 사용하여 출처 명세서에 서명합니다.

신규 노드#

npm create @n8n/node로 노드를 스캐폴딩하면 즉시 사용 가능한 publish.yml 워크플로우가 포함됩니다. 로컬에서 npm run release를 실행하여 버전을 올리고, 커밋, 태그 지정 및 푸시합니다. 이렇게 하면 npm에 배포하는 워크플로우가 트리거됩니다.

기존 노드#

n8n-nodes-starter의 배포 워크플로우를 저장소의 .github/workflows/publish.yml에 추가하세요.

또한 프로젝트에 @n8n/node-cli 버전 0.23.0 이상이 devDependency로 있는지 확인하세요. 이전 버전은 워크플로우에서 사용하는 출처 플래그를 지원하지 않습니다:

npm list @n8n/node-cli

최초 설정#

npm이 저장소의 GitHub Actions 워크플로우를 신뢰하여 대신 배포할 수 있도록 구성합니다. 장기 토큰이 필요하지 않습니다:

1. npmjs.com에 로그인하여 패키지 설정을 엽니다.
2. 배포 접근 > 신뢰할 수 있는 배포자에서 배포자 추가를 클릭합니다.
3. GitHub Actions를 선택하고 다음을 입력합니다:
   • 저장소 소유자: GitHub 사용자 이름 또는 조직
   • 저장소 이름: 저장소 이름
   • 워크플로우 이름: publish.yml (워크플로우의 name: 필드가 아닌 파일 이름)

대신 토큰을 사용하려면 npmjs.com에서 세분화된 액세스 토큰을 생성하고 저장소의 Actions 시크릿에 NPM_TOKEN으로 저장하세요. 자세한 내용은 워크플로우 파일의 주석을 참고하세요.

n8n의 검증을 위해 노드 제출하기#

n8n은 검증된 커뮤니티 노드를 검토합니다. 사용자는 n8n의 노드 패널에서 검증된 커뮤니티 노드를 발견하고 설치할 수 있습니다. 이러한 노드는 특정 기술 및 UX 표준과 제약을 준수해야 합니다.

n8n에 검토를 위해 노드를 제출하기 전에 다음을 수행해야 합니다:

• n8n-node 도구에서 생성된 스캐폴딩에서 시작하세요. 엄격히 필수 사항은 아니지만, n8n은 검증 제출을 계획하는 모든 커뮤니티 노드에 n8n-node CLI 도구를 사용하도록 강력히 권장합니다. 도구를 사용하면 노드가 예상 규칙을 따르고 커뮤니티 노드 요구사항을 준수하도록 보장합니다.
• 노드가 검증된 커뮤니티 노드의 기술 가이드라인을 따르고 모든 자동화 검사를 통과하는지 확인하세요. 특히 검증된 커뮤니티 노드는 런타임 종속성을 사용할 수 없습니다.
• 노드가 UX 가이드라인을 따르는지 확인하세요.
• 노드에 npm 패키지의 README 또는 관련 공개 저장소 형식의 적절한 문서가 있는지 확인하세요.
• npm에 배포하기에 설명된 대로 출처가 포함된 GitHub Actions 워크플로우를 사용하여 npm에 노드를 배포하세요. n8n이 최종 검토를 위해 이곳에서 가져갑니다.

제출 준비가 되셨나요?#

노드가 위의 모든 요구사항을 충족하면 n8n Creator Portal에 가입하거나 로그인하여 검증을 위해 노드를 제출하세요. n8n은 n8n의 유료 기능, 특히 엔터프라이즈 기능과 경쟁하는 노드를 거부할 권리를 보유합니다.