Jsonnet पर 100 लाइनों में 100 gitlab नौकरी का वर्णन कैसे करें

कुबेरनेट्स में तैनाती उपकरणों के बारे में पिछले लेख की निरंतरता में, मैं आपको बताना चाहता हूं कि आप अपने .gitlab-ci.yml में नौकरी के विवरण को सरल बनाने के लिए Jsonnet का उपयोग कैसे कर सकते हैं।

Dano

एक मोनोरपा है जिसमें:

• 10 डॉकफाइल्स
• 30 वर्णित तैनाती
• 3 वातावरण: devel , मंचन और उत्पादन

कार्य

एक पाइपलाइन स्थापित करें:

• एक संस्करण के साथ एक जीआईटी टैग जोड़कर डॉकरों की छवियों का निर्माण किया जाना चाहिए।
• प्रत्येक परिनियोजन ऑपरेशन को पर्यावरण शाखा में धकेलते समय और केवल एक विशिष्ट निर्देशिका में फ़ाइलों को बदलकर किया जाना चाहिए
• प्रत्येक वातावरण का अपना एक अलग टैग है, जो केवल अपने वातावरण में तैनाती करता है।
• सभी अनुप्रयोगों को प्रत्येक वातावरण में तैनात नहीं किया जाना चाहिए, हमें अपवाद बनाने में सक्षम होने के लिए पाइपलाइन का वर्णन करना चाहिए।
• कुछ परिनियोजन git GIT_SUBMODULE_STRATEGY=normal उपयोग करते हैं और इसे सेट चर GIT_SUBMODULE_STRATEGY=normal शुरू किया जाना चाहिए

यह सब बताते हुए यह एक वास्तविक नरक की तरह लग सकता है, लेकिन हम निराशा नहीं करते हैं और Jsonnet के साथ सशस्त्र हम यह आसानी से और स्वाभाविक रूप से करेंगे।

निर्णय

gitlab-ci.yml में बार-बार नौकरियों के विवरण को कम करने के लिए अंतर्निहित क्षमताएं हैं, उदाहरण के लिए, आप एक्सटेंड का उपयोग कर सकते हैं या शामिल कर सकते हैं , लेकिन यह पूर्ण-विकसित templating प्रदान नहीं करता है, जो हमें सबसे संक्षिप्त और कुशल वर्णन करने की अनुमति नहीं देता है।

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

Jsonnet के साथ काम करते समय, मैं आपके संपादक के लिए एक प्लगइन स्थापित करने की अत्यधिक सलाह देता हूं

उदाहरण के लिए, विम के लिए एक विम-जोंसनेट प्लगइन है जो सिंटैक्स हाइलाइटिंग को चालू करता है और हर बार इसे सहेजे जाने के समय जोंसनेट fmt को स्वचालित रूप से निष्पादित करता है (इसके लिए jsonnet इंस्टॉल होना आवश्यक है)।

आइए हमारी रिपॉजिटरी की संरचना को देखें:

 . ├── deploy │  ├── analyse │  ├── basin │  ├── brush │  ├── copper │  ├── dinner │  ├── dirty │  ├── drab │  ├── drunk │  ├── education │  ├── fanatical │  ├── faulty │  ├── guarantee │  ├── guitar │  ├── hall │  ├── harmonious │  ├── history │  ├── iron │  ├── maniacal │  ├── mist │  ├── nine │  ├── pleasant │  ├── polish │  ├── receipt │  ├── shop │  ├── smelly │  ├── solid │  ├── stroke │  ├── thunder │  ├── ultra │  └── yarn └── dockerfiles ├── dinner ├── drunk ├── fanatical ├── guarantee ├── guitar ├── harmonious ├── shop ├── smelly ├── thunder └── yarn 

काइको का उपयोग कर डॉकरी चित्र बनाए जाएंगे

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

 qbec apply <environment> --root deploy/<app> --yes 

जहां:

• <app> - हमारे आवेदन का नाम
• <environment> हमारे वातावरण में से एक है: डेवेल , स्टेज, या ठेस ।

अंत में, हमारी नौकरियों को इस तरह दिखना चाहिए:

विधानसभा:

 build:{{ image }}: stage: build tags: - build image: name: gcr.io/kaniko-project/executor:debug entrypoint: [""] script: - echo "{\"auths\":{\"$CI_REGISTRY\":{\"username\":\"$CI_REGISTRY_USER\",\"password\":\"$CI_REGISTRY_PASSWORD\"}}}" > /kaniko/.docker/config.json - /kaniko/executor --context $CI_PROJECT_DIR --dockerfile $CI_PROJECT_DIR/dockerfiles/{{ image }}/Dockerfile --destination $CI_REGISTRY_IMAGE/{{ image }}:$CI_COMMIT_TAG only: refs: - tags 

जहां {{ image }} बजाय, dockerfiles से निर्देशिका नाम प्रतिस्थापित किया जाएगा

नियोजित करें:

 deploy:{{ environment }}:{{ app }}: stage: deploy tags: - {{ environment }} script: - qbec apply {{ environment }} --root deploy/{{ app }} --force:k8s-context __incluster__ --wait --yes only: changes: - deploy/{{ app }}/**/* refs: - {{ environment }} 

जहां {{ app }} बजाय, तैनाती से निर्देशिका नाम प्रतिस्थापित किया जाएगा,
और {{ environment }} बजाय - उस पर्यावरण का नाम जिसमें आप तैनात करना चाहते हैं।

आइए एक अलग परिवाद / jobs.jsonnet में वस्तुओं के रूप में हमारी नौकरियों के प्रोटोटाइप का वर्णन करें

 { //    docker- dockerImage(name):: { tags: ['build'], stage: 'build', image: { name: 'gcr.io/kaniko-project/executor:debug-v0.15.0', entrypoint: [''], }, script: [ 'echo "{\\"auths\\":{\\"$CI_REGISTRY\\":{\\"username\\":\\"$CI_REGISTRY_USER\\",\\"password\\":\\"$CI_REGISTRY_PASSWORD\\"}}}" > /kaniko/.docker/config.json', '/kaniko/executor --cache --context $CI_PROJECT_DIR/dockerfiles/' + name + ' --dockerfile $CI_PROJECT_DIR/dockerfiles/' + name + '/Dockerfile --destination $CI_REGISTRY_IMAGE/' + name + ':$CI_COMMIT_TAG --build-arg VERSION=$CI_COMMIT_TAG', ], }, //    qbec- qbecApp(name): { stage: 'deploy', script: [ 'qbec apply $CI_COMMIT_REF_NAME --root deploy/' + name + ' --force:k8s-context __incluster__ --wait --yes', ], only: { changes: [ 'deploy/' + name + '/**/*', ], }, }, } 

कृपया ध्यान दें कि मैंने जानबूझकर हमारे पुस्तकालय को और अधिक लचीला बनाने के लिए रेफ्स और tags को निर्दिष्ट नहीं किया है और पूरी तरह से आपको jsonnet की क्षमताओं को प्रदर्शित करता है, हम उन्हें बाद में मुख्य फाइल से जोड़ देंगे।

अब हम अपने .itlab-ci.jsonnet का वर्णन करेंगे:

 //    local jobs = import 'lib/jobs.libsonnet'; //    local ref(x) = { only+: { refs: [x] } }; local tag(x) = { tags: [x] }; local submodule(x) = { variables+: { GIT_SUBMODULE_STRATEGY: x } }; { // C docker- ['build:' + x]: jobs.dockerImage(x) + tag('build') + ref('tags') for x in [ 'dinner', 'drunk', 'fanatical', 'guarantee', 'guitar', 'harmonious', 'shop', 'smelly', 'thunder', 'yarn', ] } + { //         'prod' ['deploy:prod:' + x]: jobs.qbecApp(x) + tag('prod') + ref('prod') for x in [ 'dinner', 'hall', ] } + { //   git-submodule ['deploy:' + env + ':' + app]: jobs.qbecApp(app) + tag(env) + ref(env) + submodule('normal') for env in ['devel', 'stage', 'prod'] for app in [ 'brush', 'fanatical', 'history', 'shop', ] } + { //    ['deploy:' + env + ':' + app]: jobs.qbecApp(app) + tag(env) + ref(env) for env in ['devel', 'stage', 'prod'] for app in [ 'analyse', 'basin', 'copper', 'dirty', 'drab', 'drunk', 'education', 'faulty', 'guarantee', 'guitar', 'harmonious', 'iron', 'maniacal', 'mist', 'nine', 'pleasant', 'polish', 'receipt', 'smelly', 'solid', 'stroke', 'thunder', 'ultra', 'yarn', ] } 

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

थोड़ी सी व्याख्या: ओवरराइड ऑब्जेक्ट के लिए " +: " के बजाय " +: " का उपयोग करना आपको किसी मौजूदा ऑब्जेक्ट या सूची में एक मूल्य जोड़ने की अनुमति देता है।

उदाहरण के लिए " : " रेफ के लिए :

 local job = { script: ['echo 123'], only: { refs: ['tags'] }, }; local ref(x) = { only+: { refs: [x] } }; job + ref('prod') 

लौटेगा:

 { "only": { "refs": [ "prod" ] }, "script": [ "echo 123" ] } 

और यहाँ refs के लिए " +: " है:

 local job = { script: ['echo 123'], only: { refs: ['tags'] }, }; local ref(x) = { only+: { refs+: [x] } }; job + ref('prod') 

लौटेगा:

 { "only": { "refs": [ "prod", "tags" ] }, "script": [ "echo 123" ] } 

जैसा कि आप देख सकते हैं, Jsonnet के उपयोग से आप बहुत ही कुशलतापूर्वक अपनी वस्तुओं का वर्णन और विलय कर सकते हैं, आउटपुट पर आपको हमेशा तैयार JSON मिलता है, जिसे हम तुरंत हमारी .itlab-ci.yml फ़ाइल में लिख सकते हैं:

 jsonnet .gitlab-ci.jsonnet > .gitlab-ci.yml 

लाइनों की संख्या की जाँच करें:

 # wc -l .gitlab-ci.jsonnet lib/jobs.libsonnet .gitlab-ci.yml 77 .gitlab-ci.jsonnet 24 lib/jobs.libsonnet 1710 .gitlab-ci.yml 

मेरी राय में यह बहुत अच्छा है!

आप अधिक उदाहरण देख सकते हैं और आधिकारिक वेबसाइट पर सीधे Jsonnet महसूस कर सकते हैं: jsonnet.org
यदि आप, मेरी तरह, Jsonnet पसंद करते हैं, तो टेलीग्राम t.me/jsonnet_ru में हमारे समूह में शामिल हों