튜토리얼: 프로그래밍 방식(programmatic-style) 노드 빌드하기

프로그래밍 방식 노드를 빌드하는 방법을 단계별로 설명합니다.

이 튜토리얼에서는 프로그래밍 방식 노드를 빌드하는 과정을 설명합니다. 시작하기 전에 이것이 필요한 노드 스타일인지 확인하세요. 자세한 내용은 노드 빌드 방식 선택하기 를 참고하세요. 사전 준비 사항 # 개발 머신에 다음 항목이 설치되어 있어야 합니다: 참고 이 섹션의 상세 내용은 n8n 공식 문서 를 참조하세요. 다음 항목에 대한 이해가 필요합니다: JavaScript/TypeScript REST API git n8n의 표현식 1 노드 빌드하기 # 이 섹션에서는 n8n의 노드 스타터 리포지터리를 클론하고, SendGrid 와 연동하는 노드를 빌드합니다. SendGrid 기능 중 하나인 연락처 생성을 구현하는 노드를 만들게 됩니다. Note 기존 노드 n8n에는 기본 제공되는 SendGrid 노드가 있습니다. 기존 노드와 충돌하지 않도록, 여러분이 만드는 버전에는 다른 이름을 붙입니다. 1단계: 프로젝트 설정하기 # n8n은 노드 개발을 위한 스타터 리포지터리를 제공합니다. 스타터를 사용하면 필요한 모든 의존성을 갖출 수 있습니다. 또한 린터(linter)도 제공됩니다. 리포지터리를 클론하고 디렉터리로 이동합니다: 템플릿 리포지터리에서 새 리포지터리를 생성 합니다. 새 리포지터리를 클론합니다: shell git clone https://github.com/<your-organization>/<your-repo-name>.git n8n-nodes-friendgrid cd n8n-nodes-friendgrid 스타터에는 예제 노드와 자격 증명이 포함되어 있습니다. 다음 디렉터리와 파일을 삭제하세요: nodes/Example nodes/GithubIssues credentials/GithubIssuesApi.credentials.ts credentials/GithubIssuesOAuth2Api.credentials.ts 이제 다음 디렉터리와 파일을 만듭니다: nodes/FriendGrid nodes/FriendGrid/FriendGrid.node.json nodes/FriendGrid/FriendGrid.node.ts credentials/FriendGridApi.credentials.ts 이는 모든 노드에 필요한 핵심 파일입니다. 필수 파일과 권장 구성에 대한 자세한 내용은 노드 파일 구조 를 참고하세요. 이제 프로젝트 의존성을 설치합니다: npm i 2단계: 아이콘 추가하기 # 여기 에서 SendGrid SVG 로고를 저장하여 nodes/FriendGrid/ 에 friendGrid.svg 로 저장합니다. 참고 이 섹션의 상세 내용은 n8n 공식 문서 를 참조하세요. 3단계: 베이스 파일에서 노드 정의하기 # 모든 노드는 베이스 파일을 가져야 합니다. 베이스 파일 파라미터에 대한 자세한 내용은 노드 베이스 파일 을 참고하세요. 이 예제에서 해당 파일은 FriendGrid.node.ts 입니다. 이 튜토리얼을 간결하게 유지하기 위해, 모든 노드 기능을 이 하나의 파일에 배치합니다. 더 복잡한 노드를 빌드할 때는 기능을 모듈로