Cross-Compilation

ปัญหาการ deploy Node

เมื่อ deploy แอปพลิเคชัน Node.js หรือ TypeScript ไปยัง server คุณต้องมั่นใจว่าเครื่องเป้าหมายมี:

Node.js version ที่ถูกต้องติดตั้งไว้
node_modules/ dependencies ทั้งหมด (หรือ bundled ไว้)
native addon binary ที่ถูกต้องสำหรับ target OS/CPU (เช่น bcrypt, sharp)

การ deploy ข้าม architecture — เช่น คอมไพล์บน Mac x86_64 แล้ว deploy ไป AWS Graviton server แบบ ARM — ต้องมี environment ที่ตรงกันในเครื่อง หรือ Docker build ที่ target platform ให้ถูก

Go cross-compilation ด้วย environment variables สองตัว

Go มี support สำหรับ cross-compilation แบบ first-class คุณตั้งค่า environment variables สองตัวก่อน go build และ compiler จะสร้าง binary สำหรับ platform เป้าหมาย — ไม่ต้องใช้ Docker, cross-compiler toolchain หรือ emulation layer

# สองตัวแปรวิเศษ
GOOS=<target-os>    GOARCH=<target-arch>

# ค่าที่ใช้บ่อย
GOOS:   linux   darwin   windows   freebsd
GOARCH: amd64   arm64    386       arm

ตัวอย่างการใช้งานจริง

# Build สำหรับ Linux AMD64 (AWS EC2 ส่วนใหญ่, server ทั่วไป)
GOOS=linux GOARCH=amd64 go build -o bin/app-linux-amd64 ./cmd/app

# Build สำหรับ Linux ARM64 (AWS Graviton, Apple Silicon EC2)
GOOS=linux GOARCH=arm64 go build -o bin/app-linux-arm64 ./cmd/app

# Build สำหรับ Windows จาก macOS หรือ Linux
GOOS=windows GOARCH=amd64 go build -o bin/app.exe ./cmd/app

# Build สำหรับ macOS Apple Silicon จากทุก platform
GOOS=darwin GOARCH=arm64 go build -o bin/app-darwin-arm64 ./cmd/app

ลองรันคำสั่งพวกนี้ใน terminal คุณจะเห็น binary โผล่ใน bin/ ทันที cross-compiled จากเครื่อง host ของคุณโดยไม่ต้องใช้เครื่องมือเพิ่ม

Release script: build สำหรับหลาย target

Shell script ง่าย ๆ เพื่อสร้าง release binary สำหรับทุก platform ที่ใช้บ่อย:

#!/usr/bin/env bash
set -euo pipefail

APP="myapp"
VERSION=$(git describe --tags --always)
OUTDIR="dist/${VERSION}"
mkdir -p "${OUTDIR}"

targets=(
  "linux/amd64"
  "linux/arm64"
  "darwin/amd64"
  "darwin/arm64"
  "windows/amd64"
)

for target in "${targets[@]}"; do
  GOOS="${target%/*}"
  GOARCH="${target#*/}"
  ext=""
  [[ "$GOOS" == "windows" ]] && ext=".exe"

  output="${OUTDIR}/${APP}-${GOOS}-${GOARCH}${ext}"
  echo "Building ${output}..."
  CGO_ENABLED=0 GOOS="${GOOS}" GOARCH="${GOARCH}" \
    go build -ldflags="-s -w -X main.version=${VERSION}" \
    -o "${output}" ./cmd/${APP}
done

echo "Done. Binaries in ${OUTDIR}/"

# Checklist การ deploy TypeScript/Node
# (เครื่องเป้าหมายต้องมีทั้งหมดนี้)

1. ติดตั้ง Node.js v20 บน server
   curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash
   sudo apt-get install -y nodejs

2. อัปโหลด build artifact + package.json
   scp -r dist/ package.json server:/app/

3. ติดตั้ง production deps บน server
   ssh server "cd /app && npm ci --omit=dev"

4. Rebuild native addons สำหรับ target platform
   npm rebuild bcrypt sharp   # ถ้าใช้

5. Start process
   node dist/main.js

# Go cross-compilation — build บน dev, deploy ที่ไหนก็ได้
# เครื่องเป้าหมายต้องการ: ไม่มีอะไร เพียงแค่ copy binary

# จาก Mac ของคุณ build สำหรับ Linux server:
GOOS=linux GOARCH=amd64 \
  CGO_ENABLED=0 \
  go build -o app-linux ./cmd/app

# อัปโหลด binary เดียว
scp app-linux server:/usr/local/bin/myapp

# บน server — แค่รัน:
ssh server "/usr/local/bin/myapp"

🟦 ไม่มี runtime — binary คือแอปพลิเคชัน

Go binary ที่คอมไพล์แล้วเป็น self-contained อย่างสมบูรณ์ ตัว Go runtime (goroutine scheduler, garbage collector) ถูก link แบบ static ฝังอยู่ใน binary เลย ไม่มีอะไรต้องติดตั้งเพิ่มบนเครื่องเป้าหมาย

ข้อนี้ส่งผลในทางปฏิบัติหลายอย่าง:

Lambda / serverless: อัปโหลด binary เป็น zip ไม่ต้องมี layer หรือ runtime config นอกจากเลือก provided.al2023
Edge devices / IoT: Copy ไฟล์เดียวผ่าน scp ไม่มี package manager ไม่ต้องการ connectivity ไปยัง npm ตอน deploy
Air-gapped environments: Binary รัน offline ได้ ไม่มี npm install ที่ต้องออกไปอินเทอร์เน็ต
Containers: ดังที่แสดงใน Docker lesson image สามารถเป็น FROM scratch — รวมแค่ 5–15 MB

กรณีเดียวที่ cross-compilation ยุ่งขึ้นคือเมื่อโค้ดของคุณใช้ CGO (เรียก C library) การตั้ง CGO_ENABLED=0 จะปิด CGO และบังคับให้ build เป็น pure Go เพราะแบบนี้คุณถึงเห็น flag ตัวนี้ในแทบทุก production build script