Како да собирате проекти во Џенкинс ако ви требаат многу различни средини

Има многу написи на Хабре за Џенкинс, но малкумина опишуваат примери за тоа како функционираат Џенкинс и докерските агенти. Сите популарни алатки за изградба на проекти како Drone.io, Bitbucket гасовод, GitLab, Дејства на GitHub и други, можат да соберат сè во контејнери. Но, што е со Џенкинс?

Денес има решение за проблемот: Џенкинс 2 одлично работи со него Докер агенти. Во оваа статија сакам да го споделам моето искуство и да покажам како можете сами да го направите тоа.

Зошто почнав да го решавам овој проблем?

Бидејќи сме во друштво Цитрониум Бидејќи користиме многу различни технологии, мораме да чуваме различни верзии на Node.JS, Gradle, Ruby, JDK и други на машината за склопување. Но, честопати не може да се избегнат конфликтите на верзијата. Да, ќе бидете во право ако кажете дека постојат различни менаџери за верзии како nvm, rvm, но не е сè така мазно со нив и овие решенија имаат проблеми:

• голема количина на траење што програмерите забораваат да го исчистат;
• има конфликти помеѓу различни верзии на исто време на траење;
• Секој развивач има потреба од различен сет на компоненти.

Има и други проблеми, но да ви кажам за решението.

Џенкинс во Докер

Бидејќи 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 со вклучен скенер на Сонар? Слободно можете да ги изберете компонентите што ви се потребни за склопување.

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каде што можете да наведете:

• името на контејнерот за склопување според вашата политика за именување;
• аргументи потребни за извршување на контејнерот за изградба, каде што во нашиот случај го монтираме тековниот директориум како директориум внатре во контејнерот.

И веќе во чекорите за градење укажуваме кои команди да се извршат внатре во агентот за изградба на 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.

При пишувањето на овој напис, се појави дискусија за користење агенти на оддалечени сервери за да не се вчита главниот јазол користејќи приклучок докер-приклучок. Но, за ова ќе зборувам во иднина.

Извор: www.habr.com