Slack 연동 및 알림 설정

Jenkins 빌드가 실패했는데 아무도 몰라서 반나절이 지나간 경험이 있다면, 빌드 알림 자동화가 필요합니다.

Jenkins-Slack 연동 은 빌드 결과(성공/실패)를 실시간으로 팀 채널에 자동 전송하여, 빌드 실패를 즉시 인지하고 빠르게 대응할 수 있게 합니다.

코드 Push → Jenkins 빌드 실행 → 빌드 결과(성공/실패) → Slack 채널에 알림 전송

1. Slack에 Jenkins CI 앱 추가

1. Slack에서 더보기 > ** 앱** 으로 이동합니다.
2. Jenkins CI 를 검색하여 추가합니다.
3. 앱 추가 후 설정 지침 페이지에서 아래 값을 확인합니다.

2. Jenkins에 Slack 플러그인 설치

Manage Jenkins > Plugins > Available Plugins 에서 Slack Notification을 검색하여 설치합니다.

3. Jenkins Slack 설정

Credential 등록

1. Manage Jenkins > System > Slack 섹션으로 이동합니다.
2. Credential 옆 + Add > Jenkins 클릭합니다.
3. 아래와 같이 입력합니다.

Slack 설정 입력

연결 테스트

Test Connection 버튼을 클릭합니다. 성공하면 지정한 Slack 채널에 테스트 알림 메시지가 도착합니다.

4. Jenkinsfile에 Slack 알림 스크립트 추가

파이프라인의 post 블록에서 빌드 결과에 따라 Slack 알림을 전송합니다.

pipeline {
    agent any

    tools {
        jdk 'OpenJDK17'
    }

    stages {
        stage('Build') {
            steps {
                sh 'mvn clean package -DskipTests'
            }
        }
    }

    post {
        success {
            slackSend(
                channel: '#빌드알림',
                color: '#36A64F',
                message: """*빌드 성공*
Job: ${env.JOB_NAME} [#${env.BUILD_NUMBER}]
Branch: ${env.BRANCH_NAME ?: 'N/A'}
소요 시간: ${currentBuild.durationString}
<${env.BUILD_URL}|빌드 상세 보기>"""
            )
        }
        failure {
            slackSend(
                channel: '#빌드알림',
                color: '#FF0000',
                message: """*빌드 실패*
Job: ${env.JOB_NAME} [#${env.BUILD_NUMBER}]
Branch: ${env.BRANCH_NAME ?: 'N/A'}
<${env.BUILD_URL}console|콘솔 로그 확인>"""
            )
        }
    }
}

slackSend 주요 파라미터

팁: ${env.BUILD_URL}을 활용하면 Slack 알림에서 바로 Jenkins 빌드 페이지로 이동할 수 있는 링크를 제공할 수 있습니다. 빌드 실패 시 빠른 원인 파악에 유용합니다.

트러블슈팅

주의할 점

Jenkins CI 앱 채널 미초대

Slack 채널에 Jenkins CI 앱을 초대하지 않으면 알림이 전송되지 않습니다. 채널 설정에서 앱을 초대하거나, /invite @Jenkins CI 명령어를 사용합니다.

채널명 형식

slackSend의 channel 파라미터에는 반드시 # 접두사를 포함해야 합니다. 빌드알림이 아니라 #빌드알림으로 지정합니다.

정리