Налаштування CI/CD для сайту через Jenkins

Налаштування CI/CD для сайту через Jenkins

Jenkins — зріла open-source система автоматизації. Вимагає власного сервера, але ніяких обмежень на хвилини, агенти, паралельні сборки. Для організацій з суворими вимогами до ізоляції інфраструктури або великим обсягом сборок — обґрунтований вибір.

Установка

# Ubuntu 22.04, Java 17 обов'язковий
apt install fontconfig openjdk-17-jre
wget -O /usr/share/keyrings/jenkins-keyring.asc \
  https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key
apt update && apt install jenkins

systemctl enable --now jenkins
# Доступний на :8080

Мінімум: 2 CPU, 4 ГБ RAM.

Declarative Pipeline (Jenkinsfile)

pipeline {
    agent any

    tools {
        nodejs 'NodeJS-20'
    }

    environment {
        DEPLOY_HOST = credentials('deploy-host')
        DEPLOY_KEY  = credentials('deploy-ssh-key')
    }

    stages {
        stage('Checkout') {
            steps {
                checkout scm
            }
        }

        stage('Install') {
            steps {
                sh 'npm ci'
            }
        }

        stage('Test') {
            steps {
                sh 'npm test'
            }
            post {
                always {
                    junit 'test-results/**/*.xml'
                }
            }
        }

        stage('Build') {
            steps {
                sh 'npm run build'
            }
        }

        stage('Deploy') {
            when {
                branch 'main'
            }
            steps {
                sshagent(['deploy-ssh-key']) {
                    sh '''
                        rsync -avz --delete dist/ deploy@${DEPLOY_HOST}:/var/www/mysite/
                    '''
                }
            }
        }
    }

    post {
        failure {
            telegramSend(message: "Build failed: ${env.JOB_NAME}", chatId: '...')
        }
    }
}

Управління credentials

Manage Jenkins → Credentials → Secret text, SSH keys, certificates. Ніколи у коді.

withCredentials([
    string(credentialsId: 'telegram-token', variable: 'TG_TOKEN')
]) {
    sh 'echo $TG_TOKEN'
}

Паралельні стадії

stage('Test & Lint') {
    parallel {
        stage('Unit Tests') {
            steps { sh 'npm test' }
        }
        stage('Lint') {
            steps { sh 'npm run lint' }
        }
    }
}

Docker-агенти

pipeline {
    agent none

    stages {
        stage('Build') {
            agent {
                docker {
                    image 'node:20-alpine'
                }
            }
            steps {
                sh 'npm ci && npm run build'
            }
        }
    }
}

Час налаштування: 2-3 дні для сервера + першого робочого конвеєру.