[PR #21] [MERGED] Fix techdocs-builder release job by adding native Node build toolchain #22

New issue

Closed

opened 2026-06-08 09:03:28 +00:00 by ryangr0 · 0 comments

ryangr0 commented

2026-06-08 09:03:28 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/webgrip/infrastructure/pull/21
Author: @Copilot
Created: 5/30/2026
Status: ✅ Merged
Merged: 5/30/2026
Merged by: @Ryangr0

Base: main ← Head: copilot/fix-release-action-failure

📝 Commits (2)

8d80ab4 Initial plan
6586e5b fix(techdocs-builder): add node-gyp build deps in release image build

📊 Changes

1 file changed (+2 additions, -0 deletions)

View changed files

📝 ops/docker/techdocs-builder/Dockerfile (+2 -0)

📄 Description

The Release (ops/docker/techdocs-builder, techdocs-builder) GitHub Actions job was failing during Docker image build. @techdocs/cli transitively installs better-sqlite3, which fell back to node-gyp on Alpine/Node 24 and failed because the required build toolchain was missing.

Root cause
- Docker node stage did not include node-gyp prerequisites (python3, make, g++) before global npm installs.
Change
- Updated ops/docker/techdocs-builder/Dockerfile to install native build dependencies in the node stage prior to:
  - @techdocs/cli@1.9.0
  - @mermaid-js/mermaid-cli@11.4.2

Dockerfile update

RUN corepack enable && corepack prepare npm@latest --activate

RUN apk add --no-cache python3 make g++

RUN npm install -g \
    @techdocs/cli@1.9.0 \
    @mermaid-js/mermaid-cli@11.4.2

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/webgrip/infrastructure/pull/21 **Author:** [@Copilot](https://github.com/apps/copilot-swe-agent) **Created:** 5/30/2026 **Status:** ✅ Merged **Merged:** 5/30/2026 **Merged by:** [@Ryangr0](https://github.com/Ryangr0) **Base:** `main` ← **Head:** `copilot/fix-release-action-failure` --- ### 📝 Commits (2) - [`8d80ab4`](https://github.com/webgrip/infrastructure/commit/8d80ab4e868e556443f65a0efc84024fabdaab09) Initial plan - [`6586e5b`](https://github.com/webgrip/infrastructure/commit/6586e5b38e0946c46e5f975705081b7968f1129b) fix(techdocs-builder): add node-gyp build deps in release image build ### 📊 Changes **1 file changed** (+2 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `ops/docker/techdocs-builder/Dockerfile` (+2 -0) </details> ### 📄 Description The `Release (ops/docker/techdocs-builder, techdocs-builder)` GitHub Actions job was failing during Docker image build. `@techdocs/cli` transitively installs `better-sqlite3`, which fell back to `node-gyp` on Alpine/Node 24 and failed because the required build toolchain was missing. - **Root cause** - Docker `node` stage did not include `node-gyp` prerequisites (`python3`, `make`, `g++`) before global npm installs. - **Change** - Updated `ops/docker/techdocs-builder/Dockerfile` to install native build dependencies in the `node` stage prior to: - `@techdocs/cli@1.9.0` - `@mermaid-js/mermaid-cli@11.4.2` - **Dockerfile update** ```dockerfile RUN corepack enable && corepack prepare npm@latest --activate RUN apk add --no-cache python3 make g++ RUN npm install -g \ @techdocs/cli@1.9.0 \ @mermaid-js/mermaid-cli@11.4.2 ``` --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

ryangr0

2026-06-08 09:03:28 +00:00

closed this issue
added the
pull-request
label

No labels

pull-request

released

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

webgrip/infrastructure#22

No description provided.

Rows
Columns