fix(cli): say when the Docker image build times out instead of blaming Docker (#5394)

This commit is contained in:
Diego López
2026-10-13 00:07:37 +00:00
committed by GitHub
parent b71c9f4e1b
commit 3bf9035d2a
3 changed files with 85 additions and 11 deletions
@@ -0,0 +1,36 @@
import { normalizeErrorMessage } from "./errorMessage.js";
export const DOCKER_BUILD_TIMEOUT_MINUTES = 10;
interface DockerBuildFailure {
title: string;
message: string;
hint: string;
}
function isSpawnTimeout(error: unknown): boolean {
return error instanceof Error && "code" in error && error.code === "ETIMEDOUT";
}
export function describeDockerBuildFailure(error: unknown): DockerBuildFailure {
if (error instanceof Error && isSpawnTimeout(error.cause)) {
return {
title: "Docker image build timed out",
message: `Building the render image took longer than ${DOCKER_BUILD_TIMEOUT_MINUTES} minutes, so it was stopped.`,
hint: "Run the same command again. Docker keeps the layers it already built, so the build picks up where it stopped.",
};
}
const message = normalizeErrorMessage(error);
if (/connect|not found|ENOENT/i.test(message)) {
return {
title: "Docker not available",
message,
hint: "Install Docker: https://docs.docker.com/get-docker/",
};
}
return {
title: "Docker image build failed",
message,
hint: "Check Docker is running: docker info",
};
}