保持ポリシー

保持ポリシーを構成する

プロジェクトで保持設定ページを開き、管理するポリシー領域を選択するには、次の手順に従います。

1. Azure DevOps プロジェクトにサインインします。

2. [>Project settings を選択します。

3. 次のいずれかのオプションを選択してください。

   • [ パイプライン] で、[ 設定] を選択して、実行、成果物、シンボル、添付ファイル、プル要求の実行のリテンション期間を構成します。
   • [ パイプライン] で[ リリースリテンション期間 ] を選択して、リリースが削除または完全に破棄されるタイミングなど、リリースリテンション期間の設定を構成します。
   • [ テスト] で [ 保持] を選択して、手動および自動のテスト実行を保持する期間を構成します。

1. プロジェクトの設定の >[設定 ]タブに移動します。

2. [パイプライン] セクション で 、[ 設定] を選択します。

   • 成果物、シンボル、添付ファイルを保持する日数を設定します。
   • 実行を保持する日数を設定します。
   • プル要求の 実行を保持する日数を設定します。
   • 各パイプラインに対して保持する最近の 実行 の数を設定します。

パイプライン設定ごとに保持する最近の実行の数は、リポジトリの種類に基づいて異なる方法で解釈されます。

• Azure Repos: Azure Pipelinesは、pipeline の既定のブランチおよびリポジトリ内の保護された各ブランチに対して構成された最新の実行の数を保持します。 保護されたブランチは、ブランチ ポリシーが構成されている任意のブランチです。

  たとえば、 main と releaseの 2 つのブランチを持つリポジトリについて考えてみましょう。 パイプラインの既定のブランチが main され、 release にブランチ ポリシーがある場合、 release は保護されたブランチとして扱われます。 リテンション期間を設定して 3 回の実行を保持する場合、Azure Pipelines は main の最新の 3 回の実行、release の最新の 3 回の実行、およびパイプライン全体のブランチに関係なく最新の 3 回の実行を保持します。

  次の例では、最新の実行が最初に一覧表示されることを前提としています。 最新の 3 回の実行を保持するようにリテンション期間を構成するときに保持される実行が表示されます (日ベースの設定は無視されます)。

  実行番号	[Branch]\(ブランチ)	保持/未保持	なぜですか?
  実行 10	メイン	保持されています	メイン用の最新3つとパイプライン用の最新3つ
  実行 9	branch1	保持されています	パイプラインの最新 3 件
  実行 8	branch2	保持されています	パイプラインの最新 3 件
  実行 7	メイン	保持されています	メインの最新 3 件
  第6回実行	メイン	保持されています	メインの最新 3 件
  実行 5	メイン	保持されない	メインまたはパイプライン用の最新の 3 つではありません
  第4回実行	メイン	保持されない	メインまたはパイプライン用の最新の 3 つではありません
  ラン 3	branch1	保持されない	メインまたはパイプライン用の最新の 3 つではありません
  実行 2	リリース	保持されています	リリースの最新の 3 つ
  実行 1	メイン	保持されない	メインまたはパイプライン用の最新の 3 つではありません

  保持する日数は、実行が完了した日付から計算されます。 たとえば、1 月 19 日のメイン ブランチには 2 つの実行があります。 後で完了した実行は保持されます。

• その他すべての Git リポジトリ: Azure Pipelinesパイプライン全体に対して構成された最新の実行数が保持されます。

• Team Foundation Version Control (TFVC): Azure Pipelinesは、ブランチに関係なく、パイプライン全体に対して構成された最新の実行数を保持します。

実行が削除されると、次のデータが削除されます。

• ログ
• すべてのパイプラインとビルド成果物
• すべてのシンボル
• バイナリ
• 実験値
• 実行のメタデータ
• ソース ラベル (TFVC) またはタグ (Git)

パイプライン実行の保持期間では、ユニバーサルパッケージ、NuGet、npm、その他のパッケージは制御されません。

次の条件がすべて満たされている場合、実行は削除されます。

• 保持設定で構成されている日数を超えています。
• 保持設定で構成されている最近の実行の 1 つではありません。
• 無期限保持のマークは付けられません。
• リリースでは保持されません。

保持ポリシーは、1日に1回処理されます。 処理時間は、負荷分散のために 1 日を通して作業が分散されるために異なります。 このスケジュールは変更できません。

パイプライン実行時に保持期間リースを自動設定する

保持リースを使用すると、構成された保持期間を超えてパイプライン実行の有効期間を延長または制御できます。 リース API を使用して、パイプライン実行のリースを追加または削除できます。 とrunIdのスクリプトとdefinitionIdを使用して、パイプライン内からこの API を呼び出すことができます。

特定の期間のリースを設定できます。 たとえば、テスト環境にデプロイされた実行を短期間保持することができます。 本番環境にデプロイされた実行を、より長い期間保持することができます。

パイプライン実行時に保持期間リースを手動設定する

パイプライン実行の詳細ページの [ その他のアクション] メニュー から、 パイプラインの実行 を手動で保持できます。

実行を削除する

[パイプラインの実行の詳細] ページの [その他のアクション] メニューから実行を削除できます。

YAML とビルド パイプラインでは、同じ実行保持ポリシーが使用されます。 これらの設定は、Project settings>Pipelines>Settings で表示できます。

グローバル リリース保持ポリシー

Azure DevOps サービスでは、これらの設定を表示できますが、プロジェクト レベルで変更することはできません。

グローバル リリースのリテンション期間の設定は、projectの Release retention ページから Project 設定で確認できます。

• 最大保持ポリシー: すべてのリリース パイプラインでリリースを保持できる期間の上限を定義します。 パイプライン作成者は、この制限を超えてリテンション期間を構成することはできません。
• 既定の保持ポリシー: リリース パイプラインに適用される既定の保持値を定義します。 パイプライン作成者は、これらの既定値をオーバーライドできます。
• リリースの永久破棄: 削除されたリリースを完全に削除するまでの期間を制御します。 個々のリリース パイプラインでは、このポリシーをオーバーライドできません。

グローバル リリース保持ポリシー

オンプレミスAzure DevOps Server使用する場合は、プロジェクト レベルの既定値とリリースリテンション期間の最大値を構成できます。 また、削除されたリリースが完全に破棄されるタイミングを設定することもできます。 (ビルド エクスプローラーの [ 削除済み ] タブから削除されます)。

• 最大保持ポリシー: すべてのリリース パイプラインでリリースを保持できる期間の上限を定義します。 パイプライン作成者は、この制限を超えてリテンション期間を構成することはできません。
• 既定の保持ポリシー: リリース パイプラインに適用される既定の保持値を定義します。 パイプライン作成者は、これらの既定値をオーバーライドできます。
• リリースの永久破棄: 削除されたリリースを完全に削除するまでの期間を制御します。 個々のリリース パイプラインでは、このポリシーをオーバーライドできません。

Azure DevOps Server の保持ポリシー設定を示すスクリーンショット

コレクションレベルのアイテム保持ポリシーを設定する

オンプレミス サーバーを使用する場合は、カスタム 規則を使用してコレクション レベルの保持を構成することもできます。 これらの設定は、クラシック ビルド パイプラインに適用され、コレクションの既定のリテンション値と最大リテンション値を定義します。

[ファイルのコピー] タスクを使用してデータを長く保存する

ビルド出力を構成された保持期間よりも長く保持する必要がある場合は、[ファイルのコピー] タスクを使用して独自の保存場所に コピーします。

ビルド成果物として発行されたデータは保持クリーンアップの対象であるため、ビルド成果物の発行の代わりにファイルのコピーを使用します。

- task: CopyFiles@2
  displayName: 'Copy Files to: \\mypath\storage\$(Build.BuildNumber)'
  inputs:
    SourceFolder: '$(Build.SourcesDirectory)'
    Contents: '_buildOutput/**'
    TargetFolder: '\\mypath\storage\$(Build.BuildNumber)'

バージョン管理のラベルやタグを保持するにはどうすればよいですか?

ビルドが削除された後もラベルまたはタグを保持する必要がある場合は、パイプライン タスクに適用するか、パイプラインの外部に手動で追加するか、ビルドを無期限に保持します。

他のパイプラインで使われているパイプラインはどうなりますか?

クラシック リリースでは、自動的に使用されるパイプラインは保持されます。

他のパイプラインで使われているパイプラインはどうなりますか?

クラシック リリースでは、自動的に使用されるパイプラインは保持されます。 YAML を使用している場合は、マルチステージ YAML パイプラインを作成してリリースを表し、その中の別の YAML パイプラインを リソースとして使用することもできます。 リリース パイプラインが保持されている限り、リソース パイプラインは自動的に保持されます。