Improved error message when a required os lib is missing

Abierto
  • ¿Algo no está bien?
#1,651 1 comentario 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 3 días

@OKAN-SOFTWARE ya está trabajando en esto.

Desde el 30/10/2026.

  • #1656 de @OKAN-SOFTWARE — abierto

Evaluación

Dificultad
3/5
Tiempo estimado
1-2 días
Aptitud para principiantes
55/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
github-actions, node.js, typescript, ubuntu
Área
developer-experience, devops

Línea de trabajo

Start by tracing the Node installation and verification flow in the action; the issue does not name specific files or tests. Check how the action handles a failed Node executable and whether it can identify a missing system library such as libatomic1. Done means a failure caused by a missing library gives a clearer error than exit code 127, with relevant tests covering that message.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

feature request

Description:
When trying to upgrade our application from node 24 to 26 the setup node failed with the following error:

Run actions/setup-node@v7
Attempting to download 26.12.1...
Not found in manifest. Falling back to download directly from Node
Acquiring 26.12.1 - x64 from https://nodejs.org/dist/v26.12.1/node-v26.12.1-linux-x64.tar.gz
Extracting ...
/usr/bin/tar xz --strip 1 --warning=no-unknown-keyword --overwrite -C /home/runner/_work/_temp/80f11687-6f0f-4adc-850c-6c97cf44d2e0 -f /home/runner/_work/_temp/e4551be6-f2d4-4553-8e19-c7704a200d29
Adding to the cache ...
Done
Error: Node installation failed. Node may not be installed or not on PATH: The process '/home/runner/_work/_tool/node/26.12.1/x64/bin/node' failed with exit code 127

I figured out that our self hosted runners based on Ubuntu 24.04 did not have the required lib libatomic1 installed. After installing this it worked as expected. This was introduced as a requirement in node 25.

What would be great would be if the action could provide me with a better error message like. Node failed to install because of a missing system lib. Instead of exit code 127

Justification:
To make it easier to find out why the install failed.

Are you willing to submit a PR?

Yes

Lenguaje dominante
TypeScript
Estrellas
5k
Forks
1.7k
Merge medio
2 d 4 h
PR fusionados (30 d)
1

Preparar el entorno

  • Sin Dockerfile ni archivo de Docker Compose
  • Tiene una plantilla de pull request
  • Sin guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de actions/setup-node

Todos los issues de actions/setup-node

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.