アプリケーションをデプロイする

このページでは、Pilot アプリケーションを本番環境にデプロイする手順を説明します。デプロイは、Pilot のデプロイパネルで管理される、ガイド付きの3ステップのプロセスです。アプリケーションの作成については、アプリケーションを作成するを参照してください。カスタムウィジェットのデプロイは、別の方法で行います。Pilot は、Developer Console を介さずに、ウィジェットを Widget Registry に公開します。カスタムウィジェットをデプロイするを参照してください。

エディタービューとデプロイビュー

Pilot には、アプリケーションに表示するデータを制御する2つのビューがあり、ワークスペースの右上から切り替えられます。

エディタービューとデプロイビューの概要については、ワークスペースの概要を参照してください。

エディタービューでは、Pilot コンテナ内で生成されたシードデータが表示されます。デプロイビューでアプリケーションが空に見える場合は、オントロジーリソースがブランチ上に作成されていることと、元データセットにデータが含まれていることを確認してください。

本番環境のアプリケーションは、常にオントロジーの実データを使用します。Pilot コンテナのシードデータはデプロイされず、本番環境のアプリケーションからアクセスすることもできません。

デプロイ可能かどうかを確認する

デプロイプロセスを開始する前に、アプリケーションがデプロイできる状態になっていることを確認します。ワークスペースの右上にあるステータスインジケーターを選択して、ステータス監視ポップオーバーを開きます。ブランチを作成するには、デプロイ可能性のステータスがデプロイ可能である必要があります。

デプロイを妨げる一般的な問題には、次のものがあります。

• 無効なオントロジーリソース： 必須プロパティがない、存在しないリソースを参照しているなど、設定エラーのあるオブジェクトタイプやアクションタイプ
• 古いパッケージ依存関係： デプロイ前にアップグレードが必要な依存関係
• ビルドエラー： アプリケーションコードのコンパイルエラーや実行時エラー

これらの問題を解消するには、デプロイ可能性のステータスの横にある3点メニュー（...）を選択し、Pilot で修正を選択します。Pilot が問題を診断し、自動的に修正します。問題が解消しない場合は、チャットパネルで Pilot に問題の説明と解決を依頼できます。

デプロイを開始する

Pilot ワークスペースの右上からデプロイを選択して、デプロイパネルを開きます。パネルには、次の3つのステップが表示されます。

1. オントロジーリソースを実装する
2. アプリケーションとサブドメインを設定する
3. すべての CI チェックに合格する

1. オントロジーリソースを実装する

Pilot コンテナ内で作成したオントロジーの変更を本番環境のアプリケーションで使用するには、メインのオントロジーに昇格させる必要があります。Pilot は、このプロセスに Global Branching を使用します。Global Branching では、分離されたブランチ上でオントロジーを変更し、実データに対してテストしてから Main にマージできます。準備が整うまで本番環境に影響を与えることはありません。

デプロイブランチを作成する

オントロジーリソースを実装するステップでは、オブジェクトタイプ、アクションタイプ、リンクタイプなど、ブランチ上に作成する必要があるリソースが Pilot に表示されます。

1. ブランチの作成を選択して、これらのオントロジーの変更を含むデプロイブランチを生成します。
2. ブランチ名を入力し、確定します。

ブランチが作成されると、Pilot はオントロジー定義をブランチにプッシュし、インデックス化を開始します。インデックス化により、ブランチ上でオブジェクトタイプとアクションが利用可能になります。これにより、Main にマージする前に、デプロイビューで実データを使用してアプリケーションをプレビューし、アクションを実行できます。

ブランチの作成に失敗した場合は、デプロイ可能性のステータスがチェックに合格していることを確認し、オントロジータブで解消が必要な Pilot の編集が残っていないか確認します。また、別の名前で新しいブランチを作成してみることもできます。

Global Branching でレビューしてマージする

ブランチの作成後、オントロジーの変更をレビューしてマージします。

1. ブランチを表示を選択して Global Branching を開き、ブランチ上のリソースとその状態を確認します。
2. 提案を作成を選択し、提案名と説明（任意）を入力します。
3. 作成するを選択して提案を送信します。
4. チェックに合格したら、提案をマージを選択して、オントロジーリソースを Main に適用します。

エンロールメントの設定によって、提案は自動で承認される場合も、適切な権限を持つユーザーによる手動レビューが必要な場合もあります。

マージが完了すると、Pilot に Main に戻るよう求めるプロンプトが表示されます。その後、オントロジーリソースを実装するステップでは、すべてのリソースが最新として表示されます。

2. アプリケーションとサブドメインを設定する

オントロジーリソースが Main に配置されると、生成された UI を提供するホスト型アプリケーションを設定できます。

Developer Console アプリケーションを作成する

アプリケーションとサブドメインを設定するステップで、アプリケーションを設定するを選択します。次の項目を含むダイアログが表示されます。

1. Developer Console アプリケーション名： Pilot が、Pilot プロジェクトに関連する名前を提案します。
2. 組織： アプリケーションを配置する組織を選択します。
3. サブドメイン： アプリケーションのサブドメインを選択します。Pilot が利用可能かどうかを確認し、URL は <subdomain>.<enrollment>.palantirfoundry.com の形式になります。

アプリケーションを作成するを選択して進みます。Pilot は Developer Console のアプリケーションレコードを作成し、関連するオブジェクトタイプとアクションタイプを自動的に含めて、アプリケーションの制限を定義します。Developer Console アプリケーションの作成には、特定の権限が必要です。

サブドメイン申請を承認する

サブドメインの登録には、Control Panel での承認が必要です。エンロールメント管理者は、Control Panel > 承認に移動し、次の手順を完了する必要があります。

1. Foundry ドメイン、申請されたサブドメイン、ホスト型アプリケーションなど、サブドメイン申請の詳細をレビューします。
2. 承認を選択します。

承認されると、ホストされるドメインが登録され、Developer Console アプリケーションにマッピングされます。Pilot に戻ると、アプリケーションとサブドメインを設定するステップで、アプリケーションの制限が最新であることを確認できます。

サブドメインの承認にかかる時間はエンロールメントによって異なり、一部のエンロールメントでは、サブドメインの登録に追加のセキュリティレビューが必要な場合があります。承認待ちで作業を進められない場合は、エンロールメント管理者にお問い合わせください。

3. CI チェックを実行してリリースする

オントロジーリソースを実装し、Developer Console アプリケーションを設定したら、デプロイファイルを生成してアプリケーションをリリースできます。

デプロイファイルを生成する

すべての CI チェックに合格するステップで、チェックを有効にするためにデプロイファイルを生成するを選択します。Pilot は、次のファイルを含む CI および環境の設定ファイルをリポジトリ内に生成します。

• .env.production
• ci.yml
• foundry.config.json
• その他のビルドスクリプトおよび設定スクリプト

次に、Pilot は生成した設定を使って、本番環境で使用できるアーティファクトをビルドします。CI チェックは自動的に開始されます。

CI チェックの失敗

CI チェックに失敗した場合は、次の方法を試します。

1. デプロイファイルを生成するをもう一度選択して、設定ファイルを再生成します。これにより、古いデプロイ設定が原因の問題が解決されます。
2. 編集ビューに切り替え、Pilot にビルドエラーの修正を依頼するプロンプトを入力します。たとえば、The CI checks are failing. Can you check the build output and fix any errors? と入力します。
3. Pilot が修正を適用したら、デプロイビューに戻り、デプロイファイルを生成するを選択して CI チェックを再実行します。

タグを付けてリリースする

CI チェックに合格すると、アプリケーションにタグを付けてリリースできます。

1. タグとリリースを選択します。
2. タグとリリースダイアログで、次の操作を行います。
   • ブランチまたは特定のコミットを確認します。
   • バージョンの種類を選択します。後方互換性のある修正にはパッチ、機能追加などの変更にはマイナー、破壊的変更にはメジャー、カスタムタグにはカスタムを選択します。
   • タグとリリースを選択してリリースを開始します。

Pilot はリリースの進行状況を追跡し、タグが作成されると確認を表示します。

本番アプリケーションを開く

デプロイが完了すると、Pilot はアプリが正常にデプロイされました。 と、アプリを表示へのリンクを表示します。アプリを表示を選択すると、サブドメインで新しくデプロイされたアプリケーションが開きます。

初めてアクセスすると、OAuth の同意画面が表示されます。許可を選択して、必要なオントロジーリソースとメディアデータセットへのアクセスを Developer Console アプリケーションに付与します。その後、本番アプリケーションが開き、オントロジーを通じて実際のデータを操作できます。

デプロイ後

アプリケーションをデプロイした後も、Pilot で引き続き改善できます。

1. 編集ビューに切り替え、最初に作成したときと同じように、追加のプロンプトで変更を加えます。
2. 更新をリリースする準備ができたら、デプロイビューに切り替えます。
3. 変更に新しいオントロジーリソースや既存のオントロジーリソースの変更が含まれる場合は、新しいブランチを作成するか既存のブランチをリセットし、Global Branching でマージして、新しいリリースにタグを付けます。
4. 変更がコードのみの場合（オントロジーの変更がない場合）は、新しいデプロイファイルを生成し、新しいリリースに直接タグを付けます。