🐳 Pràctica: Introducció a Docker amb Odoo 17

🎯 Objectius

• Entendre què és Docker i per què s’utilitza.
• Veure la diferència entre una instal·lació tradicional i una amb contenidors.
• Aprendre a engegar, parar i gestionar Odoo utilitzant Docker Compose.
• Investigar com es guarden les dades i addons quan Odoo treballa dins contenidors.
• Preparar-vos per crear i testejar mòduls propis en un entorn professional.

📘 Conceptes previs

🔹 Què és Docker?

Docker permet crear contenidors, que són com “mini ordinadors” aïllats dins del teu sistema. Cada contenidor té:

• El seu propi sistema de fitxers.
• La seva configuració.
• La seva aplicació (Odoo, Postgres, etc.).

Això evita problemes típics com “a mi no m’arrenca”, “em falta una dependència”, o “la versió de Python no coincideix”.

🔹 Què és Docker Compose?

Docker Compose és una eina que permet posar en marxa diversos contenidors alhora. Per exemple:

• 1 contenidor per a Odoo.
• 1 contenidor per a Postgres.

Tot això s’especifica en un sol fitxer: docker-compose.yml.

🧪 Activitat 1 — Instal·lar Docker i Odoo dsd Plantilla Isard

1️⃣ Desde Isard, una vegada creada la màquina, obrir la terminal...

cd Escriptori/
        bash scriptfinal.sh

2️⃣ Tancar la terminal i Obrir una nova terminal

cd Escriptori/odoo-docker/
        sudo docker compose up -d

2️⃣ Obrir Odoo al navegador

http://localhost:8069

🧪 Activitat 2 — Gestionar contenidors

1️⃣ Veure tots els contenidors en execució

sudo docker ps

2️⃣ Aturar Odoo

sudo docker compose stop

3️⃣ Tornar-lo a arrencar

sudo docker compose start

🧪 Activitat 3 — Volums i persistència

Docker utilitza volums per guardar dades fora del contenidor, de manera que si el contenidor s’elimina, les dades es mantinguin.

1️⃣ Llistar volums

sudo docker volume ls

2️⃣ Inspeccionar un volum

sudo docker volume inspect odoo-docker_odoo-db-data

🧪 Activitat 4 — Afegir un mòdul personalitzat

1️⃣ Crear la carpeta del mòdul

mkdir -p addons/escola

2️⃣ Tornar a arrencar els contenidors

sudo docker compose restart

3️⃣ Actualitzar la llista d’aplicacions a Odoo

1. Accediu a Odoo com a administrador.
2. Aneu a Settings i abaix de tot
3. Activate the developer mode
4. Feu clic a Update Apps List (Actualitzar llista d’aplicacions).
5. Busqueu el mòdul escola i no hi ha res

4️⃣ Crear el mòdul escola amb scaffold dins Docker

Assegura’t que els contenidors estan en marxa:

cd ~/Escriptori/odoo-docker
sudo docker compose up -d

Mira el nom del contenidor d’Odoo:

sudo docker ps

Dona permisos a la carpeta addons

sudo chmod -R 777 addons

Et sortirà una cosa semblant a:

CONTAINER ID   NAME                   ...
abc123...      odoo-docker-web-1      ...

Fixa’t en el NAME (normalment odoo-docker-web-1).

Entra dins del contenidor d’Odoo:

sudo docker exec -it odoo-docker-web-1 bash

(Si el teu nom és diferent, posa el que surti a docker ps.)

Dins del contenidor, crea el mòdul amb scaffold a la ruta dels addons extra:

odoo scaffold escola /mnt/extra-addons

Això crearà una estructura com:

/mnt/extra-addons/escola/__manifest__.py
/mnt/extra-addons/escola/__init__.py
/mnt/extra-addons/escola/models/...
/mnt/extra-addons/escola/views/...

Surt del contenidor:

exit

Reinicia Odoo

sudo docker compose restart

Torna a Odoo (navegador), activa el Developer Mode (com ja has fet), ves a Apps → Update Apps List, actualitza i després cerca escola.

Ara sí que t’hauria d’aparèixer el mòdul Escola a la llista d’Apps.

🧪 Activitat 5 — Entrar dins els contenidors

1️⃣ Entrar al contenidor d’Odoo

sudo docker exec -it odoo-docker-web-1 bash

Això obrirà una terminal dins del contenidor d’Odoo.

🧪 Activitat 6 — Què passa si eliminem un contenidor?

1️⃣ Eliminar contenidors

docker compose down

2️⃣ Tornar-los a crear

docker compose up -d