documentation.suse.com / Documentación de SUSE Edge / Solución de problemas / Resolución de problemas de Edge Image Builder (EIB)

46 Resolución de problemas de Edge Image Builder (EIB)

EIB se usa para crear imágenes personalizadas de SUSE Edge.

Problemas comunes
  • Código erróneo del SCC: asegúrese de que el código del Centro de servicios al cliente de SUSE utilizado en el archivo de definición de EIB coincida con la versión y la arquitectura de SL Micro.

  • Faltan dependencias: asegúrese de que no falte ningún paquete o herramienta en el entorno de creación.

  • Tamaño de imagen incorrecto: para las imágenes raw, se requiere el parámetro diskSize, que depende en gran medida de las imágenes, los RPM y otros artefactos incluidos en la imagen.

  • Permisos: si almacena un guion en el directorio custom/files, asegúrese de que tenga permisos de ejecución, ya que esos archivos solo están disponibles cuando se ejecuta Combustion, pero EIB no realiza ningún cambio.

  • Dependencias del grupo del sistema operativo: al crear una imagen con usuarios y grupos personalizados, los grupos que se definan como primaryGroup deben crearse explícitamente.

  • Las claves SSH de los usuarios del sistema operativo requieren una carpeta de inicio: al crear una imagen con usuarios con claves SSH, también es necesario crear la carpeta de inicio con createHomeDir=true.

  • Problemas de Combustion: EIB utiliza Combustion para la personalización del sistema operativo y el despliegue de todos los demás componentes de SUSE Edge. Esto también incluye guiones personalizados que se colocan en la carpeta custom/scripts. Tenga en cuenta que el proceso Combustion se ejecuta en el momento de initrd, por lo que el sistema no está completamente arrancado cuando se ejecutan los guiones.

  • Tamaño de la máquina de Podman: como se explica en la sección de consejos y trucos de EIB (Parte IV, “Consejos y trucos”), compruebe que la máquina de Podman tenga suficiente CPU/memoria para ejecutar el contenedor de EIB en sistemas operativos que no sean Linux.

Registros
  • Salida de EIB: el resultado del panel de control del comando eib build es fundamental.

  • Registros del contenedor de creación: compruebe los registros del contenedor de creación. Los registros se generan en el directorio que se utilizó para almacenar los artefactos. Compruebe también los registros de Docker o Podman para obtener la información necesaria.

    Nota
    Nota

    Para obtener más información, consulte la sección Debugging (Depuración).

  • Directorios temporales de creación: EIB crea directorios temporales durante el proceso de creación. Compruebe si hay registros intermedios o artefactos en ellos si el resultado principal es insuficiente.

  • Registros de Combustion: si la imagen que se está creando con EIB no arranca por cualquier motivo, hay disponible una shell raíz. Conéctese al panel de control del host (ya sea físicamente, a través de BMC, etc.) y compruebe los registros de Combustion con journalctl -u combustion y, en general, todos los registros del sistema operativo con journalctl para encontrar la causa raíz del fallo.

Pasos para resolver problemas
  1. Revise el resultado de eib-build: el mensaje de error que aparece en el panel de control suele ser muy explicativo.

  2. Compruebe el entorno de creación: asegúrese de que se cumplen todos los requisitos previos de EIB (por ejemplo, docker/podman, espacio suficiente en disco) en el equipo donde se ejecuta EIB.

  3. Inspeccione los registros del contenedor de creación: revise los registros del contenedor que ha fallado para obtener información más detallada sobre los errores (véase más arriba).

  4. Verifique la configuración de eib: compruebe bien el archivo de configuración eib para detectar posibles errores ortográficos o rutas incorrectas a los archivos de origen o a los guiones de creación.

    • Pruebe los componentes individualmente: si su versión EIB incluye guiones o etapas personalizados, ejecútelos de forma independiente para aislar los fallos.

Nota
Nota

Consulte la sección Edge Image Builder Debugging (Depuración de Edge Image Builder).

Documentation survey