Jenkins インターフェースの探索

JenkinsBeginner
オンラインで実践に進む

はじめに

Jenkins を実際に体験する最初の機会へようこそ。Jenkins は、ソフトウェアのビルド、テスト、デプロイに使用される強力なオープンソースの自動化サーバーであり、継続的インテグレーションおよび継続的デプロイメント(CI/CD)として知られる実践です。

この実験では、Jenkins のユーザーインターフェースの基本的な側面に慣れていただきます。メインダッシュボードの操作方法、最初のシンプルなプロジェクトの作成と設定方法、ビルドの実行方法、そして結果の確認方法を説明します。この環境では Jenkins サービスは既にインストールされ、実行されていますので、その機能の探索に直接集中できます。

この実験の終わりには、以下のことができるようになります。

  • メインの Jenkins ダッシュボードを操作する。
  • 新しい Freestyle プロジェクトを作成する。
  • ビルドジョブを手動で実行する。
  • ビルド履歴とコンソール出力を表示する。

始めましょう。

Jenkins ダッシュボードへのアクセスと探索

このステップでは、JenkinsのWebインターフェースにログインし、メインダッシュボードに慣れていただきます。Jenkinsサービスはすでにコンテナ内で実行されています。

まず、JenkinsのWebインターフェースにアクセスします。LabEx画面の上部にあるDesktop Interfaceタブをクリックしてください。仮想デスクトップ内で、Firefoxウェブブラウザを開きます。ブラウザは自動的に http://localhost:8080 を開くため、手動でURLを入力する必要はありません。ログインは不要です。

Jenkins login page

メインのJenkinsダッシュボードが表示されます。主要なコンポーネントを確認してください。

  • ナビゲーションサイドバー(左側): これは主要なナビゲーションメニューです。New Item(新しいジョブを作成するため)、Build History(すべてのビルドのグローバルビュー)などの重要なリンクがあります。
  • メインコンテンツエリア: このエリアには、作成したすべてのジョブのリストが表示されます。最初は空です。

ダッシュボードに慣れたので、最初のプロジェクトを作成する準備が整いました。

Freestyle プロジェクトの作成

このステップでは、「フリースタイルプロジェクト (Freestyle project)」タイプを使用して、最初の Jenkins ジョブを作成します。フリースタイルプロジェクトは非常に柔軟で使いやすいオプションであり、初心者や幅広い自動化タスクに最適です。

  1. Jenkins の Web インターフェースで、左側のナビゲーションサイドバーにある New Item をクリックします。

  2. 次のページで、プロジェクトの名前を指定し、そのタイプを選択する必要があります。

    • Enter an item name フィールドに My-First-Job と入力します。
    • オプションのリストから Freestyle project を選択します。
    • 下部にある OK ボタンをクリックします。
Jenkins project creation page
  1. これで、プロジェクトの設定ページに移動します。ここで、ジョブが何を行うかを定義します。この実験 (Lab) のために、単一の簡単なビルドステップを追加します。Build Steps セクションまでスクロールダウンします。

  2. Add build step ドロップダウンボタンをクリックし、Execute shell を選択します。これにより、ビルドの一部としてシェルコマンドを実行できるようになります。

  3. コマンドボックスが表示されます。このボックスに、次のコマンドを入力します。

    echo "Hello from my first Jenkins job!"
Jenkins project configuration page with build step
  1. 最後に、ページの下部までスクロールし、Save ボタンをクリックします。

保存後、Jenkins は新しく作成されたプロジェクト My-First-Job のメインページにリダイレクトします。

ビルドジョブの実行

このステップでは、作成したジョブを「ビルド」、つまり実行します。ジョブの実行とは、設定したステップを実行することを意味します。

現在、My-First-Job のプロジェクトページにいるはずです。もし移動してしまった場合は、メインの Jenkins ダッシュボードでその名前をクリックすることで戻ることができます。

  1. My-First-Job のプロジェクトページで、左側のナビゲーションサイドバーを確認します。Build Now と呼ばれるオプションが表示されます。
Jenkins project page Build Now button
  1. Build Now をクリックして、ビルドプロセスを開始します。

クリックすると、新しいビルドがスケジュールされます。左下の Build History セクションに表示されます。ビルドには #1 から始まる番号が割り当てられます。

ビルド番号の隣に小さなステータスアイコンが表示されます。点滅する緑色のアイコンは、ビルドが進行中であることを意味します。塗りつぶされた緑色の円は、ビルドが成功したことを意味します。今回のジョブは非常にシンプルなので、1~2 秒で完了します。

これで、最初のビルドを正常にトリガーできました。

コンソール出力の表示

このステップでは、ビルドの結果を確認する方法を学びます。出力の確認は、何が起こったか、そしてそれが成功したかどうかを正確に教えてくれるため、あらゆる自動化プロセスにおいて極めて重要な部分です。

  1. My-First-Job プロジェクトページで、左下隅にある ビルド履歴 (Build History) セクションを確認します。成功を示す緑色の丸が付いた、#1 とラベル付けされた最初のビルドが表示されているはずです。

  2. ビルド番号 #1 をクリックして、その特定のビルドの詳細ページに移動します。

  3. ビルドページでは、ビルドがいつ実行されたかなど、ビルドに関するさまざまな詳細が表示されます。デバッグにとって最も重要なリンクは コンソール出力 (Console Output) です。左側のサイドバーにある コンソール出力 (Console Output) をクリックします。

Console output link on build details page
  1. コンソール出力ページには、ビルド中に Jenkins が実行したすべてのアクションの詳細なログが表示されます。Jenkins がビルドを開始し、シェルコマンドを実行し、その後ビルドが完了したことがマークされたことが確認できます。

出力は以下と似ているはずです。

Started by user admin
Running as SYSTEM
Building in workspace /var/jenkins_home/workspace/My-First-Job
[My-First-Job] $ /bin/sh -xe /tmp/jenkins12345.sh
+ echo 'Hello from my first Jenkins job!'
Hello from my first Jenkins job!
Finished: SUCCESS

ご覧のとおり、ログには設定した echo コマンドとその出力である Hello from my first Jenkins job! が含まれています。最後の Finished: SUCCESS ステータスは、ジョブがエラーなく実行されたことを確認しています。

まとめ

この入門ラボの完了、おめでとうございます。Jenkins の世界への最初の一歩を成功裏に踏み出しました。

このラボでは、以下の方法を学びました。

  • Jenkins ダッシュボードにアクセスし、その主要なコンポーネントを特定する。
  • 新しい Freestyle プロジェクトをゼロから作成する。
  • シンプルな「Execute shell」ビルドステップを設定する。
  • プロジェクトのビルドを手動でトリガーする。
  • ビルド履歴と詳細なコンソール出力を検索および検査して結果を確認する。

これらの基本的なスキルは、より複雑で強力な自動化パイプラインを作成するための構成要素となります。これで、より高度な Jenkins の機能を探索する準備が整いました。