بناء تطبيقات Go باستخدام Docker: سلسلة أدوات محمولة ومعزولة

كفّوا عن تثبيت Go على أجهزتكم. لا تلوّث في GOPATH، ولا «يعمل على جهازي»، ولا أي انحراف في الإصدارات. هذا هو النمط نفسه الذي اعتمدناه لإعادة كتابة وكلاء Java لتقارير Learning Analytics الخاصة بـ BigBlueButton ولبناء Piler Go Agent الآمن. وإليكم كيف تُصدرون ملفات تنفيذية ثابتة الربط باستخدام Docker وحده.

بقلم Ghazi Triki، RIADVICE

المشكلة في «ثبّتوا Go فحسب»

حين كنا ندير وكلاء مبنيين على Java لتقارير Learning Analytics الخاصة بـ BigBlueButton، واجهنا «جحيم التبعيات» المعهود. وكان الانتقال إلى Go يَعِد بالبساطة، ولكن بشرط ألا نكرر الأخطاء ذاتها. كنا بحاجة إلى عملية بناء معزولة بقدر عزل الملفات التنفيذية التي تنتجها.

وكل فريق يصطدم في نهاية المطاف بهذه العقبات:

• انحراف الإصدارات. أحمد يعمل على الإصدار 1.24، وعمر على 1.26، وخادم الإنتاج على 1.25. تغيير طفيف في المترجم يعطّل البناء، ولكن عند أحمد وحده.
• أجهزة ملوّثة. GOPATH وGOMODCACHE وأدوات مثبّتة على مستوى النظام (staticcheck وgofumpt) تختلف من محطة عمل إلى أخرى.
• صعوبة الانضمام. يقضي المهندس الجديد يومه الأول في معالجة متغيرات البيئة وسلاسل أدوات C اللازمة لـ cgo.

في RIADVICE، نُعلي قيمة الانضباط والنظام. وأردنا عملية بناء تعكس ذلك: نظيفة ومتوقعة ومشتركة بين الجميع.

والإجابة المعتادة هي «استخدموا Docker»، غير أن معظم الدروس التعليمية لا تشرح إلا كيفية بناء صورة حاوية. ولا تبيّن لكم كيف تحصلون على ملف تنفيذي عادي ثابت الربط على جهازكم، وهو المخرَج الذي تحتاجون إليه فعلًا لخدمة systemd أو لنشر في بيئة معزولة عن الشبكة، دون أن تثبّتوا مترجم Go محليًا على الإطلاق.

docker run --rm -v "$(pwd):/app" -w /app golang:1.26.5-trixie \
    go build -o dist/myapp ./cmd/myapp

صورة golang الرسمية هي المترجم. وتُربط شيفرتكم المصدرية بالمسار /app. ويُكتب الملف التنفيذي في dist/myapp على جهازكم. وعند انتهاء الأمر، تُحذف الحاوية (--rm)، فيبقى جهازكم نظيفًا كما كان من قبل.

تجربة واقعية: من BigBlueButton إلى Piler

ليس هذا مجرد كلام نظري. فقد طبّقنا هذا النمط على مشروعين حيويين:

1. تقارير Learning Analytics الخاصة بـ BigBlueButton: أعدنا كتابة وكلاء Java الثقيلة على هيئة ملفات تنفيذية خفيفة بلغة Go. وأتاح لنا البناء القائم على Docker استهداف بيئة Debian المطابقة لخوادم BBB دون الحاجة إلى تلك البيئة على حواسيبنا المحمولة.
2. Piler Go Agent: بنينا لحل أرشفة البريد الإلكتروني لدينا وكيلًا معزّز الأمان. وكان لا بد أن تكون عملية البناء آمنة بقدر أمان الشيفرة. ومن خلال تثبيت المترجم على بصمة SHA محددة، ضمنّا معرفة مصدر كل بت في الملف التنفيذي.

لماذا يتفوق هذا على تثبيت Go

BINARY := mini-api
DIST := dist

# Version metadata derived from git
VERSION    := $(shell tmp=$$(git describe --tags --always --dirty 2>/dev/null) && echo "$${tmp#v}" || echo dev)
COMMIT     := $(shell git rev-parse --short HEAD 2>/dev/null || echo unknown)
BRANCH     := $(shell git rev-parse --abbrev-ref HEAD 2>/dev/null || echo unknown)
BUILD_DATE := $(shell date -u +%Y-%m-%dT%H:%M:%SZ)
LDFLAGS := -X example.com/mini-api/internal/version.Version=$(VERSION) \
           -X example.com/mini-api/internal/version.Commit=$(COMMIT) \
           -X example.com/mini-api/internal/version.Branch=$(BRANCH) \
           -X example.com/mini-api/internal/version.BuildDate=$(BUILD_DATE)

# Pinned toolchain image
GO_IMAGE := golang:1.26.5-trixie

# Run any command inside the Go toolchain container
define run_in_docker
    docker run --rm -v "$(PWD):/app" -w /app $(GO_IMAGE)
endef

.PHONY: build test lint

build:
    @mkdir -p $(DIST)
    $(call run_in_docker) bash -c 'CGO_ENABLED=0 go build -buildvcs=false -ldflags="$(LDFLAGS)" -o $(DIST)/$(BINARY) ./cmd/$(BINARY)'
    @echo "Built $(DIST)/$(BINARY) (version $(VERSION))"

test:
    $(call run_in_docker) go test -race ./...

lint:
    $(call run_in_docker) go vet ./...

ملف Makefile: مصدر الانضباط

نستخدم ملف Makefile لتدوين خطوات البناء. لاحظوا كيف ثُبّتت GO_IMAGE على إصدار محدد. فنحن لا نستخدم latest أبدًا.

التفاصيل التقنية المهمة

1. CGO_ENABLED=0 للحصول على ملفات تنفيذية ثابتة الربط

في وكيل Piler، احتجنا إلى ملفات تنفيذية قادرة على العمل على أي نظام، من إصدار Debian حديث إلى خادم قديم. ويضمن تعطيل CGO أن يتضمن الملف التنفيذي كل ما يحتاج إليه، دون أي تبعيات ديناميكية على مكتبات الجهاز المضيف.

2. -ldflags -X لتتبّع المصدر

ينبغي أن يكون ملفكم التنفيذي قادرًا على إخباركم بمصدره بدقة. لذا نُدرج إيداع git وتاريخ البناء في مرحلة الربط. وقد كان ذلك حيويًا لتصحيح أخطاء وكلاء BigBlueButton عبر عشرات العناقيد المختلفة.

3. تثبيت صورة المترجم

نؤمن في ثقافتنا بالاتساق. فتثبيت golang:1.26.5-trixie بدلًا من استخدام latest يعني أنه إذا بنى أحمد الملف التنفيذي اليوم وبناه عمر بعد ستة أشهر، فإن الناتج يكون متطابقًا بتًا ببت.

الخلاصة

المترجم أداة، وككل أداة ينبغي أن يبقى في مكانه. وبنقل سلسلة أدوات Go إلى Docker، تخلّصنا من فئة كاملة من أخطاء «يعمل عندي»، وبسّطنا انضمام كل مهندس جديد يلتحق بـ RIADVICE.

وسواء كنتم تعيدون كتابة وكلاء Java أو تبنون واجهة برمجة تطبيقات آمنة لـ Piler، فإن هذا النمط يوفر الانضباط والموثوقية اللذين تتطلبهما أنظمة الإنتاج.

Ghazi Triki هو مؤسس RIADVICE. نبني عمليات تكامل آمنة وعالية الأداء لـ BigBlueButton وPiler وغيرهما، فلنبنِ معًا شيئًا رائعًا.

🔗 احصلوا على golang-docker-boilerplate من GitHub