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

VS Code ワークスペースの Global Branching

VS Code ワークスペースの Global Branching は、Python の変換リポジトリ、および TypeScript v1、TypeScript v2、Python の関数リポジトリでサポートされています。Global Branching をサポートするリソースの種類の全一覧については、統合のドキュメントを参照してください。

VS Code で作業する際は、グローバルブランチを作成してアクセスできるほか、Python トランスフォーム、および TypeScript v1、TypeScript v2、Python の関数リポジトリでサポートされているほかのワークフローを利用できます。 これらのワークフローは、Palantir インフラストラクチャ上にデプロイされた VS Code ワークスペースでも、Palantir extension for Visual Studio Code を使用するローカルの VS Code でも利用可能です。

グローバルブランチと Code Repositories ブランチ

VS Code のリポジトリには、2種類のブランチがあります。

  • Code Repositories ブランチは、リポジトリの基盤となる Git ブランチです。
  • グローバルブランチには、複数の Palantir アプリケーションにわたる変更を含めることができ、単一のブランチでエンドツーエンドのワークフローを開発、テストできます。グローバルブランチは、リポジトリの main ブランチに基づいている必要があります。

Palantir 拡張機能では、タブ付きブランチセレクターから、Code Repositories ブランチとグローバルブランチの両方を1か所で作成、チェックアウトできます。

VS Code サイドバーの Palantir パネルにあるタブ付きブランチセレクター。グローバルブランチタブが選択されています。

Code Repositories のブランチオプションについて詳しくはこちら。

ブランチタスクバー

VS Code ワークスペースでサポート対象のリポジトリを開くと、コードページのエディター下部にブランチタスクバーが青いバーとして表示されます。タスクバーにはアクティブなブランチが表示され、VS Code と同期された状態が保持されます。ターミナル、コマンドパレット、エディターに反映されるブランチは、常にタスクバーに表示されるブランチと一致します。

タスクバーは VS Code ワークスペースでのみ利用可能です。ローカルの VS Code では、Palantir 拡張機能を使用してブランチを表示、切り替えます。

グローバルブランチを作成する

次のいずれのエントリーポイントからも、グローバルブランチを作成できます。

  • ブランチタスクバー(VS Code ワークスペースのみ):タスクバーのブランチセレクターを開き、新しいブランチを作成します。
  • Palantir 拡張機能(VS Code ワークスペースおよびローカルの VS Code):サイドバーの Palantir パネルでタブ付きブランチセレクターを開き、グローバルブランチタブを選択して、新しいブランチを作成します。
  • コマンドパレット(VS Code ワークスペースおよびローカルの VS Code):Cmd+Shift+P (macOS) または Ctrl+Shift+P (Windows/Linux) を押し、Palantir:グローバルブランチを作成を実行します。
  • Code Workspace のブランチページ:リポジトリのブランチページからグローバルブランチを作成します。

いずれのエントリーポイントからでも、ブランチ作成ダイアログが開きます。

グローバルブランチをチェックアウトする

次のいずれのエントリーポイントからも、既存のグローバルブランチをチェックアウトできます。

  • ブランチタスクバー(VS Code ワークスペースのみ):タスクバーのブランチセレクターを開き、ブランチを選択します。
  • Palantir 拡張機能(VS Code ワークスペースおよびローカルの VS Code):サイドバーの Palantir パネルでタブ付きブランチセレクターを開き、グローバルブランチタブからブランチを選択します。
  • コマンドパレット(VS Code ワークスペースおよびローカルの VS Code):Cmd+Shift+P (macOS) または Ctrl+Shift+P (Windows/Linux) を押し、Palantir:グローバルブランチをチェックアウトを実行します。

ブランチタスクバー以外のエントリーポイントでは、いずれも同じブランチピッカーが開きます。このピッカーでは、目的のブランチをすばやく見つけられるよう、ブランチが次のセクションに分類されます。

  • main ブランチ
  • このリポジトリを含むご自身のブランチ
  • ご自身のブランチ
  • その他すべてのブランチ
VS Code のグローバルブランチチェックアウトピッカー。ブランチがセクションごとに分類されています。

ブランチをチェックアウトするときは、次の動作が適用されます。

  • ブランチへのリポジトリの追加: 選択したブランチにリポジトリがまだ含まれていない場合、チェックアウトが完了する前に、リポジトリの追加を求めるプロンプトが表示されます。
  • 未コミットの変更: 未コミットの変更がある場合、チェックアウトまたはブランチへの追加操作が進む前に、それらの変更の解決を求めるダイアログが表示されます。これにより、エディターとアクティブなブランチの同期が失われるのを防ぎます。

ブランチでトランスフォームを開発する

グローバルブランチで Python トランスフォームを開発できます。プレビューパネルとビルドパネルは、現在チェックアウトしているブランチに対して実行されます。

Python トランスフォームの開発について詳しくはこちら。

ブランチで関数を開発する

TypeScript v1、TypeScript v2、Python の関数リポジトリでは、次のパネルもアクティブなグローバルブランチのコンテキストで動作します。

  • ライブプレビュー: ブランチ上のリソースに対して関数をプレビューします。
  • 公開済みプレビュー: ブランチ上で公開した関数バージョンをプレビューします。
  • リソースのインポート: 関数で利用可能なオントロジーリソースをインポート、変更します。

関数バージョンにタグを付けることで、グローバルブランチ上で公開できます。VS Code ワークスペースのタグページ、または Palantir 拡張機能のタグ付けするアクションから、バージョンにタグを付けます。グローバルブランチで作業している間は、そのブランチに対してタグが作成されます。

ブランチでの関数の開発、公開、利用、リベース、マージについて詳しくはこちら。