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

В Habré има много статии за Дженкинс, но малко описват примери за това как работят Дженкинс и докер агентите. Всички популярни инструменти за изграждане на проекти като Drone.io, Bitbucket тръбопровод, GitLab, GitHub действия и други, могат да събират всичко в контейнери. Но какво да кажем за Дженкинс?

Днес има решение на проблема: Jenkins 2 е страхотен за работа Докер агенти. В тази статия искам да споделя опита си и да покажа как можете да го направите сами.

Защо започнах да решавам този проблем?

Тъй като сме в компания Цитроний Тъй като използваме много различни технологии, трябва да поддържаме различни версии на Node.JS, Gradle, Ruby, JDK и други на асемблиращата машина. Но често конфликтите на версиите не могат да бъдат избегнати. Да, ще бъдете прави, ако кажете, че има различни мениджъри на версии като nvm, rvm, но не всичко е толкова гладко с тях и тези решения имат проблеми:

• голямо количество време за изпълнение, което разработчиците забравят да почистят;
• има конфликти между различни версии на едно и също време за изпълнение;
• Всеки разработчик се нуждае от различен набор от компоненти.

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

Дженкинс в Docker

Тъй като Docker вече е добре установен в света на разработката, почти всичко може да се стартира с помощта на Docker. Моето решение е да имам Jenkins в 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/

Описахме асемблиращата среда, но какво общо има Дженкинс с нея? И агентите на Jenkins могат да работят с такива изображения на Docker и да ги създават вътрешно.

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