ブランチ設定

このページでは、Code Repositories におけるさまざまなブランチ設定について説明します。

• デフォルトブランチの設定
• プルリクエストのマージモードの選択
• ブランチの保護
• ブランチのフォールバックの設定

デフォルトブランチ

複数のブランチを持つ Code Repositories では、ベースブランチとしてデフォルトブランチを設定できます。デフォルトでは、すべてのプルリクエストとコミットはそのブランチに対して行われますが、別のブランチを選択することも可能です。通常、デフォルトブランチは master ブランチです。

Code Repository のメインブランチを選択するには、Settings > Branches > Default branch に移動します。

マージモード

プルリクエストで提案されたコード変更をマージするためのいくつかの戦略があります。設定タブでは、プルリクエストページでコード作者に利用可能なマージモードを1つ以上選択できます。

• Squash and merge - Squash-and-merge モードは、プルリクエストが導入するすべての変更を取り込む単一のコミットをターゲットブランチに作成します。これにより、デフォルトブランチのコミット履歴が凝縮されます。
• Merge - プルリクエストで Merge を使用すると、ブランチで作成されたすべての個々のコミットがマージコミットとともにターゲットブランチに追加されます。ターゲットブランチのコミット履歴では、すべての個々のコミットが作成された開発ブランチの元のタイムスタンプで表示されます。
• Merge with fast-forward - ターゲットブランチからユーザーのブランチへの直接のパスがある場合（ターゲットブランチに追加の変更がない場合）、merge-with-fast-forward はターゲットブランチを開発ブランチの先頭に進め、そのコミット履歴を結合します。

選択されたすべてのマージモードはプルリクエストページにオプションとして表示されます。もし "Squash-and-merge" モードが選択されている場合、これがメインオプションとして表示され、他の選択されたモードはメニューで利用可能です。

保護されたブランチ

複数の作者が同じコードリポジトリに貢献している場合、またはリポジトリが重要なデータ資産をバックしている場合、ブランチを保護してガバナンスと意図しない変更に対する防御を強化できます。保護されたブランチはプルリクエストを介してのみ変更でき、事前に定義された要件を満たす必要があります。

ブランチ設定パネルでは、以下の要件を設定できます。

• ci/foundry-publish が正常に実行されることを要求する
• コードレビューを要求する
• 特定のレビュアーを要求する
• セキュリティ承認を要求する

ci/foundry-publish が正常に実行されることを要求する

データに変更を公開するには、継続的インテグレーションプロセス ci/foundry-publish が正常に実行され、完了する必要があります。これが正常に完了する前に変更をマージすると、変更が有効になる保証はないため、保護されたブランチの要件としてこれを推奨します。

コードレビューを要求する

重要なブランチを保護する利点の1つは、コード変更を本番環境にマージする前に協業者のレビューを受けることができる点です。変更をマージする権限を持つ誰もがプルリクエストでレビューを提出できます（デフォルトでは、リポジトリの所有者と編集者）。

以下のレビュー方針を強制できます。

• マージ前に拒否がないことを要求する - 少なくとも1人のレビュアーがコード変更を拒否した場合、プルリクエストのマージをブロックします。
• マージ前に少なくとも1つの承認を要求する - これにより、変更がマージされる前にコードがレビューされ、承認されることが保証されます。

特定のレビュアーを要求する

プルリクエストをマージする前に、特定のユーザーやグループからの承認を要求できます。グループの要件を満たすためには、グループの少なくとも1人のメンバーがプルリクエストを承認する必要があります。このポリシーは、承認が受けられた限り拒否を許可します。例えば、グループの1人が変更を拒否し、別のメンバーが承認した場合、「拒否なし」のポリシーが適用されない限り、承認が拒否を上回ります。

高度な承認ポリシーを設定する

高度なプルリクエスト承認ポリシーは、プルリクエストで変更されたファイルに基づいてレビューが必要なユーザーとグループを決定します。保護されたブランチのブランチ設定で Edit を選択し、次に Advanced approval policy を選択してポリシーの設定を開始します。

Edit policy タブでは、フォームベースのエディタを提供します。高度な承認ポリシーは、ALL または ANY などのルールの論理演算子をグループ化します。ルールを選択して、そのメタデータ、例えばルールの名前や説明を提供します。Rule applies conditionally をオンにして、プルリクエストで変更されたファイルが特定の正規表現に一致する場合のみこのルールを適用するようにします。例えば、Python トランスフォームの典型的なフォルダー構造では、["transforms-python/src/myproject/datasets/.*\\.py"] が datasets フォルダー内のすべての Python ファイルに一致します。

View YAML タブでは、ポリシーの YAML 表現を直接変更、コピー、貼り付けできます。これにより、ポリシーの一括編集（例えば、検索用語の検索と置換）を行うのに便利です。

セキュリティ承認を要求する

ブランチで セキュリティマーキング の伝播を停止するには、そのブランチを保護する必要があります。一度セキュリティ変更がリポジトリで有効になると、プルリクエストをマージする前に自動的かつ不変にセキュリティチェックと承認（必要な場合）が要求されます。詳細については、継承されたマーキングの削除を参照してください。

ブランチの保護解除

所有者は Code Repository の設定からブランチの保護を解除できます。ただし、マーキングの伝播を停止したなどのアクティブなセキュリティ変更があるブランチは、セキュリティ変更がなくなるまで保護を解除できません。アクティブなセキュリティ変更があるブランチを保護解除するには、プルリクエストを通じて変更を削除する必要があります。その後、Code Repository の設定からブランチの保護を解除できます。

フォールバックブランチ

Code Repositories では、任意のブランチでデータセットを構築し、ユーザーのトランスフォームがデータに与える影響を確認できます。現在のブランチでトランスフォームの入力データセットが構築されていない場合、代わりに フォールバックブランチ のリストから構築済みのバージョンを見つける試みが行われます。デフォルトブランチは自動的にフォールバックブランチとして設定されますが、設定を変更することも可能です。必要に応じて、各ブランチに異なるフォールバックブランチを設定し、複数のフォールバックを設定することもできます。