כיצד לאסוף פרויקטים בג'נקינס אם אתה צריך הרבה סביבות שונות

יש מאמרים רבים על Habré על ג'נקינס, אבל מעטים מתארים דוגמאות לאופן שבו ג'נקינס וסוכני דוקר עובדים. כל הכלים הפופולריים לבניית פרויקטים כמו Drone.io, Bitbucket Pipeline, GitLab, פעולות GitHub ואחרים, יכולים לאסוף הכל במיכלים. אבל מה עם ג'נקינס?

היום יש פתרון לבעיה: ג'נקינס 2 מעולה לעבוד איתו סוכני דוקר. במאמר זה אני רוצה לחלוק את החוויה שלי ולהראות איך אתה יכול לעשות את זה בעצמך.

למה התחלתי לפתור את הבעיה הזו?

מאז אנחנו בחברה ציטרוניום מכיוון שאנו משתמשים בטכנולוגיות רבות ושונות, עלינו לשמור גרסאות שונות של Node.JS, Gradle, Ruby, JDK ואחרות במכונת ההרכבה. אבל לעתים קרובות אי אפשר למנוע התנגשויות גרסאות. כן, אתה צודק אם אתה אומר שיש מנהלי גרסאות שונים כמו nvm, rvm, אבל לא הכל כל כך חלק איתם ולפתרונות האלה יש בעיות:

• כמות גדולה של זמן ריצה שמפתחים שוכחים לנקות;
• יש התנגשויות בין גרסאות שונות של אותם זמני ריצה;
• כל מפתח צריך סט אחר של רכיבים.

יש עוד בעיות, אבל הרשו לי לספר לכם על הפתרון.

ג'נקינס בדוקר

מכיוון ש-Docker מבוססת כיום היטב בעולם הפיתוח, ניתן להפעיל כמעט כל דבר באמצעות Docker. הפתרון שלי הוא שג'נקינס יהיה ב-Docker ויוכל להפעיל קונטיינרים אחרים של Docker. שאלה זו החלה להישאל עוד בשנת 2013 במאמר "Docker יכול כעת לפעול בתוך Docker".

בקיצור, אתה רק צריך להתקין את Docker עצמו בקונטיינר עובד ולהעלות את הקובץ /var/run/docker.sock.

הנה דוגמה של Dockerfile שהתברר עבור ג'נקינס.

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

לפיכך, קיבלנו קונטיינר Docker שיכול לבצע פקודות Docker במחשב המארח.

בניית התקנה

לא מזמן ג'נקינס קיבלה את ההזדמנות לתאר את הכללים שלה באמצעות צינור תחביר, מה שמקל למדי לשנות את סקריפט הבנייה ולאחסן אותו במאגר.

אז בואו נשים Dockerfile מיוחד במאגר עצמו, שיכיל את כל הספריות הדרושות לבנייה. כך, המפתח עצמו יכול להכין סביבה שניתנת לחזרה ולא יצטרך לבקש מ-OPS להתקין גרסה ספציפית של Node.JS על המארח.

FROM node:12.10.0-alpine

RUN npm install yarn -g

תמונת בנייה זו מתאימה לרוב יישומי Node.JS. מה אם, למשל, אתה צריך תמונה עבור פרויקט JVM עם סורק Sonar כלול בתוכו? אתה חופשי לבחור את הרכיבים שאתה צריך להרכבה.

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איפה אתה יכול לציין:

• שם מיכל ההרכבה בהתאם למדיניות השמות שלך;
• ארגומנטים הדרושים להפעלת הקונטיינר ה-build, כאשר במקרה שלנו אנו מעלים את הספרייה הנוכחית בתור ספרייה בתוך הקונטיינר.

וכבר בשלבי הבנייה אנו מציינים אילו פקודות לבצע בתוך סוכן הבנייה של Docker. זה יכול להיות כל דבר, אז אני גם משיק פריסת יישומים באמצעות ansible.

להלן אני רוצה להראות Jenkinsfile גנרי שיישום 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-plugin. אבל אני אדבר על זה בעתיד.

מקור: www.habr.com