GitHub ने CI / CD और विरूपण साक्ष्य प्रबंधन में अपने तम्बू लॉन्च किए

मई 2019 में, GitHub ने पैकेज रजिस्ट्री सेवा जारी करने की घोषणा की । इसके बाद, पहले से ही अगस्त में, कार्रवाई में सीआई / सीडी के लिए समर्थन की घोषणा की गई थी ।

लेख में, मैं आपको बताऊंगा कि किस तरह की सेवाएं हैं और इसका उपयोग गीथहब पर एक छोटी सी पालतू परियोजना के उदाहरण पर कैसे किया जा सकता है।

ये किस तरह की सेवाएं हैं?

GitHub Actions एक ऐसा प्लेटफ़ॉर्म है जो आपको सॉफ़्टवेयर जीवन चक्र को प्रबंधित करने की अनुमति देता है, जिसका स्रोत कोड GitHub पर होस्ट किया गया है। वास्तव में, ट्रैविसी, सर्किलसीआई और कई अन्य मुफ्त सीआई / सीडी प्लेटफार्मों को एक्शन के व्यक्ति में एक नया प्रतियोगी प्राप्त हुआ।

GitHub पैकेज रजिस्ट्री कलाकृतियों का केंद्रीय भंडार है, वर्तमान में समर्थित कलाकृतियों के पांच विभिन्न प्रकार हैं।

समर्थित क्रियाओं में कलाकारी के प्रकार

यह एक जगह पर सभी कलाकृतियों को रखने का एक सुविधाजनक अवसर है, क्योंकि यह हमेशा आपके Nexus या Artifactory सर्वर को तैनात करने के लिए सलाह नहीं दी जाती है।

GitHub GitLab के समान होता जा रहा है, और कहीं-कहीं यह पहले से ही एक प्रतिद्वंद्वी से आगे निकल गया है, उदाहरण के लिए, GitLab अभी तक NuGet संकुल और रूबी रत्नों का समर्थन नहीं करता है। वास्तव में, यदि पहले ओपन सोर्स प्रोजेक्ट्स के लिए आपको बाहरी एकीकरण को GitHub से कनेक्ट करना था, तो अब सभी अंडे एक टोकरी में हैं। यहां सभी को यह तय करने दें कि यह अच्छा है या बुरा, लेकिन कम से कम यह सुविधाजनक है।

कैसे करें कोशिश?

दोनों सेवाएं वर्तमान में बीटा मोड में हैं, आप इन पृष्ठों पर बीटा परीक्षण के लिए पंजीकरण कर सकते हैं।

अन्य सेवाओं से प्रवासन बहुत सरल है, मैंने अपनी कई पालतू परियोजनाओं को क्रमशः ट्रैविसीआई और डॉकरहब से क्रियाओं और पैकेज रजिस्ट्री में स्थानांतरित कर दिया।

मैं आपको दिखाऊंगा कि यह एक उदाहरण में कैसे दिखता है। परियोजना सबसे आम है, मैंने इस लेख में इसके बारे में लिखा था। कुछ भी जटिल नहीं है, सामान्य एलईटीएक्स-कोड, जिसकी मदद से कलाकृतियों को इकट्ठा किया जाता है (2 पीडीएफ फाइलें), उन्हें गिटहब रिलीज में प्रकाशित किया जाता है। LaTeX संकुल का एक गुच्छा डाउनलोड न करने के लिए, मैंने एक डॉकफाइल लिखा, ताकि आप किसी भी ओएस के तहत आसानी से काम कर सकें।

पैकेज रजिस्ट्री

डॉकरहब के बजाय पैकेज रजिस्ट्री के साथ काम करना शुरू करने के लिए, आपको केवल दो सरल कदम उठाने की आवश्यकता है।
हम GitHub सेटिंग्स में एक टोकन बनाते हैं (टोकन में कलाकृतियों को लिखने और पढ़ने का अधिकार होना चाहिए)।

टोकन क्रिएशन पेज

और फिर हम निर्मित टोकन और पुश कलाकृतियों के साथ प्रमाणित कर सकते हैं, कि यह कितना सरल है:

docker login docker.pkg.github.com --username amet13 docker tag docker-latex:0.0.1 docker.pkg.github.com/amet13/master-thesis/docker-latex:0.0.1 docker push docker.pkg.github.com/amet13/master-thesis/docker-latex:0.0.1 

कृपया ध्यान दें, मैंने विशेष रूप से GitHub पर अपने उपनाम को निचले मामले में इंगित किया है, अन्यथा आपको डोकर से एक त्रुटि मिलेगी:

 Error parsing reference: "docker.pkg.github.com/Amet13/master-thesis/docker-latex:0.0.1" is not a valid repository/tag: invalid reference format: repository name must be lowercase 

यहाँ यह GitHub वेब इंटरफ़ेस में कैसा दिखता है:

पैकेज रजिस्ट्री पृष्ठ डॉकर छवियों के लिए

नवीनतम छवि को डाउनलोड करने के लिए निर्देश के अलावा, डाउनलोड आँकड़े उपलब्ध हैं, वेब इंटरफ़ेस के माध्यम से एक अलग डोकर परत को डाउनलोड करने की क्षमता, छवि डाउनलोड इतिहास उपलब्ध है।

क्रिया

क्रियाएँ थोड़ी अधिक जटिल हैं, लेकिन उन लोगों के लिए जिन्होंने कभी किसी अन्य सीआई / सीडी प्रणाली के साथ काम किया है, यह समझना मुश्किल नहीं होगा। क्रियाएँ में विन्यास को डिक्लेरेटिव YAML द्वारा वर्णित किया गया है, हालाँकि HCL का उपयोग पहले किया गया था।

कुछ बुनियादी अवधारणाएं (मैं जानबूझकर परिभाषाओं का अनुवाद नहीं करूंगा, मुझे लगता है कि यहां सब कुछ स्पष्ट है):

• वर्कफ़्लो - एक ऐसी प्रक्रिया जो रिपॉजिटरी के लिए सॉफ़्टवेयर जीवन चक्र (बिल्ड, टेस्ट, पैकेज, रिलीज़, तैनाती) का प्रबंधन करती है
• वर्कफ़्लो फ़ाइल - वह फ़ाइल जिसमें वर्कफ़्लो वर्णित है, यह निर्देशिका में रिपॉजिटरी की जड़ में स्थित है। .github/workflows/
• जॉब वर्कफ़्लो का हर रन है, जॉब ट्रिगर होता है, एक समय पर बहुत से जॉब शुरू हो सकते हैं
• स्टेप - प्रत्येक जॉब में एक स्टेप होता है, प्रत्येक स्टेप पर आप कमांड या एक्शन चला सकते हैं
• क्रिया - किसी के द्वारा लिखा गया "प्लग-इन", कई क्रियाओं की एक सूची भयानक-क्रिया भंडार में पाई जा सकती है
• आभासी वातावरण - वह वातावरण जिस पर अय्यूब चलता है (वास्तव में यह विंडोज, मैकओएस या लिनक्स पर एक आभासी मशीन है)
• एक नौकरी शुरू करने के लिए रनर एक तैनात वातावरण है, एक बार में केवल एक जॉब रनर पर चल सकता है
• घटना - एक घटना जो वर्कफ़्लो को ट्रिगर करती है, उदाहरण के लिए, पुश, पुल अनुरोध, वेबहूक, क्रोन जॉब, आदि।
• कलाकृतियाँ - कलाकृतियाँ (बायनेरी, चित्र, लॉग, आदि)

यह वर्कफ़्लो में नौकरी सूची पृष्ठ कैसा दिखता है।

सीमाएँ और निषेध:

• प्रति भंडार 20 वर्कफ़्लो
• भंडार में सभी क्रियाओं के लिए प्रति घंटे 1000 एपीआई अनुरोध
• अधिकतम नौकरी का समय - 6 घंटे
• 20 नौकरियां रिपॉजिटरी में समानांतर में काम कर सकती हैं (सभी वर्कफ़्लोज़ के लिए)
• यह क्रिप्टोक्यूरेंसी खनन और सर्वर रहित कंप्यूटिंग के लिए क्रियाओं का उपयोग करने के लिए मना किया गया है

इस लिंक पर सबसे वर्तमान दस्तावेज उपलब्ध है।

और यहाँ एक नौकरी का लॉग है

उदाहरण

आइए उदाहरण पर वापस जाएं, यहां मेरा कॉन्फ़िगरेशन कैसा दिखता है, हम इसे भागों में अधिक विस्तार से विश्लेषण करेंगे।

वर्कफ़्लो के लिए एक नाम निर्दिष्ट करें और यह बताएं कि किस ट्रिगर पर आग लगनी चाहिए ( प्रलेखन में सभी ट्रिगर की सूची वर्णित है):

 name: master-thesis on: [push] 

जिस पर वर्चुअल एनवायरनमेंट जॉब चलाते हैं:

 jobs: build: # ubuntu-latest, ubuntu-18.04, or ubuntu-16.04 # windows-latest, windows-2019, or windows-2016 # macOS-latest or macOS-10.14 runs-on: ubuntu-latest 

पहला चरण, name: चरण का नाम निर्दिष्ट करें (वैकल्पिक), और uses: हम किस क्रिया का उपयोग करना चाहते हैं, इस मामले में, रिपॉजिटरी को क्लोन करें:

  steps: - name: Checkout repo uses: actions/checkout@v1 

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

  - name: Build docker image and push it to the registry env: GITHUB_TOKEN: ${{ secrets.GH_TOKEN }} DOCKER_IMAGE_ORIGIN: "docker.pkg.github.com/amet13/master-thesis/docker-latex" run: | # Pull submodules git submodule init git submodule update --remote # Login to GitHub Packages and build Docker image docker login docker.pkg.github.com -u amet13 -p ${GITHUB_TOKEN} docker pull ${DOCKER_IMAGE_ORIGIN}:latest docker build -t ${DOCKER_IMAGE_ORIGIN}:${GITHUB_SHA} . # Generate PDF artifacts docker run --rm -i \ -v ${PWD}:/master-thesis:Z ${DOCKER_IMAGE_ORIGIN}:${GITHUB_SHA} \ bash -c "latexmk -xelatex -synctex=1 -jobname=master-thesis main.tex" docker run --rm -i \ -v ${PWD}:/master-thesis:Z ${DOCKER_IMAGE_ORIGIN}:${GITHUB_SHA} \ bash -c "cd presentation/ && latexmk -xelatex -synctex=1 -jobname=presentation main.tex" # Publish Docker image to GitHub Packages (with latest tag) docker tag ${DOCKER_IMAGE_ORIGIN}:${GITHUB_SHA} ${DOCKER_IMAGE_ORIGIN}:latest docker push ${DOCKER_IMAGE_ORIGIN}:${GITHUB_SHA} docker push ${DOCKER_IMAGE_ORIGIN}:latest 

मुझे यकीन है कि निकट भविष्य में एक एक्शन दिखाई देगा जो मैन्युअल रूप से डॉकर कमांड लिखने के बजाय स्वचालित रूप से छवियों को टैग और पुश करेगा।

जीथब टोकन युक्त एक रहस्य जोड़ना

PDFs के निर्माण के बाद अगला कदम GitHub पर एक रिलीज बनाना है और इस रिलीज में एकत्रित कलाकृतियों को शामिल करना है। स्वचालित रूप से एक रिलीज़ बनाने के लिए, हम एक तृतीय-पक्ष एक्शन का उपयोग करते हैं, जिसमें if: ब्लॉक में आप चरण को लॉन्च करने के लिए शर्त निर्दिष्ट कर सकते हैं - केवल टैग बनाते समय:

  - name: Create GitHub release with artifacts uses: softprops/action-gh-release@v1 if: startsWith(github.ref, 'refs/tags/') with: files: | master-thesis.pdf presentation/presentation.pdf name: "Build ${GITHUB_SHA}" env: GITHUB_TOKEN: ${{ secrets.GH_TOKEN }} 

परिणाम

बीटा स्थिति के बावजूद, दोनों सेवाएं अच्छी तरह से काम करती हैं, मुझे यकीन है कि कई चीजें समाप्त हो जाएंगी।
कुछ बिंदुओं पर यह असुविधाजनक हो सकता है, कोई वैश्विक चर नहीं हैं, लेकिन यह बैसाखी के साथ किया जा सकता है।

मुझे YAML के पक्ष में HCL को छोड़ने के लिए GitHub दृष्टिकोण पसंद आया। मुझे कई प्रकार के मेजबानों के लिए समर्थन भी पसंद आया, जो कि बहुत अधिक सीमाएं हैं (अभी के लिए), आइए देखें कि यह कैसे चलता है। सामान्य तौर पर, GitHub पर सार्वजनिक रिपॉजिटरी में सरल पाइपलाइनों के लिए, ऐसा गुच्छा बहुत अच्छी तरह से काम करेगा।

इस लेख का अनुवाद पहले से ही मध्यम है ।