🤙🏼 😊 🥦 लाठी और संस्करण के साथ अपने खुद के नोड.जेएस मॉड्यूल भंडार को कैसे व्यवस्थित करें 👷🏻 🤭 ⛹🏻

तीन फ्रंट-एंड टीमें वर्तमान में आईएसपीसिस्टम पर तीन बड़ी परियोजनाएं विकसित कर रही हैं: वेब सर्वरों के प्रबंधन के लिए आईएसपीमैनगर, वर्चुअलाइजेशन के साथ काम करने के लिए वीएमएम्नेजर, और हॉस्टलर्स के व्यवसाय को स्वचालित करने के लिए बिलमैनगर। टीमें एक ही समय में काम करती हैं, तंग समय सीमा के मोड में, इसलिए आप अनुकूलन के बिना नहीं कर सकते। समय बचाने के लिए, हम सामान्य समाधानों का उपयोग करते हैं और अलग-अलग परियोजनाओं में सामान्य घटकों को लेते हैं। ऐसी परियोजनाओं की अपनी रिपॉजिटरी होती है, जो सभी टीमों के सदस्यों द्वारा समर्थित होती है। यह लेख इन रिपॉजिटरी के निर्माण के साथ-साथ उनके साथ काम के बारे में होगा।

कैसे आम परियोजनाओं के भंडार हैं

हम रिमोट रिपॉजिटरी स्टोर करने के लिए GitLab के साथ अपने स्वयं के सर्वर का उपयोग करते हैं। हमारे लिए यह महत्वपूर्ण था कि हम परिचित कामकाजी वातावरण को बनाए रखें और उनके विकास की प्रक्रिया में सामान्य मॉड्यूल के साथ काम करने में सक्षम हों। इसलिए, हमने npmjs.com निजी रिपॉजिटरी में प्रकाशित करने से इनकार कर दिया। सौभाग्य से, नोड.जेएस मॉड्यूल न केवल एनपीएम के साथ, बल्कि अन्य स्रोतों से भी स्थापित किए जा सकते हैं, जिसमें गिट रिपॉजिटरी भी शामिल हैं।

हम टाइपस्क्रिप्ट में लिखते हैं, जिसे बाद में उपयोग के लिए जावास्क्रिप्ट में संकलित किया गया है। लेकिन हमारे समय में, शायद आलसी सामने वाला अपने जावास्क्रिप्ट को संकलित नहीं करता है। इसलिए, हमें स्रोत कोड और संकलित परियोजना के लिए विभिन्न रिपॉजिटरी की आवश्यकता है।

लंबी चर्चा के कांटों से गुजरने के बाद, हमने निम्नलिखित अवधारणा विकसित की। स्रोतों के लिए और मॉड्यूल के संकलित संस्करण के लिए दो अलग-अलग रिपॉजिटरी होनी चाहिए। इसके अलावा, दूसरा भंडार पहले का दर्पण होना चाहिए।

इसका मतलब यह है कि विकास के दौरान किसी भी सुविधा को शाखा में जारी करने से पहले उसी नाम से प्रकाशित किया जाना चाहिए जिस शाखा में विकास हो रहा है। इस प्रकार, हमारे पास मॉड्यूल के प्रयोगात्मक संस्करण का उपयोग करने का अवसर है, इसे एक विशिष्ट शाखा से स्थापित करना है। जिस चीज में हम विकास कर रहे हैं, वह बहुत ही सुविधाजनक है, इसे कार्रवाई में जाँचने के लिए।

साथ ही, प्रत्येक प्रकाशन के लिए, हम एक लेबल बनाते हैं जो परियोजना की स्थिति को बचाता है। लेबल का नाम package.json में निर्दिष्ट संस्करण से मेल खाता है। गिट रिपॉजिटरी से स्थापित करते समय, लेबल को जाली के बाद इंगित किया जाता है, उदाहरण के लिए:

npm install git+ssh://[url ]#1.0.0

इस प्रकार, हम मॉड्यूल के उपयोग किए गए संस्करण को ठीक कर सकते हैं और चिंता न करें कि कोई व्यक्ति कुछ बदल देगा।

अस्थिर संस्करणों के लिए लेबल भी बनाए जाते हैं, हालाँकि, प्रतिबद्ध का एक संक्षिप्त हैश उन्हें स्रोत रिपॉजिटरी में जोड़ा जाता है, जहां से प्रकाशन किया गया था। इस तरह के एक लेबल का एक उदाहरण इस प्रकार है:

 1.0.0_e5541dc1

यह दृष्टिकोण आपको लेबल की विशिष्टता प्राप्त करने की अनुमति देता है, साथ ही साथ उन्हें स्रोत रिपॉजिटरी के साथ संबद्ध करता है।

चूंकि हम मॉड्यूल के स्थिर और अस्थिर संस्करणों के बारे में बात कर रहे हैं, यहां बताया गया है कि हम उन्हें कैसे अलग करते हैं: यदि प्रकाशन मास्टर या विकास शाखा से किया जाता है, तो संस्करण स्थिर है, अन्यथा नहीं।

कैसे आम परियोजनाओं के साथ काम किया जाता है?

यदि हम उन्हें स्वचालित नहीं कर सकते तो हमारे सभी समझौते समझ में नहीं आएंगे। विशेष रूप से, प्रकाशन प्रक्रिया को स्वचालित करें। नीचे मैं दिखाऊंगा कि सामान्य मॉड्यूल में से एक के साथ कैसे काम किया जाता है - कस्टम स्क्रिप्ट के परीक्षण के लिए एक उपयोगिता।

यह उपयोगिता, कठपुतली पुस्तकालय का उपयोग करके, डॉकटर कंटेनरों में उपयोग के लिए क्रोमियम ब्राउज़र तैयार करती है और मोचा का उपयोग करके परीक्षण चलाती है। सभी टीमों के प्रतिभागी एक दूसरे से कुछ तोड़ने के डर के बिना उपयोगिता को संशोधित कर सकते हैं।

निम्न कमांड परीक्षण उपयोगिता के package.json फ़ाइल में लिखा है:

 "publish:git": "ts-node ./scripts/publish.ts"

वह पास की स्क्रिप्ट चलाता है:

पूर्ण प्रकाशित स्क्रिप्ट कोड

 import { spawnSync } from 'child_process'; import { mkdirSync, existsSync } from 'fs'; import { join } from 'path'; import chalk from 'chalk'; /** *     */ /** *      * @param cwd -    * @param stdio -  / */ const getSpawnOptions = (cwd = process.cwd(), stdio = 'inherit') => ({ cwd, shell: true, stdio, }); /*    */ const rootDir = join(__dirname, '../'); /*     */ const isDiff = !!spawnSync('git', ['diff'], getSpawnOptions(rootDir, 'pipe')).stdout.toString().trim(); if (isDiff) { console.log(chalk.red('There are uncommitted changes')); } else { /*   */ const build = spawnSync('npm', ['run', 'build'], getSpawnOptions(rootDir)); /*     */ if (build.status === 0) { /*       */ const tempDir = join(rootDir, 'temp'); if (existsSync(tempDir)) { spawnSync('rm', ['-rf', 'temp'], getSpawnOptions(rootDir)); } mkdirSync(tempDir); /*    package.json */ const { name, version, repository } = require(join(rootDir, 'package.json')); const originUrl = repository.url.replace(`${name}-source`, name); spawnSync('git', ['init'], getSpawnOptions(tempDir)); spawnSync('git', ['remote', 'add', 'origin', originUrl], getSpawnOptions(tempDir)); /*        */ const branch = spawnSync( 'git', ['symbolic-ref', '--short', 'HEAD'], getSpawnOptions(rootDir, 'pipe') ).stdout.toString().trim(); /*      */ const buildBranch = branch === 'develop' ? 'master' : branch; /*       ,       */ const shortSHA = spawnSync( 'git', ['rev-parse', '--short', 'HEAD'], getSpawnOptions(rootDir, 'pipe') ).stdout.toString().trim(); /*  */ const tag = buildBranch === 'master' ? version : `${version}_${shortSHA}`; /*        */ const isTagExists = !!spawnSync( 'git', ['ls-remote', 'origin', `refs/tags/${tag}`], getSpawnOptions(tempDir, 'pipe') ).stdout.toString().trim(); if (isTagExists) { console.log(chalk.red(`Tag ${tag} already exists`)); } else { /*       */ const isBranchExits = !!spawnSync( 'git', ['ls-remote', '--exit-code', 'origin', buildBranch], getSpawnOptions(tempDir, 'pipe') ).stdout.toString().trim(); if (isBranchExits) { /*     */ spawnSync('git', ['fetch', 'origin', buildBranch], getSpawnOptions(tempDir)); spawnSync('git', ['checkout', buildBranch], getSpawnOptions(tempDir)); } else { /*    master */ spawnSync('git', ['fetch', 'origin', 'master'], getSpawnOptions(tempDir)); spawnSync('git', ['checkout', 'master'], getSpawnOptions(tempDir)); /*    */ spawnSync('git', ['checkout', '-b', buildBranch], getSpawnOptions(tempDir)); /*    */ spawnSync('git', ['commit', '--allow-empty', '-m', '"Initial commit"'], getSpawnOptions(tempDir)); } /*     */ spawnSync( 'rm', ['-rf', 'lib', 'package.json', 'package-lock.json', 'README.md'], getSpawnOptions(tempDir) ); /*    */ spawnSync('cp', ['-r', 'lib', 'temp/lib'], getSpawnOptions(rootDir)); spawnSync('cp', ['package.json', 'temp/package.json'], getSpawnOptions(rootDir)); spawnSync('cp', ['package-lock.json', 'temp/package-lock.json'], getSpawnOptions(rootDir)); spawnSync('cp', ['README.md', 'temp/README.md'], getSpawnOptions(rootDir)); /*    */ spawnSync('git', ['add', '--all'], getSpawnOptions(tempDir)); /*       */ const lastCommitMessage = spawnSync( 'git', ['log', '--oneline', '-1'], getSpawnOptions(rootDir, 'pipe') ).stdout.toString().trim(); /*      */ const message = buildBranch === 'master' ? version : lastCommitMessage; /*      */ spawnSync('git', ['commit', '-m', `"${message}"`], getSpawnOptions(tempDir)); /*      */ spawnSync('git', ['tag', tag], getSpawnOptions(tempDir)); /*      */ spawnSync('git', ['push', 'origin', buildBranch], getSpawnOptions(tempDir)); spawnSync('git', ['push', '--tags'], getSpawnOptions(tempDir)); console.log(chalk.green('Published successfully!')); } /*    */ spawnSync('rm', ['-rf', 'temp'], getSpawnOptions(rootDir)); } else { console.log(chalk.red(`Build was exited exited with code ${build.status}`)); } } console.log(''); // space

बदले में, यह कोड Node.js child_process मॉड्यूल के माध्यम से सभी आवश्यक कमांड निष्पादित करता है।

यहाँ उनके काम के मुख्य चरण हैं:

1. अनधिकृत परिवर्तनों के लिए जाँच करें

 const isDiff = !!spawnSync('git', ['diff'], getSpawnOptions(rootDir, 'pipe')).stdout.toString().trim();

यहाँ हम git diff कमांड के परिणाम की जाँच करते हैं। यदि प्रकाशन में स्रोत में परिवर्तन नहीं हैं तो यह अच्छा नहीं है। इसके अलावा, यह कमिट के साथ अस्थिर संस्करणों के कनेक्शन को तोड़ देगा।

2. उपयोगिता विधानसभा

 const build = spawnSync('npm', ['run', 'build'], getSpawnOptions(rootDir));

बिल्ड स्थिरांक से बिल्ड का परिणाम मिलता है। यदि सब कुछ ठीक रहा, तो स्थिति पैरामीटर 0. होगा अन्यथा, कुछ भी प्रकाशित नहीं किया जाएगा।

3. संकलित संस्करण रिपॉजिटरी की तैनाती

संपूर्ण प्रकाशन प्रक्रिया एक विशिष्ट रिपॉजिटरी में परिवर्तन प्रस्तुत करने से ज्यादा कुछ नहीं है। इसलिए, स्क्रिप्ट हमारी परियोजना में एक अस्थायी निर्देशिका बनाती है जिसमें यह गिट रिपॉजिटरी को आरंभ करती है और इसे दूरस्थ विधानसभा रिपॉजिटरी के साथ जोड़ती है।

 /*       */ const tempDir = join(rootDir, 'temp'); if (existsSync(tempDir)) { spawnSync('rm', ['-rf', 'temp'], getSpawnOptions(rootDir)); } mkdirSync(tempDir); /*    package.json */ const { name, version, repository } = require(join(rootDir, 'package.json')); const originUrl = repository.url.replace(`${name}-source`, name); spawnSync('git', ['init'], getSpawnOptions(tempDir)); spawnSync('git', ['remote', 'add', 'origin', originUrl], getSpawnOptions(tempDir));

यह git init और git रिमोट का उपयोग करते हुए एक मानक प्रक्रिया है।

4. लेबल नाम पीढ़ी

सबसे पहले, हमें उस शाखा का नाम पता चलता है जिससे हम गिट प्रतीकात्मक-रेफ कमांड का उपयोग कर प्रकाशित कर रहे हैं। और उस शाखा का नाम सेट करें जिसमें परिवर्तन अपलोड किए जाएंगे (विधानसभा भंडार में कोई विकसित शाखा नहीं है)।

 /*        */ const branch = spawnSync( 'git', ['symbolic-ref', '--short', 'HEAD'], getSpawnOptions(rootDir, 'pipe') ).stdout.toString().trim(); /*      */ const buildBranch = branch === 'develop' ? 'master' : branch;

Git Rev-parse कमांड का उपयोग करके, हम उस शाखा में अंतिम कमिट का संक्षिप्त हैश प्राप्त करते हैं, जिसमें हम हैं। अस्थिर संस्करण के लेबल नाम को उत्पन्न करने के लिए इसकी आवश्यकता हो सकती है।

 <source lang="typescript">/*       ,       */ const shortSHA = spawnSync( 'git', ['rev-parse', '--short', 'HEAD'], getSpawnOptions(rootDir, 'pipe') ).stdout.toString().trim();

खैर, वास्तव में लेबल का नाम बना।

 /*  */ const tag = buildBranch === 'master' ? version : `${version}_${shortSHA}`;

5. दूरस्थ रिपॉजिटरी में ठीक उसी टैग की अनुपस्थिति के लिए जाँच करना

 /*        */ const isTagExists = !!spawnSync( 'git', ['ls-remote', 'origin', `refs/tags/${tag}`], getSpawnOptions(tempDir, 'pipe') ).stdout.toString().trim();

यदि एक समान लेबल पहले बनाया गया था, तो गिट ls- रिमोट कमांड का परिणाम खाली नहीं होगा। एक ही संस्करण को केवल एक बार प्रकाशित किया जाना चाहिए।

6. विधानसभा रिपॉजिटरी में उपयुक्त शाखा बनाना

जैसा कि मैंने पहले कहा था, उपयोगिता के संकलित संस्करणों का भंडार स्रोत कोड के साथ भंडार का दर्पण है। इसलिए, यदि प्रकाशन मास्टर या विकसित शाखा से नहीं है, तो हमें असेंबली रिपॉजिटरी में संबंधित शाखा बनाना होगा। ठीक है, या कम से कम इसके अस्तित्व को सुनिश्चित करें

 /*       */ const isBranchExits = !!spawnSync( 'git', ['ls-remote', '--exit-code', 'origin', buildBranch], getSpawnOptions(tempDir, 'pipe') ).stdout.toString().trim(); if (isBranchExits) { /*     */ spawnSync('git', ['fetch', 'origin', buildBranch], getSpawnOptions(tempDir)); spawnSync('git', ['checkout', buildBranch], getSpawnOptions(tempDir)); } else { /*    master */ spawnSync('git', ['fetch', 'origin', 'master'], getSpawnOptions(tempDir)); spawnSync('git', ['checkout', 'master'], getSpawnOptions(tempDir)); /*    */ spawnSync('git', ['checkout', '-b', buildBranch], getSpawnOptions(tempDir)); /*    */ spawnSync('git', ['commit', '--allow-empty', '-m', '"Initial commit"'], getSpawnOptions(tempDir)); }

यदि शाखा पहले अनुपस्थित थी, तो हम खाली -खाली झंडे का उपयोग करके एक कमिट के साथ आरंभ करते हैं।

7. फाइल तैयार करना

सबसे पहले आपको वह सब कुछ हटाने की जरूरत है जो तैनात भंडार में हो सकता है। आखिरकार, यदि हम पहले से मौजूद शाखा का उपयोग करते हैं, तो इसमें उपयोगिता का पिछला संस्करण होता है।

 /*     */ spawnSync( 'rm', ['-rf', 'lib', 'package.json', 'package-lock.json', 'README.md'], getSpawnOptions(tempDir) );

अगला, हम प्रकाशन के लिए आवश्यक अद्यतन की गई फ़ाइलों को स्थानांतरित करते हैं, और उन्हें रिपॉजिटरी इंडेक्स में जोड़ते हैं।

 /*    */ spawnSync('cp', ['-r', 'lib', 'temp/lib'], getSpawnOptions(rootDir)); spawnSync('cp', ['package.json', 'temp/package.json'], getSpawnOptions(rootDir)); spawnSync('cp', ['package-lock.json', 'temp/package-lock.json'], getSpawnOptions(rootDir)); spawnSync('cp', ['README.md', 'temp/README.md'], getSpawnOptions(rootDir)); /*    */ spawnSync('git', ['add', '--all'], getSpawnOptions(tempDir));

इस तरह के हेरफेर के बाद, गिट फाइलों की लाइनों द्वारा किए गए परिवर्तनों को अच्छी तरह से पहचान लेंगे। इस तरह हमें संकलित संस्करण रिपॉजिटरी में भी लगातार बदलाव का इतिहास मिलता है।

8. परिवर्तन करना और प्रस्तुत करना

असेंबली रिपॉजिटरी में एक प्रतिबद्ध संदेश के रूप में, हम स्थिर संस्करणों के लिए लेबल नाम का उपयोग करते हैं। और अस्थिर के लिए - स्रोत भंडार से एक प्रतिबद्ध संदेश। इस तरह, दर्पण रिपॉजिटरी के हमारे विचार का समर्थन करते हैं।

 /*       */ const lastCommitMessage = spawnSync( 'git', ['log', '--oneline', '-1'], getSpawnOptions(rootDir, 'pipe') ).stdout.toString().trim(); /*      */ const message = buildBranch === 'master' ? version : lastCommitMessage; /*      */ spawnSync('git', ['commit', '-m', `"${message}"`], getSpawnOptions(tempDir)); /*      */ spawnSync('git', ['tag', tag], getSpawnOptions(tempDir)); /*      */ spawnSync('git', ['push', 'origin', buildBranch], getSpawnOptions(tempDir)); spawnSync('git', ['push', '--tags'], getSpawnOptions(tempDir));

9. एक अस्थायी निर्देशिका को हटाना

 spawnSync('rm', ['-rf', 'temp'], getSpawnOptions(rootDir));

आम परियोजनाओं में अपडेट की समीक्षा

आम परियोजनाओं में बदलाव करने के बाद सबसे महत्वपूर्ण प्रक्रियाओं में से एक समीक्षा बन जाती है। इस तथ्य के बावजूद कि विकसित तकनीक आपको मॉड्यूल के पूरी तरह से पृथक संस्करण बनाने की अनुमति देती है, कोई भी एक ही उपयोगिता के विभिन्न संस्करणों के दर्जनों नहीं चाहता है। इसलिए, प्रत्येक सामान्य परियोजनाओं को एक ही विकास पथ का पालन करना चाहिए। टीमों के बीच इस पर सहमति होनी चाहिए।

जहां तक संभव हो, सभी परियोजनाओं के सदस्यों द्वारा आम परियोजनाओं में अद्यतन की समीक्षा की जाती है। यह एक जटिल प्रक्रिया है, क्योंकि प्रत्येक टीम अपने स्वयं के स्प्रिंट पर रहती है और एक अलग कार्यभार है। कभी-कभी एक नए संस्करण में संक्रमण में देरी हो सकती है।

यहां आप केवल इस प्रक्रिया में देरी न करने और न करने की सिफारिश कर सकते हैं।

लाठी और संस्करण के साथ अपने खुद के नोड.जेएस मॉड्यूल भंडार को कैसे व्यवस्थित करें

कैसे आम परियोजनाओं के भंडार हैं

कैसे आम परियोजनाओं के साथ काम किया जाता है?

यहाँ उनके काम के मुख्य चरण हैं:

आम परियोजनाओं में अपडेट की समीक्षा

More articles: