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

AIP Logic のブランチ機能

AIP Logic は Global Branching と統合されており、Logic 関数を安全で独立した環境で開発できます。このドキュメントでは、リソースの追加と変更、アプリケーション間の互換性、リベース、承認プロセスなど、ブランチで Logic を使用する方法について説明します。

Global Branching の概念とワークフローに関する一般的な情報については、Global Branching のドキュメントを参照してください。

リソースを追加、削除、変更する

Logic 関数をブランチに追加する

Logic 関数をブランチに追加するには、次の手順を実行します。

ブランチ上の Logic ファイルに移動するか、ページ右上のブランチセレクターを使用して指定のブランチを選択します。
Logic ファイルを編集して保存します。これで、Logic 関数がブランチ上に保存されたリソースになります。

Logic 関数を削除する

Logic 関数をブランチから削除するには、右下のサイドバーでブランチから削除を選択します。

Logic 関数を変更する

ブランチ上の Logic 関数を変更するには、メインブランチと同様に、変更を加えて保存します。

ブランチ上で公開する

メインブランチと同じ手順で、ブランチ上の Logic 関数を公開できます。ブランチ上で関数を正常に公開すると、このブランチ上の新しい関数バージョンを Workshop および関数ベースのアクションで使用できます。この関数バージョンには、ブランチのプレリリースタグが付けられます。このブランチ上で公開した関数には、main を含むほかのブランチからアクセスできません。

アプリケーション間の互換性

ブランチ上の Logic 関数を使用する

ブランチ上の Logic 関数は、次のものと組み合わせて使用できます。

オントロジーオブジェクト： 関数は、同じブランチ上のオントロジーオブジェクトとやり取りできます。
ブランチに対応したほかのアプリケーション： Logic 関数を使用し、ブランチ機能をサポートする Foundry アプリケーション（たとえば、Workshop）。

マージ要件

デプロイ可能性のチェック

Logic 関数をデプロイするには、次の条件を満たす必要があります。

メインブランチに対して最新であること（リベースが不要）
ブランチ上で公開されていること
公開可能な状態であること（エラーがない）
承認待ちがないこと

承認とレビュー担当者のフロー

保護されたメインブランチ

メインブランチを保護して、main 上の Logic 関数を直接編集できないようにすることができます。保護が有効になっている場合、すべての変更はブランチ上で行い、レビューを受け、提案プロセスを通じてマージする必要があります。

ブランチを保護するには、Compass でリソースに移動し、ブランチの保護 > プロジェクトポリシーで保護を選択します。

プロジェクト内のすべての Logic ファイルをデフォルトで保護するには、プロジェクトレベルで保護を有効にします。そのプロジェクトで作成された新しい Logic ファイルは、自動的に保護されます。

レビュー担当者の操作

提案が作成されると、Global Branching アプリケーションで Logic ファイルにレビュー担当者を追加できます。レビュー担当者として追加されたユーザーには、提案へのリンクを含むレビュー依頼のメールが届きます。

そこから、レビュー担当者は次の操作を行えます。

ファイル右上のレビューの選択肢を選択して、レビューページにアクセスします。この選択肢は、Logic 関数にレビューが必要な場合に表示されます。
main とブランチの変更を左右配置で比較表示します。
Logic 関数へのすべての変更を確認します。
変更を承認または拒否します。
自分のレビューを編集します。

リベースと競合の解決

このブランチの作成後、または最後のリベース後にメインブランチが変更された場合、リベースが必要です。Logic 関数にリベースが必要な場合は、Logic ファイルの上部に通知が表示されます。

リベースする方法

リベースが必要な Logic 関数に移動し、リベースの選択肢を選択します。
分割画面の比較表示で変更を確認します。左側には現在の main のバージョンが、右側にはこのブランチのバージョンが表示されます。
このブランチに必要な変更を加えます。マージ競合がある場合は、必要に応じて main からの変更を取り込みます。
完了を選択して、リベースを完了します。

既知の制限事項

ブランチは main からのみ作成できます。ほかのブランチからブランチを作成することはできません。
ブランチ上ではAPI名を変更できません。ブランチ間で、すべての Logic 関数が同じAPI名を共有します。
ブランチ上では、公開済みの Logic 関数を削除できません。
マージ競合の解決には手動の操作が必要です。リベース中に競合が発生した場合は、分割画面の比較表示を使用して、main からの変更をこのブランチのバージョンに手動で取り込み、競合する変更をすべて解決してからリベースを完了する必要があります。