base/node-go

node-go

Docker base image gồm Node.js + Go + công cụ lint, dùng làm môi trường build/test cho CI.

• Image: git.thuanle.me/public/node-go:latest
• Dockerfile: Dockerfile
• Workflow: .gitea/workflows/node-go.yml

Kiến trúc được hỗ trợ

• linux/amd64
• linux/arm64

Image được build song song cho cả hai kiến trúc rồi gộp vào một multi-arch manifest, kéo bằng :latest sẽ tự nhận đúng kiến trúc của host.

Đã cài đặt sẵn

Phần mềm	Phiên bản	Ghi chú
Node.js	LTS (cùng phiên bản với node:lts-slim)	kèm npm và yarn
Go	1.26	cài nhị phân chính thức từ go.dev, đặt tại /usr/local/go
golangci-lint	v2.12.2	cài vào /usr/local/bin, dùng cho go lint/CI
git	(apt)
gcc + libc6-dev	(apt)	cần cho cgo và một số package Go build bằng C
ca-certificates, curl	(apt)

Các phiên bản Go/golangci-lint được pin bằng ARG trong Dockerfile (GO_VERSION, GOLANGCI_LINT_VERSION) để build ổn định & rollback được, đồng thời Renovate tự bump qua PR khi có release mới:

• golangci-lint: auto-merge minor/patch (major vd v2→v3 mở PR review).
• Go: auto-merge patch; minor (vd 1.26→1.27) mở PR review.

Cách sử dụng

# .gitea/workflows/...
container:
  image: git.thuanle.me/public/node-go:latest
steps:
  - run: node -v && go version && golangci-lint version
  - run: golangci-lint run ./...
  - run: go test ./...

Hoặc chạy cục bộ:

docker run --rm git.thuanle.me/public/node-go:latest \
  sh -c "go version && golangci-lint version"

Những gì KHÔNG có (có thể cần cài thêm)

Image này cố gắng nhỏ gọn, nên một số thứ sau không được cài sẵn — cài thêm trong CI/Dockerfile của dự án nếu cần:

• Docker CLI — nếu cần build/push image, dùng image docker-node thay thế.
• Python — dùng image node-python.
• Make, jq, zip/unzip, openssh-client… — apt-get install trong pipeline khi cần.
• Các Go tool cụ thể của dự án (vd: mockgen, protoc-gen-go, wire…) — go install ...@<version> trong bước CI, vì mỗi dự án cần phiên bản khác nhau.
• Hồ sơ Git (user.name/user.email) — tự cấu hình trong CI.

Nâng cấp

• Tự động (mặc định): Renovate theo dõi GO_VERSION và GOLANGCI_LINT_VERSION, tự mở PR (và auto-merge theo quy tắc ở trên) khi có release mới. PR merge → workflow build lại image.
• Thủ công (khi cần bump major, vd golangci-lint v2→v3 hoặc Go 1.26→1.27): sửa trực tiếp ARG trong Dockerfile rồi push.
• Image cũng được build lại hàng tuần theo lịch (cron) trong workflow.