Jenkins

Jenkins Blue Oceanの導入とCI/CDワークフロー設定手順

ⓘ本ページはプロモーションが含まれています

スポンサードリンク

Jenkins Blue OceanでCI/CDワークフローを効率化する手順と設定方法

JenkinsのBlue Oceanは、従来の複雑なUIから脱却し、現代的な開発環境に合わせた直感的な操作性を提供します。2025年の最新情報に基づき、Jenkins Blue Ocean 設定 手順と具体的なトラブルシューティングを解説し、パイプライン構築からエラーメッセージ可視化までを網羅的に紹介します。

事前準備: Jenkins環境の確認と基本設定

Blue Oceanの導入にあたっては、Jenkins本体とプラグインの互換性を明確にすることが不可欠です。以下に必要な前提条件と手順を整理しました。

導入前の重要な確認点

  • Jenkinsバージョン: 2025年現在では、Jenkins 2.413以上が推奨されています（公式ドキュメントを参照）。
  • プラグイン要件: Blue Ocean本体と「Blue Ocean Pipeline」を含む7つの公式プラグインが必要です。

Jenkinsサーバーの環境確認手順

以下のステップでJenkins環境が適切かを検証してください。

  1. Jenkins管理画面（http://<ホスト>:5000）にアクセス
  2. Manage Jenkins > System Informationを開き、Jenkins VersionとPlugin Managerの状態を確認
  3. Blue Ocean Pipelineプラグインが有効化されているかをチェック

注意: Blue OceanはJava 17以上に対応しており、バージョン不足で動作しない場合があります。

プラグイン管理画面へのアクセス方法

既存のプラグインと競合しないよう、以下の手順で確認します：

  1. Manage Jenkins > Manage Plugins にアクセス
  2. 「Available」タブで「Blue Ocean Plugin」を検索し、最新バージョン（2025年現在: v1.24）が表示されているかを確認
  3. インストールしていない場合は「Install without restart」または「Download now and install after restart」を選択

Blue Oceanプラグインの導入手順と注意点

Blue Oceanプラグインは、公式Marketplaceから入手可能です。以下に手順と最新情報を解説します。

導入にあたっての重要事項

  • 導入方法: Jenkins 2.413以上では「Install without restart」が推奨（再起動なしで動作）。
  • バージョン管理: 2025年現在、Blue Oceanプラグインは公式リポジトリに6種類のサブプラグインを含む形で配布されています。

Marketplaceからの検索・導入手順

  1. Manage Jenkins > Manage Plugins > Availableタブを開く
  2. 検索バーに「Blue Ocean」を入力し、Blue Ocean Plugin (with Pipeline)を選択
  3. 「Install without restart」を選択（再起動不要な場合）または「Download now and install after restart」

インストール後の動作確認とトラブルシューティング

インストール完了後は、以下の手順で動作確認をします：

  1. Jenkinsサーバーを再起動（sudo systemctl restart jenkinsなど）
  2. ブラウザで http://<ホスト>:5000/blue/ にアクセスし、UIが表示されるか確認

エラー例: No such plugin found: 'blueocean' は、プラグインのバージョン不一致またはJenkinsの再起動未実施を疑う必要があります。

Blue Ocean UIの初期設定とセキュリティ対策

Blue Ocean UIを安全かつ効率的に運用するには、初期設定が不可欠です。以下に重要なポイントを整理しました。

UI起動確認手順

  1. ブラウザで http://<ホスト>:5000/blue/ にアクセス
  2. 初回アクセス時に 「Get Started」 をクリックし、プロジェクトを新規作成
  3. Blue Oceanのダッシュボードが表示されれば設定は成功です

セキュリティ設定の基本調整

以下のように公式推奨の最小限なセキュリティ対策を行います：

  • ユーザー認証: Jenkinsの標準ログイン機能を使用（複雑なパスワードを必須）
  • HTTPS化: Manage Jenkins > Configure Global Securityで「Enable HTTPS」を有効化

補足: Blue Ocean UIでは、IPアドレス制限やOAuth認証による外部アクセスの制御が可能です。

パイプライン作成の実践手順と最適化手法

Blue Oceanでは、スクリプトあり・なしの両方でパイプラインを作成できます。以下に具体的な手順を示します。

スクリプトなしでのGUI作成手順

  1. http://<ホスト>:5000/blue/ にアクセスし、New Item をクリック
  2. Pipelineを選択し、「Create Pipeline」をクリック
  3. プロジェクト名を入力して「OK」を押下
  4. ステップ追加（Build, Test, Deploy）をドラッグ＆ドロップで操作

Jenkinsfileによる宣言的構文の設定例

手順 説明
1. Jenkinsfileをプロジェクトルートに配置
2. Blue Oceanから「Add Pipeline」を選択
3. 「Pipeline Script from SCM」を選んでJenkinsfileを指定

ビルドステップのカスタマイズと最新技術との連携

Blue Oceanでは、DockerやKubernetesなど最新技術との連携が可能です。以下に具体的な実装例を示します。

Dockerとの連携手順

  1. Blue OceanのPipelineステップで「Add build step」を選択
  2. sh 'docker build -t myapp . && docker push myapp' をコマンドとして追加
  3. イメージをリモートレジストリへプッシュ

Kubernetesとの連携手順

  1. Pipelineステップに「Add deploy step」を選択
  2. kubectl apply -f deployment.yaml コマンドをBuildステップに含める
  3. k8s.namespace環境変数で適切なNamespace指定を行う

エラーメッセージの可視化と具体的なトラブルシューティング事例

Blue Oceanはエラー発生時のログ出力レベルを細かく設定できるため、デバッグが容易です。以下に最新バージョン対応の手順と事例を紹介します。

ログ出力レベルの調整方法

  1. Manage Jenkins > System Log から「Level」を FINEST に変更
  2. パイプライン実行時にエラーメッセージが詳細に出力されるようになる

例: No such plugin found: 'blueocean' の場合は、プラグインのバージョン不一致を疑う必要があります。

よくあるエラー例と解決策

エラー内容 解決策
パイプラインが実行されない Jenkinsfileの場所や構文を再確認（Jenkinsfileがプロジェクトルートに配置されているか）
UIにアクセスできない 5000ポートが開いているか、ファイアウォール設定をチェック（OSレベルのセキュリティポリシーも含む）

記事の要点まとめと導入へのアドバイス

  • Blue Ocean導入準備: Jenkinsバージョン2.413以上で、公式プラグイン管理画面から手順通りにインストール
  • UI初期設定: http://<ホスト>:5000/blue/ にアクセスしセキュリティ設定を強化（HTTPS導入推奨）
  • パイプライン作成: GUIでもJenkinsfileでも柔軟に対応可能（最新バージョンではDocker/Kubernetes連携がスムーズ）
  • カスタマイズ: パラメータ調整やステップ分岐で効率化（env.ENV_TYPE変数を活用）
  • トラブルシューティング: ログレベルの変更でエラー可視化、よくあるミスを回避（例: Jenkinsfile配置位置の確認）

Blue Oceanを活用すれば、CI/CDワークフローは見やすさと効率性が同時に向上します。記事を参考に導入し、あなたの開発プロセスを刷新してみてください。

スポンサードリンク

-Jenkins