Build Linux releases with musl target

Author: future0923

.github/workflows/ci.yml

@@ -42,6 +42,9 @@ jobs:
         working-directory: frontend
         run: npm run build
 
+      - name: Test release packaging script
+        run: node --test scripts/package-release.test.mjs
+
       - name: Test backend
         working-directory: backend
         run: cargo test

.github/workflows/release.yml

@@ -31,10 +31,12 @@ jobs:
           - package: linux_amd64
             platform: linux
             os: ubuntu-latest
+            rust_target: x86_64-unknown-linux-musl
             asset: dist/*.tar.gz
           - package: linux_arm64
             platform: linux
             os: ubuntu-24.04-arm
+            rust_target: aarch64-unknown-linux-musl
             asset: dist/*.tar.gz
 
     runs-on: ${{ matrix.os }}
@@ -53,12 +55,21 @@ jobs:
       - name: Setup Rust
         uses: dtolnay/rust-toolchain@stable
 
+      - name: Install Rust target
+        if: matrix.platform == 'linux'
+        run: rustup target add ${{ matrix.rust_target }}
+
+      - name: Install Linux musl toolchain
+        if: matrix.platform == 'linux'
+        run: sudo apt-get update && sudo apt-get install -y musl-tools
+
       - name: Build package
         run: node scripts/package-release.mjs
         env:
           VERSION: ${{ github.ref_type == 'tag' && github.ref_name || '0.1.0' }}
           RELEASE_PLATFORM: ${{ matrix.platform }}
           RELEASE_PACKAGE_SUFFIX: ${{ matrix.package }}
+          CARGO_BUILD_TARGET: ${{ matrix.rust_target }}
 
       - name: Upload release assets
         uses: softprops/action-gh-release@v2

scripts/package-release.mjs

@@ -1,14 +1,15 @@
 import { mkdir, rm, cp, chmod, writeFile } from 'node:fs/promises'
 import { basename, dirname, join, resolve } from 'node:path'
-import { fileURLToPath } from 'node:url'
+import { fileURLToPath, pathToFileURL } from 'node:url'
 import { spawnSync } from 'node:child_process'
 
-const rootDir = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+export const rootDir = resolve(dirname(fileURLToPath(import.meta.url)), '..')
 const appName = 'log-search'
 const version = (process.env.VERSION || '0.1.0').replace(/^v/, '')
 const platform = process.env.RELEASE_PLATFORM || process.platform
 const arch = process.env.RELEASE_ARCH || normalizedArch(process.arch)
 const packageSuffix = process.env.RELEASE_PACKAGE_SUFFIX || `${platform}-${arch}`
+const cargoTarget = process.env.CARGO_BUILD_TARGET || ''
 const distDir = join(rootDir, 'dist')
 const releaseName = `${appName}_${version}_${packageSuffix}`
 const releaseDir = join(distDir, releaseName)
@@ -31,6 +32,20 @@ function run(command, args, options = {}) {
   }
 }
 
+export function cargoBuildArgs(target = cargoTarget) {
+  const args = ['build', '--release']
+  if (target) {
+    args.push('--target', target)
+  }
+  return args
+}
+
+export function cargoReleaseDir(target = cargoTarget) {
+  return target
+    ? join(rootDir, 'backend', 'target', target, 'release')
+    : join(rootDir, 'backend', 'target', 'release')
+}
+
 async function copyIfExists(source, target) {
   try {
     await cp(source, target, { recursive: true })
@@ -46,11 +61,11 @@ async function build() {
 
   run('npm', ['ci'], { cwd: join(rootDir, 'frontend') })
   run('npm', ['run', 'build'], { cwd: join(rootDir, 'frontend') })
-  run('cargo', ['build', '--release'], { cwd: join(rootDir, 'backend') })
+  run('cargo', cargoBuildArgs(), { cwd: join(rootDir, 'backend') })
 
   const binaryName = platform === 'windows' ? `${appName}.exe` : appName
   const builtBinaryName = platform === 'windows' ? 'backend.exe' : 'backend'
-  await cp(join(rootDir, 'backend', 'target', 'release', builtBinaryName), join(releaseDir, binaryName))
+  await cp(join(cargoReleaseDir(), builtBinaryName), join(releaseDir, binaryName))
   await cp(join(rootDir, 'frontend', 'dist'), join(releaseDir, 'frontend'), { recursive: true })
   await cp(join(rootDir, 'config.example.toml'), join(releaseDir, 'config.toml'))
   await cp(join(rootDir, 'packaging', 'README.txt'), join(releaseDir, 'README.txt'))
@@ -116,7 +131,9 @@ async function createTarGzArchive() {
   return archivePath
 }
 
-build().catch((error) => {
-  console.error(error)
-  process.exit(1)
-})
+if (process.argv[1] && import.meta.url === pathToFileURL(resolve(process.argv[1])).href) {
+  build().catch((error) => {
+    console.error(error)
+    process.exit(1)
+  })
+}

scripts/package-release.test.mjs

@@ -0,0 +1,24 @@
+import assert from 'node:assert/strict'
+import { test } from 'node:test'
+import { join } from 'node:path'
+import { cargoBuildArgs, cargoReleaseDir, rootDir } from './package-release.mjs'
+
+test('cargoBuildArgs builds default release binary without a target', () => {
+  assert.deepEqual(cargoBuildArgs(''), ['build', '--release'])
+})
+
+test('cargoBuildArgs adds the configured Rust target', () => {
+  assert.deepEqual(cargoBuildArgs('x86_64-unknown-linux-musl'), [
+    'build',
+    '--release',
+    '--target',
+    'x86_64-unknown-linux-musl',
+  ])
+})
+
+test('cargoReleaseDir reads target-specific release binaries when cross compiling', () => {
+  assert.equal(
+    cargoReleaseDir('x86_64-unknown-linux-musl'),
+    join(rootDir, 'backend', 'target', 'x86_64-unknown-linux-musl', 'release'),
+  )
+})