Saltar a contenido

Docker: API y web de RealTestData ejecutándose en Docker

Esta documentación describe cómo instalar un motor Docker y cómo instalar y ejecutar una imagen local de Docker de la API y web de RealTestData desde Windows, Mac y Linux.

Paso 1: Instalar un IDE o demonio compatible con Docker

En Windows

Opción 1: Docker Desktop (Recomendado)

  1. Descargar Docker Desktop
  2. Visita https://www.docker.com/products/docker-desktop/
  3. Descarga Docker Desktop para Windows

  4. Requiere Windows 10/11 Pro, Enterprise o Education (64 bits)

  5. Instalar Docker Desktop

  6. Ejecuta el instalador como administrador
  7. Sigue el asistente de instalación
  8. Activa la integración con WSL 2 cuando se te solicite

  9. Reinicia el equipo al finalizar la instalación

  10. Iniciar Docker Desktop

  11. Inicia Docker Desktop desde el menú Inicio
  12. Espera a que se inicie el motor Docker (icono de la ballena en la bandeja del sistema)

  13. Deberías ver Estado “Docker Desktop se está ejecutando”

  14. Verificar la instalación

docker --version
docker run hello-world

Opción 2: Docker Engine (solo línea de comandos)

  1. Habilitar WSL 2
# Ejecutar en PowerShell como administrador
wsl --install
  1. Instalar Docker Engine en WSL 2
# En la terminal de WSL 2
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER

Opción 3: Rancher Desktop (alternativa)

  1. Descargar desde https://rancherdesktop.io/
  2. Instalar y configurar con el entorno de ejecución de dockerd
  3. Verificar con docker --version

Requisitos del sistema

  • Windows 10 versión 2004 o superior (compilación 19041 o superior)
  • Función WSL 2 habilitada
  • Virtualización habilitada en la BIOS
  • Al menos 4 GB de RAM (se recomiendan 8 GB)

Solución de problemas

  • Si Docker Desktop no se inicia, asegúrese de que la virtualización esté habilitada en la BIOS.
  • Para problemas con WSL 2, ejecute wsl --update
  • Compruebe las características de Windows: Active/desactive las características de Windows → Habilite “Plataforma de máquina virtual” y “Subsistema de Windows para Linux”.

En Mac

Opción 1: Docker Desktop (recomendado)

  1. Descargar Docker Desktop
  2. Vaya a https://www.docker.com/products/docker-desktop/
  3. Elija la versión adecuada:
  4. Apple Silicon (M1/M2/M3): Descargue “Mac con chip Apple”

  5. Intel Mac: Descargue “Mac con chip Intel”

  6. Instalar Escritorio Docker

  7. Abra el archivo .dmg descargado
  8. Arrastre Docker a la carpeta Aplicaciones
  9. Ejecute Docker desde Aplicaciones

  10. Otorgue los permisos necesarios cuando se le solicite

  11. Iniciar Escritorio Docker

  12. Docker se iniciará automáticamente después de la instalación
  13. Busque el icono de la ballena de Docker en la barra de menú

  14. Haga clic en el icono para ver “Docker Desktop se está ejecutando”

  15. Verificar la instalación

docker --version
docker run hello-world

Opción 2: Motor Docker mediante Homebrew

  1. Instalar Homebrew (si aún no está instalado)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  1. Instalar Docker
brew install docker
brew install docker-compose
  1. Iniciar Docker Servicio
brew services start docker

Opción 3: Rancher Desktop (Alternativa)

  1. Descargar desde https://rancherdesktop.io/
  2. Instalar el paquete .dmg
  3. Configurar con el entorno de ejecución de dockerd
  4. Verificar con docker --version

Requisitos del sistema (Mac)

  • macOS 10.15 o posterior
  • Al menos 4 GB de RAM (se recomiendan 8 GB)
  • No se debe instalar VirtualBox anterior a la versión 4.3.30

En Linux

Opción 1: Docker Engine (Repositorio oficial)

Para Ubuntu/Debian: 1. Actualizar el índice de paquetes

sudo apt-get update
sudo apt-get install ca-certificates curl gnupg lsb-release
  1. Añadir la clave GPG oficial de Docker
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
  1. Configurar el repositorio
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
  1. Instalar Docker Engine
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
  1. Añadir usuario al grupo de Docker
sudo usermod -aG docker $USER
newgrp docker

Para CentOS/RHEL/Fedora: 1. Instalar usando yum/dnf

# CentOS/RHEL
sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# Fedora
sudo dnf -y install dnf-plugins-core
sudo dnf config-manager --add-repo 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
  1. Iniciar el servicio Docker
sudo system

ctl start docker
sudo systemctl enable docker
  1. Añadir usuario al grupo de Docker
sudo usermod -aG docker $USER

Opción 2: Docker Desktop para Linux

  1. Descargar desde https://www.docker.com/products/docker-desktop/
  2. Instalar el paquete
# Ubuntu/Debian
sudo dpkg -i docker-desktop-<versión>-<arquitectura>.deb

# RHEL/Fedora
sudo rpm -i docker-desktop-<versión>-<arquitectura>.rpm

Opción 3: Script de instalación rápida

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER

Requisitos del sistema (Linux)

  • Compatibilidad con kernel de 64 bits y CPU para virtualización
  • Compatibilidad con virtualización KVM
  • QEMU debe ser la versión 5.2 o posterior
  • systemd init system
  • Al menos 4 GB de RAM (se recomiendan 8 GB)

Verificar la instalación (todas las plataformas)

Tras la instalación en cualquier plataforma, verifique el funcionamiento de Docker:

docker --version
docker run hello-world
docker ps

Debería ver: - Información de la versión de Docker - Mensaje “¡Hola desde Docker!” - Lista de contenedores vacía (inicialmente)

Paso 2: Descargar y ejecutar las imágenes de Docker de RealTestData

RealTestData tiene dos imágenes de Docker y varios volúmenes de Docker con datos. Para instalar y ejecutar las imágenes como contenedores, proporcionamos un script para Windows y Mac/Linux.

Al descargar nuestro paquete API-WEB, se incluyen 4 archivos:

  • rtdall-start.bat para Windows
  • rtdall-start.sh para Mac/Linux

Al ejecutar este script, las imágenes se descargarán o actualizarán desde DockerHub. Las imágenes RTDVOLS descargan/actualizan todos los volúmenes necesarios y los añaden al repositorio local de volúmenes o los actualizan en él.

  • rtdall-start-container.bat para Windows
  • rtdall-start-container.sh para Mac/Linux

Estos scripts sirven solo para iniciar los contenedores en caso de que se detengan. No es necesario ejecutar rtdall-start una segunda vez, ya que todo está disponible localmente y actualizado.

Actualice todos los volúmenes periódicamente.

Verificar recursos de Docker disponibles localmente

Antes de ejecutar los scripts, puede verificar qué imágenes y volúmenes de Docker ya están disponibles localmente:

Verificar imágenes de Docker

# Listar todas las imágenes locales de Docker
docker images

# Verificar una imagen específica
docker images realtestdata/rtdapi
docker images realtestdata/rtdweb
docker images realtestdata/rtdvols

Verificar volúmenes de Docker

# Listar todos los volúmenes locales de Docker
docker volume ls

# Obtener información detallada sobre un volumen específico
docker volume inspect configdata
docker volume inspect resultdata

Verificar contenedores en ejecución

# Listar todos los contenedores en ejecución
docker ps

# Listar todos los contenedores (en ejecución y detenidos)
docker ps -a

Verificar redes de Docker

# Listar todos Redes
docker network ls

Resumen completo del sistema

# Obtener información completa del sistema Docker
docker system df

# Mostrar el uso del disco por componentes de Docker
docker system df -v

# Mostrar información detallada del sistema
docker info

Recursos locales esperados

Después de ejecutar correctamente los scripts de configuración, debería ver:

Imágenes: - realtestdata/rtdapi:latest - realtestdata/rtdweb:latest - realtestdata/rtdvols:latest

Volúmenes: - configdata - resultdata - database - full - trial - doc

Red: - rtdnet

Contenedores en ejecución: - rtdapi-container (puerto 8000) - rtdweb-container (puerto 5000)

Paso 3 - Ejecutar el cliente web de RealTestData

Antes de acceder a la interfaz web, compruebe si la API se está ejecutando: localhost:8000 debería mostrar “Esta es la API de RealTestData”.

Ahora abra el navegador web que prefiera e introduzca localhost:5000 como URL.

Debería ver la página principal de RealTestData.

Para iniciar sesión, debe registrarse. Se creará un usuario de prueba.

Ya existen dos usuarios de prueba: trial/trial test/test

Puede crear hasta dos usuarios de prueba.

Con “Generar” puede generar el archivo de resultados que se descarga.

Una vez que funcione, revise las diferentes configuraciones.

Paso 4 - Usar la API sin el cliente web

Puede usar la API sin el cliente web.

Puede encontrar un ejemplo de Python en el archivo zip: RealTestData_API_Generate.py. Al llamar a la API en un navegador web e introducir localhost:8000/docs/en, encontrará la documentación de la API en inglés (o de - alemán o cz - checo).

Al llamar a localhost:8000/generate_live, se generarán los datos especificados en el cliente web como un flujo JSON. Puede integrar este flujo en su canalización de CI/CD.