Publicación de custom nodes de n8n en npmjs para compartir

Contenido del curso

Gestión avanzada de n8n

Despliegue de n8n

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:009:35

Publicación de custom nodes de n8n en npmjs para compartir

Curso de n8n Self-Hosted para Empresas

Clase 8 de 13

Clase 8 / 13

Comentarios (3)3 comentarios

Jeisson Espinosa

Hace 10 meses

Información resumida de esta clase

#EstudiantesDePlatzi

npmjs es el repositorio más famoso
Debemos crear un repositorio en Github con las mejores practicas para compartir nuestros nodos
En el curso de la linea de comandos o Github se nos enseña como hacer push a un repositorio
El profesor es muy top
Hay alguien con vida aquiiiiii

Victor Agustin Henriquez Ibañez

Hace 3 meses

Buen cierre del flujo de custom nodes: no basta con crear y probar el nodo localmente, también hay que publicarlo correctamente, versionarlo y validarlo como community node en n8n. Me parece clave revisar el package.json, ejecutar el build antes de publicar y tener cuidado con los nodos no verificados en producción.

John Dicelis

Hace 9 meses•editado

n8n-nodes-sexpefum-watermark

Este nodo pone una marca de agua en las imagenes que uno les envia

Recursos

Publicar un custom node de n8n en npmjs te permite compartirlo con tu equipo y con la comunidad, con un flujo claro: preparar el repository, ajustar el package.json, autenticarte en npmjs y finalizar con la instalación como community node en n8n. Aquí verás los comandos clave, los requisitos mínimos y las decisiones importantes (SSH vs HTTPS, nombre del paquete, y verificación en n8n) explicadas paso a paso.

¿Cómo preparar el repositorio en GitHub o GitLab?

Para compartir el código, primero súbelo a un repository propio. Si partiste de una plantilla clonada, desvincúlalo del origen anterior.

Crea un repositorio en GitHub o GitLab. Añade descripción, .gitignore y README.
Si tu proyecto ya tiene referencias a otro remoto, borra la carpeta .git para romper el vínculo.
Inicializa y versiona el proyecto con la rama principal en main.

Comandos utilizados:

git init
git add .
git commit -m "initial commit"
git branch -M main

Conecta el remoto que GitHub/GitLab te ofrece. Puedes usar SSH o HTTPS.
Con HTTPS te pedirá usuario y contraseña.
Con SSH usarás tu clave configurada.
Verifica en el navegador que los cambios aparecen en el repository. Copia la URL: la necesitarás más tarde.

Conceptos y habilidades practicadas: control de versiones con git init, commit con mensaje claro, gestión de rama principal con git branch -M main, y autenticación por SSH/HTTPS. Buenas prácticas: mensajes de commit descriptivos y revisión final antes de publicar.

¿Cómo publicar en npmjs con package.json correcto?

Publicar en npmjs exige un package.json completo y una sesión activa de login. Además, la comunidad de n8n requiere un nombre con prefijo específico.

En package.json añade el objeto repository apuntando a tu repositorio.
Asegura los campos requeridos: author, name y description.
Ajusta el nombre del paquete para la comunidad: el nodo debe llevar el prefijo n10-nodes y, en el ejemplo, se usa n8n-node-verificar-email tras renombrar en Settings.

Autenticación y publicación:

npm login
npm run build
npm publish

Durante npm login, sigue el enlace del terminal y completa la verificación (2FA si procede).
Ejecuta npm run build para garantizar el build más reciente.
Ejecuta npm publish. Si falla por campos faltantes, completa author, email y description en package.json y vuelve a publicar.
Si el nombre ya existe, cámbialo (por ejemplo, añadiendo un guion) y repite la publicación.

Conceptos y habilidades: configuración de package.json, autenticación en npmjs con login y 2FA, ciclo de build y publish, y resolución de conflictos por nombres duplicados.

¿Cómo instalar el community node en n8n y validarlo?

Una vez publicado, puedes instalarlo como community node en n8n para usarlo en remoto y compartirlo.

En n8n, ve a community nodes e instala el paquete por su nombre.
Disponible en self-hosted; en cloud solo bajo la versión Enterprise.
Acepta el aviso de nodo no verificado por n8n.
Verifica la instalación: en el canvas, agrega el nodo. Verás un icono que indica que es community node.
Añádelo al workflow, conéctalo a un trigger y ejecuta una prueba (por ejemplo, con un correo de prueba).
Observa la respuesta en la ejecución: si aparece, el nodo remoto funciona.

Conceptos y habilidades: instalación de community nodes, gestión de riesgos de paquetes no verificados, verificación funcional en el workflow y prueba conectada a trigger.

¿Tienes ya tu paquete publicado o una variante que devuelva un texto? Comparte el nombre de tu nodo y el enlace en los comentarios para que otros puedan probarlo y dar feedback.

Resumen

¿Cómo preparar el repositorio en GitHub o GitLab?

Para compartir el código, primero súbelo a un repository propio. Si partiste de una plantilla clonada, desvincúlalo del origen anterior.

Crea un repositorio en GitHub o GitLab. Añade descripción, .gitignore y README.
Si tu proyecto ya tiene referencias a otro remoto, borra la carpeta .git para romper el vínculo.
Inicializa y versiona el proyecto con la rama principal en main.

Comandos utilizados:

git init
git add .
git commit -m "initial commit"
git branch -M main

Conecta el remoto que GitHub/GitLab te ofrece. Puedes usar SSH o HTTPS.
Con HTTPS te pedirá usuario y contraseña.
Con SSH usarás tu clave configurada.
Verifica en el navegador que los cambios aparecen en el repository. Copia la URL: la necesitarás más tarde.

¿Cómo publicar en npmjs con package.json correcto?

Publicar en npmjs exige un package.json completo y una sesión activa de login. Además, la comunidad de n8n requiere un nombre con prefijo específico.

En package.json añade el objeto repository apuntando a tu repositorio.
Asegura los campos requeridos: author, name y description.
Ajusta el nombre del paquete para la comunidad: el nodo debe llevar el prefijo n10-nodes y, en el ejemplo, se usa n8n-node-verificar-email tras renombrar en Settings.

Autenticación y publicación:

npm login
npm run build
npm publish

Durante npm login, sigue el enlace del terminal y completa la verificación (2FA si procede).
Ejecuta npm run build para garantizar el build más reciente.
Ejecuta npm publish. Si falla por campos faltantes, completa author, email y description en package.json y vuelve a publicar.
Si el nombre ya existe, cámbialo (por ejemplo, añadiendo un guion) y repite la publicación.

Conceptos y habilidades: configuración de package.json, autenticación en npmjs con login y 2FA, ciclo de build y publish, y resolución de conflictos por nombres duplicados.

¿Cómo instalar el community node en n8n y validarlo?

Una vez publicado, puedes instalarlo como community node en n8n para usarlo en remoto y compartirlo.

En n8n, ve a community nodes e instala el paquete por su nombre.
Disponible en self-hosted; en cloud solo bajo la versión Enterprise.
Acepta el aviso de nodo no verificado por n8n.
Verifica la instalación: en el canvas, agrega el nodo. Verás un icono que indica que es community node.
Añádelo al workflow, conéctalo a un trigger y ejecuta una prueba (por ejemplo, con un correo de prueba).
Observa la respuesta en la ejecución: si aparece, el nodo remoto funciona.

Conceptos y habilidades: instalación de community nodes, gestión de riesgos de paquetes no verificados, verificación funcional en el workflow y prueba conectada a trigger.

¿Tienes ya tu paquete publicado o una variante que devuelva un texto? Comparte el nombre de tu nodo y el enlace en los comentarios para que otros puedan probarlo y dar feedback.

Gestión avanzada de n8n

Nodos propios e infraestructura escalable en N8N

Requisitos reales del curso avanzado de n8n

Gestionar n8n desde la terminal con CLI

Controla n8n con su API REST

Cómo crear un custom node en n8n

Configuración de credenciales con API key para custom nodes en n8n

Nodo programático en n8n con execute

Publicación de custom nodes de n8n en npmjs para compartir

Despliegue de n8n

Tipos de arquitectura de n8n y cuándo usar cada una

Instalación de n8n con PostgreSQL usando Docker Compose

n8n en Queue Mode con Redis y Docker

N8n en Kubernetes con queue mode

Funcionalidades clave de N8N Enterprise

Publicación de custom nodes de n8n en npmjs para compartir

Progreso del curso

Gestión avanzada de n8n

Despliegue de n8n

Recursos

Recursos