Resolución de problemas de Docker
Esta página ofrece orientación para solucionar problemas específicamente para contenedores Docker en Unraid, gestionados por el equipo de Unraid. Para una resolución de problemas avanzada, detalles técnicos en profundidad o temas más allá de la implementación específica de Unraid, consulte la documentación oficial de Docker.
Docker facilita la ejecución de una variedad de aplicaciones en su servidor Unraid, pero pueden surgir problemas, como contenedores que no inician, archivos de imagen de Docker corruptos o problemas de red. Esta página aborda algunos problemas comunes relacionados con Docker en Unraid y ofrece prácticas recomendadas para resolverlos de manera efectiva.
Recrear el archivo de imagen de Docker
Un archivo de imagen de Docker corrupto (docker.img) es un problema común, a menudo causado por el %%cache pool|grupo de caché%% quedándose sin espacio o un apagado incorrecto. Afortunadamente, un contenedor bien configurado almacena todos los datos variables fuera del archivo de imagen (generalmente en el recurso compartido appdata), por lo que puede recrear la imagen sin perder la configuración de su aplicación o datos.
Para recrear el archivo de imagen de Docker:
- Vaya a Settings → Docker en el WebGUI.
- Establece Habilitar Docker en No y haz clic en Aplicar para detener el servicio Docker.
- Seleccione la opción para eliminar el archivo vDisk de Docker y luego haga clic en Aplicar. También puede eliminar el archivo manualmente si es necesario.
- Confirme la ubicación y el nombre de archivo para el nuevo archivo vDisk de Docker. Esta configuración incluye tanto la ruta de la carpeta como el nombre del archivo.
- Establezca el tamaño deseado para el nuevo archivo de imagen. El tamaño predeterminado es típicamente suficiente para la mayoría de los usuarios.
- Configure Habilitar Docker a Sí y haga clic en Aplicar. Unraid creará y formateará un nuevo archivo
docker.imgutilizando BTRFS.
Ahora está listo para reinstalar sus contenedores utilizando sus configuraciones guardadas.
Reinstalación de aplicaciones Docker
Unraid guarda automáticamente una plantilla para cada contenedor instalado en su unidad flash. Estas plantillas almacenan su configuración, lo que facilita restaurar los contenedores después de recrear el archivo de imagen Docker.
Para reinstalar sus contenedores:
- Ve a la pestaña Apps en el WebGUI.
- Abra la sección Aplicaciones Anteriores.
- Seleccione los contenedores que desea reinstalar.
- Proceda con la instalación. Unraid volverá a descargar cada contenedor y aplicará automáticamente su configuración previa.
Este proceso restaura sus contenedores a su estado anterior, siempre que todos los datos variables estuvieran mapeados fuera del archivo de imagen Docker (por ejemplo, en la compartición appdata).
Si un contenedor no se inicia después de reinstalarlo, revise sus registros en el menú contextual de la pestaña Docker para mensajes de error y pistas de resolución de problemas.
Verifique que todas las rutas de host mapeadas existan y tengan los permisos correctos después de restaurar sus contenedores. Las asignaciones o permisos incorrectos son una causa común de problemas de inicio.
Restaurando redes personalizadas de Docker
Las redes Docker personalizadas no persisten si se elimina el archivo de imagen de Docker. Antes de eliminar la imagen, documente los nombres de sus redes personalizadas abriendo un terminal y ejecutando:
docker network ls
Anote los nombres de cualquier red que haya creado (excluyendo las redes predeterminadas bridge, host y none).
Para restaurar las redes personalizadas:
-
Después de recrear el archivo de imagen de Docker, recree cada red personalizada utilizando:
docker network create <network-name>Reemplace
<network-name>con el nombre exacto que registró anteriormente. -
Actualice sus contenedores para que utilicen las redes restauradas según sea necesario.
Puede habilitar el acceso de host a redes personalizadas en Settings → Docker configurando Acceso de host a redes personalizadas en Habilitado si su configuración lo requiere.
Si los contenedores no pueden comunicarse como se esperaba después de la restauración, inspeccione sus configuraciones de red Docker para detectar conflictos o problemas de conectividad.