튜토리얼: 선언적 스타일 노드 빌드하기

선언적 스타일 노드를 빌드하는 방법을 설명합니다.

이 튜토리얼에서는 선언적 스타일 노드를 빌드하는 과정을 안내합니다. 시작하기 전에 이것이 필요한 노드 스타일인지 확인하세요. 자세한 내용은 노드 빌드 방식 선택하기 를 참조하세요. 사전 준비 사항 # 개발 머신에 다음이 설치되어 있어야 합니다: 참고 이 섹션의 상세 내용은 n8n 공식 문서 를 참조하세요. 다음에 대한 이해가 필요합니다: JavaScript/TypeScript REST API git 노드 빌드하기 # 이 섹션에서는 n8n의 노드 스타터 리포지터리를 클론하고, NASA API 를 통합하는 노드를 빌드합니다. NASA의 두 가지 서비스인 APOD(오늘의 천문 사진, Astronomy Picture of the Day)와 화성 로버 사진(Mars Rover Photos)을 사용하는 노드를 만들게 됩니다. 코드 예제를 간결하게 유지하기 위해, 이 노드는 화성 로버 사진 엔드포인트에서 사용 가능한 모든 옵션을 구현하지는 않습니다. Note 기존 노드 n8n에는 내장 NASA 노드가 있습니다. 기존 노드와 충돌하지 않도록, 여러분이 만들 버전에는 다른 이름을 지정합니다. 1단계: 프로젝트 설정 # n8n은 노드 개발을 위한 스타터 리포지터리를 제공합니다. 스타터를 사용하면 필요한 모든 의존성을 갖출 수 있습니다. 또한 린터도 제공됩니다. 리포지터리를 클론하고 디렉터리로 이동합니다: 템플릿 리포지터리에서 새 리포지터리를 생성 합니다. 새 리포지터리를 클론합니다: shell git clone https://github.com/<your-organization>/<your-repo-name>.git n8n-nodes-nasa-pics cd n8n-nodes-nasa-pics 스타터에는 예제 노드와 자격 증명이 포함되어 있습니다. 다음 디렉터리와 파일을 삭제하세요: nodes/Example nodes/GithubIssues credentials/GithubIssuesApi.credentials.ts credentials/GithubIssuesOAuth2Api.credentials.ts 이제 다음 디렉터리와 파일을 생성합니다: nodes/NasaPics nodes/NasaPics/NasaPics.node.json nodes/NasaPics/NasaPics.node.ts credentials/NasaPicsApi.credentials.ts 이는 모든 노드에 필요한 핵심 파일입니다. 필수 파일과 권장 구성에 대한 자세한 내용은 노드 파일 구조 를 참조하세요. 이제 프로젝트 의존성을 설치합니다: npm i 2단계: 아이콘 추가 # 여기 에서 NASA SVG 로고를 저장하여 nodes/NasaPics/ 에 nasapics.svg 로 저장합니다. 참고 이 섹션의 상세 내용은 n8n 공식 문서 를 참조하세요. 3단계: 노드 생성 # 모든 노드는 기본 파일(base file)을 가져야 합니다. 기본 파일 매개변수에 대한 자세한 내용은 노드 기본 파일 을 참조하세요. 이 예제에서 해당 파일은 NasaPics.node.ts 입니다. 이 튜