注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

リポジトリのアップグレード

Foundry は、アクティブなリポジトリに対してアップグレードプルリクエストを生成することがあります。これらのアップグレードには、Transforms テンプレートの重要な更新やランタイムの改善が含まれます。アップグレードプルリクエストは専用のブランチで作成され、デフォルトブランチへのマージをリクエストします。

自動アップグレード

リポジトリで自動アップグレードが有効になっている場合、Foundry はアップグレード PR の自動マージを試みます。必要なチェックが正常に完了すると、プルリクエストがマージされ、デフォルトブランチのコミット履歴に新しいマージコミットが表示されます。この機能を有効にするには、リポジトリ設定でアップグレード PR の自動マージを選択します。

このオプションが無効になっている場合、または PR のマージに失敗した場合、新しいアップグレード PR が利用可能になるとリポジトリにメッセージが表示され、適切な権限を持つユーザーがマージする必要があります。

リポジトリに最新のランタイムの改善を反映し続けるために、自動アップグレードを有効にすることを強く推奨します。

リポジトリの自動アップグレードでは、マージ前に手動での対応が必要になる場合があります。

  • リポジトリのテンプレートの種類がマージに対応していない場合。
  • アップグレード PR の作成後に、ユーザーがそのブランチに変更をコミットした場合。
  • アップグレード PR が、ユーザーによる変更を含むファイルを上書きする場合(ファイルの上書きを参照)。
  • このプルリクエストの影響を直接受けるデータセットの一部が、最新バージョンのコードでビルドされていない場合(影響分析を参照)。
  • このリポジトリから生成されるジョブが、アップグレードプルリクエストで導入されるランタイムの Spark モジュールバージョンでまだビルドされていない場合(影響分析を参照)。
  • リポジトリの現在のテンプレートバージョンが古すぎて、自動アップグレードに対応していない場合。

ファイルの上書き

リポジトリの作成時には、選択したテンプレートの種類に応じたデフォルトのテンプレートファイルでセットアップされます。リポジトリをアップグレードすると、これらのデフォルトファイルの一部が、最新のテンプレートバージョンのファイルと一致するように上書きされます。これは、デフォルトファイルがリポジトリの正常な動作に重要であり、ユーザーが上書きすべきではないと考えられているためです。

リポジトリのアップグレードでは ci.additions.yml ファイルは上書きされないため、そこに定義したカスタム CI ジョブはアップグレード後も保持されます。

影響分析

リポジトリのアップグレード PR の影響分析タブを使用すると、影響を受けるデータセットに生じる可能性のある変更を確認し、マージ前に変更の安全性を確認できます。一部のアップグレードは、使用されるランタイムの Spark モジュールバージョンに影響する場合があり、このリポジトリでビルドされるデータセットにも影響する可能性があります。

ブランチの手動アップグレード

このブランチを最新の言語バージョンに手動でアップグレードするには、以下のスクリーンショットに示すように、Code Repositories で ... メニューを開き、アップグレードを選択します。

ブランチのアップグレード

リポジトリを別のプロジェクトに移動する場合は、ビルドやチェックがトリガーされる前に、新しい場所でリポジトリを手動でアップグレードする必要があります。これは、リポジトリ内の関連するプロジェクト参照を更新するために必要です。