Doodba - Desarrollo con Docker

Instalación

Esta guía configura un entorno de desarrollo local para proyectos Doodba.

1. Instalar Docker

Instala Docker Engine y Docker Compose plugin según tu distribución.

APT

sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: $(. /etc/os-release && echo '$VERSION_CODENAME')
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

DNF

sudo dnf config-manager addrepo --from-repofile https://download.docker.com/linux/fedora/docker-ce.repo

sudo dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

sudo systemctl enable --now docker

Añade tu usuario al grupo docker para ejecutar Docker sin sudo.

sudo usermod -aG docker $USER

Abre una nueva sesión de terminal antes de continuar para aplicar el cambio de grupo.

Verifica que Docker quedó instalado:

docker --version
docker compose version

2. Instalar pipx

Instala pipx para gestionar herramientas Python aisladas.

APT

sudo apt update

sudo apt install -y pipx

DNF

sudo dnf install -y pipx

Instala las herramientas necesarias para la plantilla:

pipx install copier
pipx install invoke
pipx install pre-commit
pipx ensurepath

3. Creación del proyecto

Genera el proyecto a partir de la plantilla:

copier copy https://github.com/Tecnativa/doodba-copier-template my-project
cd my-project

Inicializa el entorno de desarrollo:

invoke develop

Construye imágenes y agrega repositorios:

invoke img-build --pull
invoke git-aggregate

Prepara base de datos, instala módulos y arranca servicios:

invoke resetdb preparedb install --private start

Verificación

Comprueba que los contenedores estén levantados y revisa logs si hace falta:

docker compose ps
docker compose logs -f

Solución de problemas

• Si Docker da error de permisos, cierra sesión y vuelve a iniciar para aplicar el grupo docker.
• Si copier o invoke no se encuentran, abre una nueva terminal para que pipx ensurepath tome efecto.
• Si falla la construcción de imágenes, vuelve a ejecutar invoke img-build --pull.