यदि आपको कई अलग-अलग परिवेशों की आवश्यकता है तो जेनकींस में प्रोजेक्ट कैसे एकत्र करें

जेनकींस के बारे में हैबे पर कई लेख हैं, लेकिन जेनकींस और डॉकर एजेंट कैसे काम करते हैं, इसके कुछ उदाहरण बताते हैं। जैसे सभी लोकप्रिय प्रोजेक्ट बिल्ड टूल Drone.io, बिटबकेट पाइपलाइन, GitLab, GitHub क्रियाएँ और अन्य, सब कुछ कंटेनरों में एकत्र कर सकते हैं। लेकिन जेनकींस के बारे में क्या?

आज समस्या का समाधान है: जेनकिंस 2 के साथ काम करना बहुत अच्छा है डॉकर एजेंट. इस लेख में मैं अपना अनुभव साझा करना चाहता हूं और दिखाना चाहता हूं कि आप इसे स्वयं कैसे कर सकते हैं।

मैंने इस समस्या को हल करना क्यों शुरू किया?

चूंकि हम कंपनी में हैं सिट्रोनियम चूँकि हम कई अलग-अलग तकनीकों का उपयोग करते हैं, इसलिए हमें असेंबली मशीन पर Node.JS, Gradle, Ruby, JDK और अन्य के विभिन्न संस्करण रखने होंगे। लेकिन अक्सर संस्करण विरोधों को टाला नहीं जा सकता। हां, आप सही होंगे यदि आप कहते हैं कि एनवीएम, आरवीएम जैसे विभिन्न संस्करण प्रबंधक हैं, लेकिन उनके साथ सब कुछ इतना आसान नहीं है और इन समाधानों में समस्याएं हैं:

• बड़ी मात्रा में रनटाइम जिसे डेवलपर्स साफ़ करना भूल जाते हैं;
• एक ही रनटाइम के विभिन्न संस्करणों के बीच टकराव होते हैं;
• प्रत्येक डेवलपर को घटकों के एक अलग सेट की आवश्यकता होती है।

और भी समस्याएं हैं, लेकिन मैं आपको समाधान के बारे में बताता हूं।

डॉकर में जेनकींस

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

संक्षेप में, आपको बस डॉकर को एक कार्यशील कंटेनर में स्थापित करना होगा और फ़ाइल को माउंट करना होगा /var/run/docker.sock.

यहां एक उदाहरण डॉकरफ़ाइल है जो जेनकींस के लिए निकला।

FROM jenkins/jenkins:lts

USER root

RUN apt-get update && 

apt-get -y install apt-transport-https 
     ca-certificates 
     curl 
     gnupg2 
     git 
     software-properties-common && 
curl -fsSL https://download.docker.com/linux/$(. /etc/os-release; echo "$ID")/gpg > /tmp/dkey; apt-key add /tmp/dkey && 
add-apt-repository 
   "deb [arch=amd64] https://download.docker.com/linux/$(. /etc/os-release; echo "$ID") 
   $(lsb_release -cs) 
   stable" && 
apt-get update && 
apt-get -y install docker-ce && 
usermod -aG docker jenkins

RUN curl -L https://github.com/docker/compose/releases/download/1.25.0/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose && chmod +x /usr/local/bin/docker-compose 

RUN apt-get clean autoclean && apt-get autoremove —yes && rm -rf /var/lib/{apt,dpkg,cache,log}/

USER jenkins

इस प्रकार, हमें एक डॉकर कंटेनर मिला जो होस्ट मशीन पर डॉकर कमांड निष्पादित कर सकता है।

सेटअप बनाएँ

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

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

FROM node:12.10.0-alpine

RUN npm install yarn -g

यह बिल्ड छवि अधिकांश Node.JS अनुप्रयोगों के लिए उपयुक्त है। क्या होगा यदि, उदाहरण के लिए, आपको जेवीएम प्रोजेक्ट के लिए सोनार स्कैनर के साथ एक छवि की आवश्यकता है? आप असेंबली के लिए आवश्यक घटकों को चुनने के लिए स्वतंत्र हैं।

FROM adoptopenjdk/openjdk12:latest

RUN apt update 
    && apt install -y 
        bash unzip wget

RUN mkdir -p /usr/local/sonarscanner 
    && cd /usr/local/sonarscanner 
    && wget https://binaries.sonarsource.com/Distribution/sonar-scanner-cli/sonar-scanner-cli-3.3.0.1492-linux.zip 
    && unzip sonar-scanner-cli-3.3.0.1492-linux.zip 
    && mv sonar-scanner-3.3.0.1492-linux/* ./ 
    && rm sonar-scanner-cli-3.3.0.1492-linux.zip 
    && rm -rf sonar-scanner-3.3.0.1492-linux 
    && ln -s /usr/local/sonarscanner/bin/sonar-scanner /usr/local/bin/sonar-scanner

ENV PATH $PATH:/usr/local/sonarscanner/bin/
ENV SONAR_RUNNER_HOME /usr/local/sonarscanner/bin/

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

stage("Build project") {
    agent {
        docker {
            image "project-build:${DOCKER_IMAGE_BRANCH}"
            args "-v ${PWD}:/usr/src/app -w /usr/src/app"
            reuseNode true
            label "build-image"
        }
    }
    steps {
        sh "yarn"
        sh "yarn build"
    }
}

आदेश agent संपत्ति का उपयोग करता है dockerआप कहां निर्दिष्ट कर सकते हैं:

• आपकी नामकरण नीति के अनुसार असेंबली कंटेनर का नाम;
• बिल्ड कंटेनर को चलाने के लिए आवश्यक तर्क, जहां हमारे मामले में हम वर्तमान निर्देशिका को कंटेनर के अंदर एक निर्देशिका के रूप में माउंट करते हैं।

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

नीचे मैं एक सामान्य जेनकिंसफाइल दिखाना चाहता हूं जिसे एक साधारण Node.JS एप्लिकेशन बना सकता है।

def DOCKER_IMAGE_BRANCH = ""
def GIT_COMMIT_HASH = ""

pipeline { 
    options {
        buildDiscarder(
            logRotator(
                artifactDaysToKeepStr: "",
                artifactNumToKeepStr: "",
                daysToKeepStr: "",
                numToKeepStr: "10"
            )
        )
        disableConcurrentBuilds()
    }

    agent any

    stages {

        stage("Prepare build image") {
            steps {
                sh "docker build -f Dockerfile.build . -t project-build:${DOCKER_IMAGE_BRANCH}"
            }
        }

        stage("Build project") {
            agent {
                docker {
                    image "project-build:${DOCKER_IMAGE_BRANCH}"
                    args "-v ${PWD}:/usr/src/app -w /usr/src/app"
                    reuseNode true
                    label "build-image"
                }
            }
            steps {
                sh "yarn"
                sh "yarn build"
            }
        }

    post {
        always {
            step([$class: "WsCleanup"])
            cleanWs()
        }
    }

}

क्या हुआ?

इस पद्धति के लिए धन्यवाद, हमने निम्नलिखित समस्याओं का समाधान किया:

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

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

आप मेरे द्वारा एकत्रित की गई छवि का भी उपयोग कर सकते हैं जेनकींस + डॉकर. सभी स्रोत खुले हैं और यहां स्थित हैं rmuhamedgaliev/jenkins_docker.

इस लेख को लिखते समय, दूरस्थ सर्वर पर एजेंटों का उपयोग करने के बारे में चर्चा हुई ताकि प्लगइन का उपयोग करके मास्टर नोड को लोड न किया जा सके docker-प्लगइन. लेकिन मैं इस बारे में भविष्य में बात करूंगा.

स्रोत: www.habr.com