Jenkins Pipeline

目次

• 概要
• 使用場面
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

宣言的およびスクリプト型のアプローチを使用してエンタープライズグレードの Jenkins パイプラインを作成し、高度な制御フローでビルド、テスト、デプロイを自動化します。

使用場面

• エンタープライズ CI/CD インフラストラクチャ
• 複雑な多段階ビルド
• オンプレミスデプロイメント自動化
• パラメータ化されたビルド

クイックスタート

最小限の動作例：

pipeline {
    agent { label 'linux-docker' }
    environment {
        REGISTRY = 'docker.io'
        IMAGE_NAME = 'myapp'
    }
    parameters {
        string(name: 'DEPLOY_ENV', defaultValue: 'staging')
    }
    stages {
        stage('Checkout') { steps { checkout scm } }
        stage('Install') { steps { sh 'npm ci' } }
        stage('Lint') { steps { sh 'npm run lint' } }
        stage('Test') {
            steps {
                sh 'npm run test:coverage'
                junit 'test-results.xml'
            }
        }
        stage('Build') {
            steps {
                sh 'npm run build'
                archiveArtifacts artifacts: 'dist/**/*'
            }
        }
// ... (詳細な実装については以下のリファレンスガイドを参照)

リファレンスガイド

references/ ディレクトリの詳細な実装：

ガイド	内容
宣言的パイプライン (Jenkinsfile)	宣言的パイプライン (Jenkinsfile)
スクリプト型パイプライン	スクリプト型パイプライン (Groovy)、マルチブランチパイプライン、パラメータ化されたパイプライン、認証情報を使用したパイプライン

ベストプラクティス

✅ 推奨

• 明確性のために宣言的パイプラインを使用する
• シークレット管理に credentials プラグインを使用する
• アーティファクトとレポートをアーカイブする
• 本番環境へのデプロイ時に承認ゲートを実装する
• パイプラインをモジュール化し再利用可能にする

❌ 非推奨

• パイプラインコードに認証情報を保存する
• パイプラインエラーを無視する
• テストカバレッジレポートを省略する
• 廃止されたプラグインを使用する