Solución de problemas
troubleshooting.RmdSolución de Problemas
La mayoría de los problemas de configuración ocurren porque Docker no está en ejecución, la imagen aún no se ha descargado o el puerto 3838 ya está siendo usado por otro contenedor.
Docker Desktop No Está en Ejecución
Abra Docker Desktop y espere hasta que el indicador de estado muestre que Docker está en ejecución. Esto puede tardar uno o dos minutos.
En Windows, Docker puede pedirle que termine la configuración de WSL 2 o que reinicie la computadora. Complete esos mensajes antes de intentar ejecutar MicroHub.
No Se Encuentra la Imagen de MicroHub
En Docker Desktop, vaya a la pestaña Images y busque
cdcgov/microhub.
Si no la ve:
- Compruebe que escribió el nombre exactamente como
cdcgov/microhub. - Asegúrese de que la búsqueda de Images esté buscando imágenes remotas, no solo imágenes locales ya presentes en su computadora.
- Busque de nuevo y seleccione la etiqueta
v2.0.0. - Haga clic en Pull y espere a que termine la descarga.
Si una persona facilitadora le pide usar la línea de comandos, abra PowerShell en Windows o Terminal en macOS/Linux y ejecute:
Después de que termine la descarga, regrese a Docker Desktop y revise la pestaña Images.
El Puerto 3838 Ya Está en Uso
Esto significa que otra aplicación o contenedor ya está usando la misma dirección del navegador que MicroHub quiere usar.
En Docker Desktop, vaya a la pestaña Containers y
detenga cualquier otro contenedor de MicroHub o Shiny que esté en
ejecución. Luego inicie MicroHub de nuevo con el puerto de host
3838 y el puerto de contenedor 3838.
Si se requiere un puerto de host diferente, use ese número en la URL del navegador. Por ejemplo, el puerto de host
3839significa abrirhttp://localhost:3839.
El Navegador Dice que No Puede Acceder a la Aplicación
- Confirme que el contenedor de MicroHub está en ejecución en Docker Desktop.
- Confirme que los puertos de host y contenedor están configurados
como
3838. - Abra http://localhost:3838, no una URL de un sitio web público.
- Si el contenedor se detuvo, abra sus registros en Docker Desktop y comparta el primer error visible con una persona facilitadora.
Si la página aún no abre, detenga el contenedor microhub
en Docker Desktop, vuelva a iniciarlo y actualice la página del
navegador.
Docker Desktop Le Pide Iniciar Sesión
No se requiere una cuenta de Docker para el taller. Si Docker Desktop muestra una pantalla de inicio de sesión, busque una opción para continuar sin iniciar sesión, omitir el inicio de sesión o usar Docker Desktop sin una cuenta.
Falla la Carga del CSV
Revise que el archivo tenga exactamente las columnas requeridas y que no haya filas de encabezado adicionales encima de los nombres de columnas.
| Columna requerida | Ejemplo |
|---|---|
date |
2026-05-16 o 5/16/26
|
target_group |
Overall |
value |
42 |
Una Ejecución de Modelo Es Lenta
Algunos modelos tardan más que las líneas base, especialmente en computadoras portátiles o notebooks con memoria o CPU limitadas. Durante los ejercicios del taller, comience con modelos de línea base y Copycat antes de ejecutar modelos más pesados. Cierre aplicaciones no usadas si la computadora tiene presión de memoria.