jenkins-pipeline

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/**/*'
            }
        }
// ... (see reference guides for full implementation)

リファレンスガイド

詳細な実装は references/ ディレクトリにあります：

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

ベストプラクティス

✅ 推奨事項

• 明確さを保つため、宣言型パイプラインを使用します
• シークレットには credentials プラグインを使用します
• 成果物とレポートをアーカイブします
• 本番環境向けの承認ゲートを実装します
• パイプラインをモジュール化し、再利用できるようにします

❌ 避けるべきこと

• 認証情報をパイプラインのコードに保存しないでください
• パイプラインのエラーを無視しないでください
• テストカバレッジのレポートを省略しないでください
• 非推奨のプラグインを使用しないでください