プロジェクトについて
プロジェクトは、独自の環境変数グループおよびサーバー・プロパティーを備えた、実行可能なステップのセットです。
プロジェクトのほかに、ライブラリーを作成することができます。 プロジェクトとは異なり、ライブラリーには、ステップが入力される場所を決定するセレクターがありません。
プロジェクト・パネルについて
「プロジェクト」パネルは、新規プロジェクトを作成したり、既存プロジェクトを表示または編集したりする場合に使用します。 「プロジェクト」パネルにアクセスするには、左側のメニューで「プロジェクト」をクリックします。
「プロジェクト」パネルには以下のタブがあります。
「詳細」タブ
「詳細」タブでは、さまざまなプロジェクト・プロパティーを指定できます。
- ジョブ・コントローラー
- プロジェクト・エンジン・タイプ用のジョブ・コントローラーを選択します。選択項目は、Java マスター・ジョブ・コントローラーまたは Perl エンジンです。 システムは、マスター・ジョブ・コントローラー・プロジェクトの実行に Java マスター・ジョブ・コントローラーを使用します。 システムは、Perl エンジン・プロジェクトを実行する場合にのみ Perl エンジンを使用します。 エンジン・タイプについて詳しくは、システム構成の設定のトピックにある「Java マスター・ジョブ・コントローラーをジョブ実行エンジンとして使用する (Use Java Master Job Controller as Job Execution Engine)」の設定を参照してください。 また、Perl エンジンの管理のセクションにあるトピックも参照できます。
- 名前
- プロジェクトの名前。システムは、リスト内およびデータベース内にあるプロジェクトを参照する際に、この名前を使用します。
プロジェクトを実行した場合、プロジェクト・ディレクトリーの構成にはプロジェクト名が使用されます。 プロジェクトには、さまざまなオペレーティング・システムで実行される可能性のあるステップが含まれるため、 プロジェクト名には、特殊な文字や記号は使用しないでください。 無効なディレクトリー名を生成する文字をプロジェクト名に使用しなければならない場合は、「無効な相対ディレクトリー文字」システム構成設定にそれらの文字を追加してください。この設定にリストされた文字は、プロジェクト・ディレクトリーの作成時に下線 (_) に変換されます。 アンパーサンド (&) を使用すると、意図せずにプロジェクト名の一部として HTML エンティティーを生成してしまう可能性があります。
- アクセス
- プロジェクトの表示と使用が許可されたアクセス・グループ。 このプロパティーは、アクセスできる対象を決定する権限とともに使用できます。 例えば、ジョブを起動する場合は、 プロジェクトに対して指定されたアクセス・グループのメンバーであると同時に、「ジョブの実行 (Execute Jobs)」 権限を持つ グループのメンバーでもなければなりません。 アクセス・グループについて詳しくは、アクセスの概説を参照してください。
- 無効
- プロジェクトを無効にするには、このチェック・ボックスにチェック・マークを付けます。無効に設定されたプロジェクトを実行しようとすると、Rational® Build Forge はそのプロジェクトが非アクティブであることを示すメッセージが表示され、プロジェクトを実行できません。
- 最大スレッド
- プロジェクトが起動を許される並列プロセスの最大数。
このフィールドを使用して、プロジェクトがシステム・リソースを使いすぎないようにします。
スレッド対応の各ステップと任意のインライン・プロジェクト (それ自体、スレッド対応のステップを起動できる) は、並列プロセスになることができるが、
これらのプロセスはすべて、親プロジェクトの最大数に対してカウントされます。
スレッド数の最大値に到達すると、新規並行プロセスの起動は停止され、
プロジェクトの並列プロセス数がスレッド数の最大値を下回るまで待機した後、システムは続行されます。
スレッド化について詳しくは、スレッド: ステップの並列実行を参照してください。
注: 「最大スレッド」プロパティーは、Java エンジン上ではサポートされません。
- 実行上限数
- 「実行上限数」プロパティーは、同時に許可されるプロジェクト・ジョブの最大数を設定するものです。
- プロジェクトを起動したときに、アクティブなジョブ数が「実行上限数」に等しい場合、新規ジョブは、少なくとも 1 つのジョブが完了するまで待機キュー にとどまります。
- スケジュールによってプロジェクトの起動が試みられたときに、アクティブなジョブの数が「実行上限数」に等しく、「ハード実行上限数」システム構成が「はい」に設定されている場合、システムは新規ジョブを起動しません。 「ハード実行上限数」が「いいえ」に設定されている場合、システムは、スケジュールされたビルドに関する「実行上限数」設定を無視します。
- インラインで起動されたプロジェクトは、オリジナル・プロジェクトのインスタンスとは見なされず、その「実行上限数」には算入されません。
- クラス
- 各プロジェクトはクラスに割り当てる必要があり、クラスはグローバル・プロパティーをジョブのグループに割り当てます。 詳しくは、クラスを参照してください。
- セレクター
- プロジェクトのサーバーを選択するときのセレクターの名前。 システムでは、このセレクターが、独自のセレクターを指定していない、プロジェクト内のすべてのステップのデフォルトとして使用されます。 セレクターを参照してください。セレクターが指定されない場合、プロジェクトはプロジェクト・パネル ではなくライブラリー・パネル に追加されます。ライブラリーは、 呼び出し元のステップのセレクターを使用します。 このステップにセレクターがない場合、ライブラリーは呼び出し元のプロジェクトのセレクターを使用します。
- 成功チェーン、失敗チェーン
- プロジェクト・ビルドが成功または失敗したときに実行するプロジェクトを選択します。 成功チェーンまたは失敗チェーンをプロジェクト・レベルで設定しておくと、 プロジェクトの成功状況または失敗状況に基づいて、別の成功アクションまたは失敗アクションを呼び出すことができます。 この機能は、成功または失敗アクションをプロジェクト内でステップ・レベルで設定することに似ています。プロジェクト・レベルの場合は、成功または失敗アクションは、ステップ状況ではなくプロジェクト実行状況によってトリガーされます。
- 環境変数
- サーバー環境変数の後、かつステップ環境変数の前に適用される環境変数です。 環境変数を一緒に機能させる方法について詳しくは、変数についてを参照してください。
- スティッキー
- デフォルトのプロジェクト・セレクターを使用するプロジェクトのすべてのステップを強制的に同一サーバー上にとどまらせるには、 「スティッキー」チェック・ボックスを有効にします。 その際、サーバーがビジーな場合はサーバーが使用可能になるまで待機する必要があります。 このオプションについて詳しくは、ステップをサーバーにスティックさせるを参照してください。
- デフォルトのステップ・プロバイダー
- ステップ・コマンドの実行を実装します。このプロバイダーは、エンドポイント・エージェント・サーバーでコマンド・テキストを実行するという、期待どおりのレガシー動作を提供します。デフォルトのステップ・プロバイダーは、Java マスター・ジョブ・コントローラーのみです。 Perl エンジン・プロジェクトに使用できるステップ・プロバイダーはありません。
- 開始通知 (Start Notify)、成功通知 (Pass Notify)、失敗通知 (Fail Notify)
- これらのフィールドは、プロジェクトの開始、成功、または失敗のときに通知 E メールを送信するようにシステムに指示する場合に使用します。 それには、これらのフィールドの 1 つまたはすべてでアクセス・グループを選択します。
「タグ」タブ
「タグ」タブは、プロジェクトのビルド・タグを管理する場合に使用します。
- タグ形式
- プロジェクトのタグを定義するストリング。 プレーン・テキストとタグ変数参照が使用されます。 タグ形式について詳しくは、ジョブ中のビルド・タグの変更を参照してください。
- タグ同期
- 2 つのプロジェクトのタグ変数を同期化します。現行プロジェクトと同期化するタグ変数を持つプロジェクトを選択します。2 つのプロジェクトが 同期化されると、同一プールから変数が選択されます。 2 つのプロジェクトが順番に実行されると、最初のプロジェクトの値は 1 になり、次のプロジェクトの値は 2 になります。詳しくは、タグの同期化を参照してください。
- タグ名
- 変数名。タグ形式でタグ変数を使用する場合は、フォーム $<Tag Name> を使用してその名前を参照します。例えば、MainVer 変数と B 変数を 使用するタグを作成するには、タグ・フォーマット Build_$MainVer.$B を使用します。 例えば、Build_005.1 のようなタグが取得されます。
- 初期値
- タグ変数の値を設定します。「自動インクリメント」オプションを使用しないと、変数は変更されるまでこの値を保持します。
- パティング
- 「なし」以外の「パディング」値を選択した場合に、タグで変数が使用されていると、 システムはその変数の値に先行ゼロを追加します。 これは、桁数が「パディング」値と同じになるように行われます。 例えば、変数が現在 2 で、パティングが 3 であると、「002」の値が作成されます。パディングの範囲は 1 から 8 までです。
- 自動インクリメント
- これが「はい」に設定されている場合、システムは変数値をプロジェクト・ジョブごとに 1 ずつ増やします。
「レジスター」タブ
プロジェクト・レジスターは、複数のビルド間で持続する情報を保管する場合に使用します。
- レジスター
- プロジェクト・レジスターの名前。
- 内容
- レジスターの値。
追加情報については、プロジェクト・レジスターを参照してください。
「メモ」タブ
「メモ」タブは、プロジェクトについて関心のある事項を保管する場合に使用します。
メモごとにタブに以下の内容が表示されます。
- ユーザーがメモを作成した日時
- メモを入力したユーザー
- メモ
「スナップショット」タブ
プロジェクト・スナップショットは、プロジェクトのインスタンスです。 「スナップショット」タブには、スナップショットの名前が表示されます。
このタブは、スナップショット名の表示や変更を行ったり、スナップショット名にコメントを追加したりする場合に使用します。