Use debian-based builder image for bulding Linux glibc images (#228)

* Use debian based docker image for builds

* Change version for testing

* Use just one builder

* Revert version changes (which were only for testing)

Author: milindl

.semaphore/build-docker.sh renamed to .semaphore/build-docker-alpine.sh

@@ -0,0 +1,11 @@
+#!/bin/sh
+
+export DEBIAN_FRONTEND=noninteractive
+export NEEDRESTART_MODE=a
+apt update
+apt install -y gcc make build-essential
+
+# /v is the volume mount point for the project root
+cd /v
+npm ci
+npx node-pre-gyp package

.semaphore/build-docker-debian.sh

@@ -45,7 +45,7 @@ blocks:
       jobs:
         - name: "Build from source and test for musl"
           commands:
-            - docker run -v "$(pwd):/v" node:18-alpine /v/.semaphore/build-docker.sh
+            - docker run -v "$(pwd):/v" node:18-alpine /v/.semaphore/build-docker-alpine.sh
 
   - name: "Linux arm64 (musl): Build and test"
     dependencies: [ ]
@@ -59,7 +59,7 @@ blocks:
       jobs:
         - name: "Build from source and test for musl"
           commands:
-              - docker run -v "$(pwd):/v" node:18-alpine /v/.semaphore/build-docker.sh
+              - docker run -v "$(pwd):/v" node:18-alpine /v/.semaphore/build-docker-alpine.sh
 
   - name: "Linux arm64: Build and test"
     dependencies: [ ]
@@ -183,10 +183,8 @@ blocks:
           commands:
             - export NODE_VERSION=$(echo $NODE_VERSION_ABI | cut -d, -f1)
             - export NODE_ABI=$(echo $NODE_VERSION_ABI | cut -d, -f2)
-            - sem-version node $NODE_VERSION
             - export ARTIFACT_KEY="confluent-kafka-javascript-${SEMAPHORE_GIT_TAG_NAME}-node-v${NODE_ABI}-${PLATFORM}-${LIBC}-${ARCHITECTURE}.tar.gz"
-            - npm ci # node-pre-gyp will fallback to build here, because new tag implies no release yet.
-            - npx node-pre-gyp package
+            - docker run -v "$(pwd):/v" node:${NODE_VERSION}-bullseye /v/.semaphore/build-docker-debian.sh
             - ls build/stage/${SEMAPHORE_GIT_TAG_NAME}/${ARTIFACT_KEY}
             - artifact push workflow "build/stage/${SEMAPHORE_GIT_TAG_NAME}/${ARTIFACT_KEY}" --destination "releases/${SEMAPHORE_GIT_TAG_NAME}/${ARTIFACT_KEY}"
 
@@ -221,10 +219,8 @@ blocks:
           commands:
             - export NODE_VERSION=$(echo $NODE_VERSION_ABI | cut -d, -f1)
             - export NODE_ABI=$(echo $NODE_VERSION_ABI | cut -d, -f2)
-            - sem-version node $NODE_VERSION
             - export ARTIFACT_KEY="confluent-kafka-javascript-${SEMAPHORE_GIT_TAG_NAME}-node-v${NODE_ABI}-${PLATFORM}-${LIBC}-${ARCHITECTURE}.tar.gz"
-            - npm ci # node-pre-gyp will fallback to build here, because new tag implies no release yet.
-            - npx node-pre-gyp package
+            - docker run -v "$(pwd):/v" node:${NODE_VERSION}-bullseye /v/.semaphore/build-docker-debian.sh
             - ls build/stage/${SEMAPHORE_GIT_TAG_NAME}/${ARTIFACT_KEY}
             - artifact push workflow "build/stage/${SEMAPHORE_GIT_TAG_NAME}/${ARTIFACT_KEY}" --destination "releases/${SEMAPHORE_GIT_TAG_NAME}/${ARTIFACT_KEY}"
 
@@ -260,7 +256,7 @@ blocks:
             - export NODE_VERSION=$(echo $NODE_VERSION_ABI | cut -d, -f1)
             - export NODE_ABI=$(echo $NODE_VERSION_ABI | cut -d, -f2)
             - export ARTIFACT_KEY="confluent-kafka-javascript-${SEMAPHORE_GIT_TAG_NAME}-node-v${NODE_ABI}-linux-${LIBC}-${ARCHITECTURE}.tar.gz"
-            - docker run -v "$(pwd):/v" node:${NODE_VERSION}-alpine /v/.semaphore/build-docker.sh
+            - docker run -v "$(pwd):/v" node:${NODE_VERSION}-alpine /v/.semaphore/build-docker-alpine.sh
             - ls build/stage/${SEMAPHORE_GIT_TAG_NAME}/${ARTIFACT_KEY}
             - artifact push workflow "build/stage/${SEMAPHORE_GIT_TAG_NAME}/${ARTIFACT_KEY}" --destination "releases/${SEMAPHORE_GIT_TAG_NAME}/${ARTIFACT_KEY}"
 
@@ -296,7 +292,7 @@ blocks:
             - export NODE_VERSION=$(echo $NODE_VERSION_ABI | cut -d, -f1)
             - export NODE_ABI=$(echo $NODE_VERSION_ABI | cut -d, -f2)
             - export ARTIFACT_KEY="confluent-kafka-javascript-${SEMAPHORE_GIT_TAG_NAME}-node-v${NODE_ABI}-linux-${LIBC}-${ARCHITECTURE}.tar.gz"
-            - docker run -v "$(pwd):/v" node:${NODE_VERSION}-alpine /v/.semaphore/build-docker.sh
+            - docker run -v "$(pwd):/v" node:${NODE_VERSION}-alpine /v/.semaphore/build-docker-alpine.sh
             - ls build/stage/${SEMAPHORE_GIT_TAG_NAME}/${ARTIFACT_KEY}
             - artifact push workflow "build/stage/${SEMAPHORE_GIT_TAG_NAME}/${ARTIFACT_KEY}" --destination "releases/${SEMAPHORE_GIT_TAG_NAME}/${ARTIFACT_KEY}"
 

.semaphore/semaphore.yml

@@ -29,10 +29,22 @@ To use **Schema Registry**, use the [@confluentinc/schemaregistry](https://www.n
 
 The following configurations are supported:
 
-* Any supported version of Node.js (The two LTS versions, 18 and 20, and the latest versions, 21, 22 and 23).
-* Linux (x64 and arm64) - both glibc and musl/alpine.
-* macOS - arm64/m1. macOS (Intel) is supported on a best-effort basis.
-* Windows - x64.
+* Linux (x64 and arm64) - we support both musl and glibc based distributions:
+
+| Distribution                              | Supported Node Versions |
+| ----------------------------------------- | ----------------------- |
+| Debian Bullseye/Ubuntu 20.04              | 18, 20, 21, 22, 23      |
+| Debian Bookworm/Ubuntu 22.04              | 18, 20, 21, 22, 23      |
+| Alpine Linux 3.20+                        | 18, 20, 21, 22, 23      |
+| AlmaLinux 9/Rocky Linux 9/CentOS Stream 9 | 18, 20, 21, 22, 23      |
+
+Other distributions will probably work given a modern version of gcc/glibc, but we don't test the pre-built binaries with them.
+
+* macOS - arm64/m1. macOS (Intel) is supported on a best-effort basis. Node versions 18, 20, 21, 22, and 23 are supported.
+* Windows - x64. Node versions 18, 20, 21, 22, and 23 are supported.
+
+> [!WARNING]
+> Pre-built binary support will be dropped after the EOL of the node version or the OS.
 
 Installation on any of these platforms is meant to be seamless, without any C/C++ compilation required.