Pràctica 2: Instal·lació i Configuració de n8n

Objectiu

Desplegar n8n amb Docker, configurar-lo correctament i demostrar que l'entorn està llest per a les pràctiques següents.

Enunciat

Configura un entorn n8n complet amb:

1. n8n executant-se amb docker-compose
2. Dades persistents en un volum local
3. Variables d'entorn correctament configurades
4. Un workflow de test que verifica que l'entorn funciona

Tasca 1: Preparar l'entorn Docker

Crea l'estructura de directoris i el fitxer docker-compose.yml per al teu entorn personal de n8n.

El docker-compose ha d'incloure obligatoriament:

• Imatge oficial de n8n (versió específicada, no :latest)
• Nom del contenidor: n8n-[el-teu-nom] (ex: n8n-anna-garcia)
• Port mapejat: 5678:5678
• Variable GENERIC_TIMEZONE amb Europe/Madrid
• Variable N8N_ENCRYPTION_KEY amb una clau única de 32 caràcters
• Volum local per a persistència de dades

Versió específica

Per a entorns de pràctiques, usa una versió específica: docker.n8n.io/n8nio/n8n:1.94.1 (o la darrera versió estable en el moment de la pràctica). Consulta les versions a hub.docker.com/r/n8nio/n8n/tags.

Tasca 2: Primer accés i configuració del compte

Un cop n8n està en marxa:

1. Obre http://localhost:5678 al navegador
2. Crea el compte d'administrador amb les teves dades
3. Explora la interfície (5 minuts de navegació lliure)
4. Canvia el tema a "Dark mode" (si ho prefereixes)

Tasca 3: Workflow de verificació

Crea un workflow anomenat verificació entorn [el teu nom] que:

1. S'activi amb un Manual Trigger
2. Tingui un node Code que retorni la informació del sistema:

return [{
  json: {
    n8n_ok: true,
    alumne: "el-teu-nom",
    data_verificacio: new Date().toISOString(),
    entorn: "local-docker",
    missatge: "Entorn n8n configurat correctament"
  }
}];

1. Tingui un node final Set que afegeixi el camp verificat: true
2. Executa el workflow i verifica que funciona

Tasca 4: Explorar les Executions

Executa el workflow 3 vegades i:

1. Obre el panell d'execucions
2. Verifica que les 3 execucions apareixen
3. Fes clic a la primera i revisa els detalls

Lliurament

Lliura al campus virtual:

• Fitxer docker-compose.yml (amb la clau de xifrat substituida per [REDACTED])
• Captura del panell principal de n8n amb el compte configurat
• Captura del workflow de verificació executant-se correctament
• Captura del panell d'execucions mostrant les 3 execucions
• Fitxer JSON exportat del workflow

Rúbrica d'avaluació PRN8N02

Criteri	Insuficient (0-4)	Suficient (5-6)	Notable (7-8)	Excel·lent (9-10)
docker-compose correcte	No funciona o falta	Funciona amb errors	Funciona correctament	Complet, amb versió específica i opcions de seguretat
Configuració de compte	No configurat	Configurat bàsicament	Configurat correctament	Configurat amb dades correctes i ajustaments opciónals
Workflow de verificació	No creat	Creat però no funciona	Funciona correctament	Funciona correctament amb camps addicionals
Executions visibles	Cap execució	1 execució	2-3 execucions	3+ execucions amb detalls revisats
documentació lliurada	Cap	Parcial	Completa	Completa i ben organitzada