documentation.suse.com / Documentação do SUSE Edge / Solução de problemas / Solução de problemas do Kiwi

45 Solução de problemas do Kiwi

O Kiwi é usado para gerar as imagens atualizadas do SUSE Linux Micro que serão usadas com o Edge Image Builder.

Problemas comuns
  • Incompatibilidade de versões do SL Micro: a versão do sistema operacional do host de build deve ser compatível com a versão do sistema operacional que está sendo criada (host do SL Micro 6.0 → imagem do SL Micro 6.0).

  • SELinux no estado de imposição: devido a algumas limitações, é necessário desabilitar o SELinux temporariamente para criar imagens com o Kiwi. Verifique o status do SElinux com o comando getenforce e desabilite-o antes de executar o processo de criação com setenforce 0.

  • Host de build não registrado: o processo de build usa os registros dos hosts de build para obter os pacotes do SUSE SCC. Se o host não foi registrado, o processo falha.

  • Falha no teste do dispositivo em loop: na primeira execução do processo de criação do Kiwi, ocorre uma falha logo depois que ele é iniciado com o erro: "ERROR: Early loop device test failed, please retry the container run." (ERRO: Falha no teste do dispositivo no ciclo inicial. Tente executar o contêiner novamente.). Trata-se de um sintoma em que os dispositivos que são criados em loop no sistema host subjacente não ficam imediatamente visíveis dentro da imagem do contêiner. Execute novamente o processo de criação do Kiwi, e ele deverá prosseguir sem problemas.

  • Permissões ausentes: o processo de build espera sua execução como usuário root (ou via sudo).

  • Privilégios incorretos: o processo de build espera o sinalizador --privileged ao executar o contêiner. Certifique-se de que ele esteja presente.

Registros
  • Registros do contêiner de build: consulte os registros do contêiner de build. Os registros são gerados no diretório que foi usado para armazenar os artefatos. Consulte também os registros do docker ou do podman para ver as informações necessárias.

  • Diretórios temporários de build: o Kiwi cria diretórios temporários durante o processo de build. Consulte-os para acessar os registros ou os artefatos intermediários se a saída principal não for suficiente.

Etapas da solução de problemas
  1. Revise a saída de build-image: a mensagem de erro na saída do console costuma ser muito clara.

  2. Verifique o ambiente do build: garanta que todos os pré-requisitos para o próprio Kiwi (por exemplo, docker/podman, SElinux, espaço em disco suficiente) sejam atendidos na máquina que executa o Kiwi.

  3. Analise os registros do contêiner de build: revise os registros do contêiner com falha para verificar os erros em mais detalhes (veja acima).

  4. Verifique o arquivo de definição: se você usa um arquivo de definição de imagem do Kiwi personalizado, revise-o para garantir que não haja erros de sintaxe ou ortografia.

Nota
Nota

Consulte o Guia de Solução de Problemas do Kiwi (em inglês).

Documentation survey