This is the documentation for Bamboo 5.7. View this page for the

Unknown macro: {spacejump}

of Bamboo, or visit the latest Bamboo documentation.

グローバル有効期限を使用すると、Bamboo システムからビルドおよび展開成果物を削除する必要があるタイミングを管理することができます。

以下の理由がある場合にこれを実施することを検討することをお勧めします。

  • ビルドおよび展開成果物が大きくなり、システムのストレージを消費する可能性がある場合。使用しなくなった成果物が無期限に保持されると、ディスク容量が不足する可能性があります。
  • 多数のビルドおよび展開によって、Bamboo ユーザー インターフェイスが乱雑になり、パフォーマンスが低下して、Bamboo での作業が遅くなる可能性があります。

See this Atlassian blog post for a discussion of using build expiry and labels.

グローバル有効期限はすべてのビルド プランと展開プロジェクトに適用され、一般的に、Bamboo の成果物の有効期限を管理する最も簡単な方法です。

ただし、以下に注意してください。

Bamboo 管理者は、以下のとおり、ビルド成果物と展開成果物の両方にグローバル有効期限を設定することができます。

グローバル有効期限の設定

Ensure that you back up any build results data before their expiry date is reached.

グローバル有効期限を有効化および設定する方法:

  1. Click the  icon in the Bamboo header and choose Overview.
  2. 左側のナビゲーション パネルにある有効期限(プランの下)をクリックします。
  3. If necessary, enable deloyment expiry. Note that this can not be reversed – see the Bamboo 5.7 upgrade notes.
  4. 編集をクリックします。
  5. 以下の設定を使用してグローバル有効期限を設定します。

    設定説明
    ビルドおよび展開結果を入力します。すべてのビルド結果データ(成果物とビルド ログを含む)および展開結果、リリース成果物が削除されます。
    ビルドおよびリリース成果物Only user-defined artifacts are deleted.
    ビルドおよび展開結果ログOnly build logs and deployment result logs are deleted. Note that log files smaller than 10MB are never expired.
    有効期限ビルドおよび展開結果が削除されるまでの期間(日、週、または月)を指定します。
    例えば、過去2年間に作成された結果を保持するには、「24 か月」と指定します。
    保持するビルドの最小数保持する結果の最小数を指定します。
    たとえば、「50」と指定すると、有効期限で指定した期間よりも古い場合でも、最低50件のビルド結果を保持します。
    次のラベルのビルドを保持するSpecifies the build labels (not plan labels or job labels) applied to builds for which you want to keep build results, regardless of the Expire after and Minimum builds to keep settings. Note that builds can be labelled either manually or automatically.
    保持する展開の最小数有効期限で指定した期間より古い場合でも、保持する成功した展開の最小数を指定します。最小値は2です。
  6. Click the icon to the right of 'Schedule' to set when the expiry event will be triggered. You can specify a cron expression if required. See this FAQ for help constructing cron expressions.
  7. 保存をクリックします。

グローバル有効期限イベントは、ビルドおよび展開結果の有効期限を有効化しているか無効化しているかにかかわらず、定期的(有効期限スケジュールによって決定)に実行されます。このイベントが発生すると、ビルドおよび展開結果は、設定したグローバル設定およびプラン設定に従って、有効期限切れになります。

有効期限の計算

このセクションでは、ビルドまたは展開結果の存在期間を計算し、有効期限が切れるタイミングを判断する方法について説明します。

ビルド結果とすべてのログ

ビルド結果、ビルド ログ、および展開ログの存在期間は、それぞれ単純に作成日から計算されます。

ビルド結果またはログの存在期間が有効期限の期間以上になった場合、有効期限イベントが発生するときに削除されます(ビルド結果またはログが削除されるように設定されていることがぜんtネイです)。

10MB 未満のログ ファイルには有効期限がないことに注意してください。

ビルドおよび展開成果物

ビルドおよび展開成果物の存在期間は以下のように計算されます。

  • そのビルド結果に関連付けられたリリースがない場合、ビルド結果の作成日が使用されます。
  • リリースがあり、ビルド結果が展開されていない場合は、それを参照している最新のリリースの作成日が使用されます。
  • それ以外の場合は、最新の展開の作成日が使用されます。

ビルドまたは展開成果物の存在期間が有効期限の期間以上になった場合、有効期限イベントが発生するときに削除されます(成果物が削除されるように設定されていることが前提です)。