Jenkins Pipeline — мощный инструмент для автоматизации конвейеров доставки программного обеспечения. Одним из общих требований во многих проектах является необходимость ограничить место выполнения конкретного конвейера. В этой статье мы рассмотрим различные способы достижения этой цели, используя разговорный язык и попутно предоставляя примеры кода.

Метод 1: Метка узла
Один простой способ ограничить выполнение конвейера Jenkins — использовать шаг nodeи указать метку, соответствующую конкретному агенту или группе агентов. Это гарантирует, что конвейер будет работать только на узлах с совпадающими метками. Вот пример:

pipeline {
    agent {
        label 'linux' // Restrict to nodes with the 'linux' label
    }
    stages {
        // Define your stages here
    }
}

Метод 2: ограничения использования узла
Jenkins предоставляет дополнительные параметры для ограничения выполнения конвейера в зависимости от использования узла. Эти параметры включают в себя:

• canRoam: установка значения falseгарантирует, что конвейер будет работать только на назначенном узле, а не на каком-либо доступном агенте.
• customWorkspace: укажите каталог пользовательской рабочей области на определенном узле, ограничив конвейер этим местоположением.

Вот пример, сочетающий оба варианта:

pipeline {
    agent {
        node {
            label 'linux'
            customWorkspace '/var/jenkins/workspace/my-project' // Restrict to a specific workspace directory
            canRoam false // Pipeline must run only on the designated node
        }
    }
    stages {
        // Define your stages here
    }
}

Метод 3: Ввод конвейера
Вы также можете запросить ввод пользователя во время выполнения конвейера, чтобы проверить место выполнения, прежде чем продолжить. Это может быть полезно, если вы хотите вручную определить место развертывания. Вот пример:

pipeline {
    agent any
    stages {
        stage('Deployment Location Confirmation') {
            steps {
                input 'Please confirm the deployment location'
            }
        }
// Define your remaining stages
    }
}

Метод 4: целевые переменные среды
Другой подход к ограничению выполнения конвейера — использование переменных среды. Вы можете определить переменные среды, специфичные для разных узлов или групп узлов, и использовать их для условного выполнения определенных этапов или шагов. Вот пример:

pipeline {
    agent any
    stages {
        stage('Environment Check') {
            steps {
                script {
                    if (env.NODE_NAME == 'linux-agent') {
                        // Execute specific stages for Linux agents
                    } else if (env.NODE_NAME == 'windows-agent') {
                        // Execute specific stages for Windows agents
                    } else {
                        error('Invalid deployment location')
                    }
                }
            }
        }
// Define your remaining stages
    }
}

В этой статье мы рассмотрели несколько методов ограничения выполнения конвейера Jenkins определенными местоположениями. Используя метки узлов, ограничения на использование узлов, входные данные конвейера и переменные целевой среды, вы можете гарантировать, что ваш конвейер работает только там, где он предназначен, обеспечивая лучший контроль и гибкость в ваших рабочих процессах CI/CD.