Go बिल्ड का ऑटो-नंबरिंग: वर्ज़निंग समस्या का एक बार और हमेशा के लिए समाधान

मैन्युअल वर्ज़निंग हर Go डेवलपर का दर्द क्यों है

क्या आपने कभी सोचा है: "प्रोडक्शन पर अभी कौन सा संस्करण चल रहा है?" या यह पता लगाने में एक घंटा बिताया कि एक महीने पहले बनाए गए बाइनरी में किस कमिट ने बग पैदा किया? यदि हाँ, तो आप सही जगह पर हैं। प्रश्न "Application auto build versioning" Stack Overflow पर सबसे लोकप्रिय में से एक है (हज़ारों व्यू और दर्जनों समाधान)। और यह सही भी है: आधुनिक विकास में, जहाँ CI/CD पाइपलाइन हर 10 मिनट में बिल्ड चलाती हैं, मैन्युअल संस्करण डालना अराजकता का रास्ता है।

इस लेख में हम Go में बिल्ड का स्वचालित वर्ज़निंग शुरू से अंत तक समझेंगे। आप सीखेंगे कि ऐसी प्रणाली कैसे लागू करें जो स्वचालित रूप से संस्करण संख्या, कमिट हैश, बिल्ड तिथि और यहाँ तक कि "गंदे" रिपॉजिटरी का फ्लैग भी सेट करती है। कोड स्थानीय विकास और GitHub Actions, GitLab CI या Jenkins दोनों में काम करेगा।

समस्या: मैन्युअल version.go में क्या गलत है?

कई नौसिखिए डेवलपर एक फ़ाइल version.go बनाते हैं और लिखते हैं:

package main\n\nvar Version = "1.0.0"

और यह पहले कमिट तक काम करता है। फिर शुरू होता है:

\n
• "मैं बिल्ड से पहले संस्करण अपडेट करना भूल गया"
\n
• "प्रोडक्शन पर एक संस्करण है, कोड में दूसरा"
\n
• "यह बिल्ड किस कमिट से मेल खाता है?"
\n

समस्या यह है कि संस्करण बिल्ड का मेटाडेटा है, स्रोत कोड का हिस्सा नहीं। इसे संकलन चरण में स्वचालित रूप से उत्पन्न होना चाहिए।

समाधान: ldflags — Go का गुप्त हथियार

Go कंपाइलर आपको -ldflags फ्लैग के माध्यम से बिल्ड के दौरान वेरिएबल के मान "डालने" की अनुमति देता है। यही auto build versioning का क्लासिक रूप है। हम संस्करण को कोड में स्टोर नहीं करते — हम इसे कंपाइलर को पास करते हैं।

चरण 1: संस्करण संरचना परिभाषित करें

आइए वेरिएबल के साथ एक पैकेज version बनाएँ जो बिल्ड चरण में भरे जाएँगे:

// version/version.go\npackage version\n\nvar (\n    // Version — सिमैंटिक संस्करण (मैन्युअल या git टैग के माध्यम से सेट किया गया)\n    Version = "dev"\n\n    // Commit — कमिट का छोटा हैश\n    Commit = "none"\n\n    // BuildTime — ISO 8601 प्रारूप में बिल्ड समय\n    BuildTime = "unknown"\n\n    // IsDirty — फ्लैग कि रिपॉजिटरी में अनकमिटेड परिवर्तन हैं\n    IsDirty = "false"\n)\n\nfunc String() string {\n    return "v" + Version + " (commit: " + Commit + ", built: " + BuildTime + ")"\n}

चरण 2: ldflags के साथ बिल्ड करें

अब सबसे दिलचस्प भाग। go build के बजाय हम एक स्क्रिप्ट या Makefile का उपयोग करेंगे जो आवश्यक मानों की गणना करता है और उन्हें कंपाइलर को पास करता है:

#!/bin/bash\n# build.sh\n\nVERSION=$(git describe --tags --always --dirty 2>/dev/null || echo "dev")\nCOMMIT=$(git rev-parse --short HEAD 2>/dev/null || echo "none")\nBUILD_TIME=$(date -u +"%Y-%m-%dT%H:%M:%SZ")\nIS_DIRTY=$(git diff --quiet || echo "true")\n\ngo build -ldflags="\\\n    -X 'main/version.Version=$VERSION' \\\n    -X 'main/version.Commit=$COMMIT' \\\n    -X 'main/version.BuildTime=$BUILD_TIME' \\\n    -X 'main/version.IsDirty=$IS_DIRTY'" \\\n    -o myapp .

महत्वपूर्ण: पथ main/version.Version आपकी प्रोजेक्ट संरचना पर निर्भर करता है। यदि पैकेज version रूट में है — तो main/version.Version लिखें। यदि एक अलग निर्देशिका में — github.com/आपका-उपयोगकर्ता-नाम/प्रोजेक्ट/version.Version।

चरण 3: एप्लिकेशन में उपयोग करें

अब प्रोग्राम में कहीं भी संस्करण प्रदर्शित किया जा सकता है:

// main.go\npackage main\n\nimport (\n    "fmt"\n    "main/version"\n)\n\nfunc main() {\n    fmt.Println("App version:", version.String())\n    fmt.Println("Is dirty repo:", version.IsDirty)\n}

बिल्ड करें और चलाएँ:

$ ./build.sh\n$ ./myapp\nApp version: v1.2.3 (commit: a1b2c3d, built: 2024-03-15T10:30:00Z)\nIs dirty repo: false

उन्नत स्तर: सिमैंटिक