Какой использовал синтаксис для настройки Jenkins?

Синтаксис конфигурации в Jenkins

При настройке Jenkins я использую несколько ключевых подходов и синтаксисов в зависимости от задачи, придерживаясь принципов Infrastructure as Code и Pipeline as Code.

1. Jenkinsfile (Declarative и Scripted Pipeline)

Это основной синтаксис для создания конвейеров. Jenkinsfile поддерживает два стиля:

Declarative Pipeline (рекомендуемый для большинства случаев):

pipeline {
    agent any
    tools {
        maven 'Maven-3.8'
        jdk 'JDK-11'
    }
    environment {
        DOCKER_REGISTRY = 'registry.example.com'
        APP_VERSION = '1.0.${BUILD_NUMBER}'
    }
    stages {
        stage('Build') {
            steps {
                sh 'mvn clean compile'
                archiveArtifacts artifacts: 'target/*.jar', fingerprint: true
            }
        }
        stage('Test') {
            steps {
                sh 'mvn test'
                junit 'target/surefire-reports/*.xml'
            }
        }
        stage('Deploy') {
            when {
                branch 'main'
            }
            steps {
                sh "docker build -t ${DOCKER_REGISTRY}/app:${APP_VERSION} ."
                sh "docker push ${DOCKER_REGISTRY}/app:${APP_VERSION}"
            }
        }
    }
    post {
        success {
            emailext (
                subject: "Build успешен: ${JOB_NAME} #${BUILD_NUMBER}",
                body: "Подробности: ${BUILD_URL}",
                to: 'team@example.com'
            )
        }
        failure {
            slackSend(color: 'danger', message: "Build провален: ${JOB_NAME}")
        }
    }
}

Scripted Pipeline (для сложной логики):

node('docker-agent') {
    stage('Checkout') {
        checkout scm
    }
    stage('Build') {
        docker.image('maven:3.8-openjdk-11').inside {
            sh 'mvn clean package'
        }
    }
    // Динамические этапы
    def services = ['api', 'web', 'worker']
    services.each { service ->
        stage("Deploy ${service}") {
            sh "./deploy.sh ${service} ${env.BUILD_NUMBER}"
        }
    }
}

2. Groovy DSL для Jenkins Configuration as Code (JCasC)

Для управления всей конфигурацией Jenkins через YAML/Groovy файлы:

JCasC YAML конфигурация (jenkins.yaml):

jenkins:
  securityRealm:
    local:
      allowsSignup: false
      users:
        - id: "admin"
          password: "${ADMIN_PASSWORD}"
  authorizationStrategy:
    roleBased:
      roles:
        global:
          - name: "admin"
            permissions:
              - "Overall/Administer"
          - name: "developer"
            permissions:
              - "Job/Build"
              - "Job/Read"
  agentProtocols:
    - "JNLP4-connect"
    - "Ping"
  clouds:
    - kubernetes:
        name: "k8s"
        serverUrl: "https://kubernetes.default.svc"
        namespace: "jenkins-agents"

3. Job DSL для автоматического создания заданий

folder('Projects') {
    displayName('All Projects')
    description('Содержит все проекты организации')
}

job('Projects/Backend-CI') {
    description('Continuous Integration для backend сервисов')
    scm {
        git {
            remote {
                url('git@github.com:company/backend.git')
                credentials('github-ssh-key')
            }
            branches('main', 'develop/*')
        }
    }
    triggers {
        scm('H/5 * * * *')
        githubPush()
    }
    steps {
        maven {
            goals('clean verify')
            mavenOpts('-Xmx2G')
        }
    }
    publishers {
        junit('**/target/surefire-reports/*.xml')
        archiveArtifacts('target/*.jar')
    }
}

4. Shared Libraries для переиспользуемого кода

Структура библиотеки:

(vars)
├── deployToK8s.groovy
├── notifySlack.groovy
└── securityScan.groovy
(src)
└── com
    └── company
        └── jenkins
            └── KubernetesDeployer.groovy

Пример шага библиотеки:

// vars/deployToK8s.groovy
def call(Map params) {
    def defaults = [
        namespace: 'default',
        timeout: '300s',
        wait: true
    ]
    def config = defaults + params
    
    sh """
        kubectl apply -f ${config.manifest} -n ${config.namespace}
        ${config.wait ? "kubectl rollout status deployment/${config.deployment} -n ${config.namespace} --timeout=${config.timeout}" : ""}
    """
}

5. Плагины и расширения через Groovy Init Scripts

Для настройки плагинов и системных параметров:

// init.groovy.d/configure-plugins.groovy
import jenkins.model.*
import hudson.model.*
import hudson.tools.*

// Настройка инструментов
def instance = Jenkins.getInstance()
def mavenInstallations = instance.getDescriptor("hudson.tasks.Maven")

def mavenTool = new Maven.MavenInstallation(
    "Maven-3.8",
    "/opt/maven-3.8.6",
    [
        new InstallSourceProperty([
            new MavenInstaller("3.8.6")
        ])
    ]
)
mavenInstallations.setInstallations(mavenTool)
mavenInstallations.save()

6. Практические паттерны использования

• Условное выполнение этапов:

when {
    anyOf {
        branch 'main'
        branch 'release/*'
    }
    not {
        triggeredBy 'TimerTrigger'
    }
}

• Параллельное выполнение:

stage('Parallel Tests') {
    parallel {
        stage('Unit Tests') {
            steps { sh './run-unit-tests.sh' }
        }
        stage('Integration Tests') {
            steps { sh './run-integration-tests.sh' }
        }
    }
}

• Обработка ошибок:

steps {
    retry(3) {
        sh './flakey-script.sh'
    }
    timeout(time: 10, unit: 'MINUTES') {
        waitForQualityGate abortPipeline: true
    }
}

Ключевые принципы, которые я соблюдаю:

• Все конфигурации хранятся в Git (кроме секретов)
• Использую Credentials Binding для управления секретами
• Минимизирую использование веб-интерфейса для настройки
• Применяю Terraform или Helm для развертывания самого Jenkins
• Использую Configuration as Code Plugin для воспроизводимости

Такой подход обеспечивает идемпотентность, аудируемость и возможность быстрого восстановления всей инфраструктуры Jenkins, что критически важно в DevOps-практиках.