エージェントの使用

マスターとする 1 台のマシンに Jenkins をインストールし、エージェントとする他のマシン上での日々の開発プロセスを制御するプロジェクトを実行できます。これは、さまざまなテスト構成でアプリケーションを正しく実行する必要がある場合に非常に役立ちます。

注: エージェントは、物理マシンまたは仮想マシンのいずれかです。

Jenkins でエージェントを設定するプロセスは次のとおりです。

  1. マスター上の Jenkins で、エージェントとして使用するマシンへの接続を定義するノードを作成します。手順については、以下に示す例を参照してください。
  2. エージェント上で Jenkins の UI を開きます。ノードのページを開き、リンクをたどって Jenkins エージェントを起動します。これでマスター マシン上の Jenkins エージェントとエージェント マシンとの間の接続が確立します。
  3. マスター上の Jenkins でプロジェクトを作成し、エージェントで実行するように構成します。

エージェント マシンの作成例

次の例では、vSphere クラウドに格納されているエージェント マシンへの接続を作成する方法を示します。ここでは、Jenkins に vSphere プラグインをインストールする必要があります。

以下の手順で、Jenkins が vSphere クラウドに接続されていることを確認します。

  1. Jenkins のホーム ページで [Jenkinsの管理] をクリックします。
  2. [システムの設定] をクリックします。
  3. [クラウド] セクションで、[追加 > vSphere Cloud] をクリックします。
  4. 仮想マシンを備える vSphere ホストに接続するための構成およびログインの詳細を指定します。

エージェント マシンへの接続を作成するには、まず Jenkins で次のようにノードを作成します。

  1. [Jenkinsの管理] をクリックします。
  2. [ノードの管理] をクリックします。

    [ノード] ページが開き、Jenkins がマスターとしてインストールされているマシンが表示されます。

  3. [新規ノード作成] をクリックします。
  4. ノードの名前を指定して [Permanent Agent] をクリックし、[OK] をクリックします。
  5. 必要に応じて詳細を入力します。たとえば、エージェントのソースをチェックアウトするために必要な場合は、[リモートFSルート] を指定します。
  6. [保存] をクリックします。

マスターに接続するようにエージェントを構成するには、次の手順を実行します。

  1. エージェント マシンで、Jenkins のホームページ (http://mastermachine:8080) をロードします。
  2. Jenkins のホームページで、[ビルド実行状態] ボックスに表示されるマシンのノードをクリックします。
  3. ノードの Jenkins ページから、[Launch] をクリックして、マシンを Jenkins に接続するエージェントを開始します。

以下の手順で、エージェントで実行する既存のプロジェクトを設定します。

  1. マスター マシンで、プロジェクトの設定ページに移動します。
  2. [General] セクションで [実行するノードを制限] をオンにします。
  3. [ラベル式] で、作成した接続先のノードの名前を指定します。
  4. プロジェクトを保存します。

    次にプロジェクトをビルドする際に、エージェント上で実行されます。