1 minute read

Read this post in English: Fixing npm EXDEV Errors in Docker Containers.

Ao trabalhar em um projeto, usei um Dockerfile para instalar dependências e compilar uma aplicação Angular 9. Este artigo registra um erro EXDEV que encontrei e a solução temporária que tentei. O comportamento do Docker e do npm varia conforme as versões e a configuração do build; trate o exemplo como uma situação de diagnóstico, não como uma correção universal.

O que significa o erro npm EXDEV

O erro EXDEV indica que uma operação atravessou o limite entre sistemas de arquivos. Ele não é específico do Docker; a causa exata depende do npm, do sistema de arquivos e de como as camadas da imagem são usadas. No meu caso, apareceu ao modificar arquivos relacionados ao npm durante o build do contêiner.

Mais especificamente, o erro pode ocorrer quando o npm tenta renomear um arquivo entre sistemas de arquivos. A operação de renomeação é atômica apenas dentro do mesmo sistema de arquivos; ao atravessar esse limite, pode ocorrer EXDEV (link entre dispositivos).

Uma solução temporária discutida nesta issue do npm era mover o diretório antes da instalação:

RUN mv ./node_modules ./node_modules.tmp \
  && mv ./node_modules.tmp ./node_modules \
  && npm install

Essa solução contornou o problema no ambiente específico que encontrei; não é uma correção geral para Docker. Sistemas de arquivos de contêiner usam camadas e o comportamento de renomeação varia entre sistemas e montagens. Antes de adotar a solução, reproduza o erro nas versões atuais do Node.js e npm e verifique em quais sistemas de arquivos estão os caminhos envolvidos. Prefira um fluxo de instalação e build suportado que produza as dependências na mesma camada de sistema de arquivos em que serão usadas.

Mantenha os builds de contêiner reproduzíveis

Contêineres são substituíveis; portanto, as dependências de build devem ser reproduzidas a partir do código-fonte e dos arquivos de lock. Gere os artefatos necessários durante o build da imagem ou inclua-os no contexto de build. Passe segredos em tempo de execução por um mecanismo apropriado de gerenciamento de segredos; não os grave na imagem.

Updated: