Documentation
ドキュメントの検索
karat

+

K

APIリファレンス ↗
Developer toolchainSuperRepo開発Foundry CLI

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

Foundry CLI

ベータ版

SuperRepo は開発のベータ版段階にあり、お使いのエンロールメントでは利用できない場合があります。開発が進行している間は、機能が変更される場合があります。

Foundry CLI（foundry）は、リポジトリが Palantir プラットフォームの内外のどちらでホストされている場合でも、ご自身のマシンから SuperRepo を開発するためのコマンドラインツールです。macOS、Windows、Linux で動作します。テンプレートからプロジェクトのひな形を作成し、プロジェクトをビルド、プレビュー、デプロイするために使用します。

インストール

Foundry CLI は、このセクションの手順に従うか、Palantir プラットフォーム内の対話型インストールフローを使ってインストールできます。このフローを開くには、エンロールメントのルートアドレスに /workspace/code/superrepo を追加します。

推奨フロー

可能な場合は、プラットフォーム内のフローからインストールしてください。このフローでは、以下の手順で必要となるユーザー生成トークンよりも制限の厳しいトークンがインストール用に発行されるため、より安全な方法です。

ステップ1：Foundry URL を設定する

ターミナルセッションで、FOUNDRY_URL をエンロールメントのルートアドレスに設定します。

Copied!
1
export FOUNDRY_URL="insert_domain_here"
Copied!
1
$env:FOUNDRY_URL = "insert_domain_here"

ステップ2：インストーラーにトークンを指定する

お使いの Foundry エンロールメント用のトークンを生成し、同じターミナルセッションで設定します。ユーザー生成トークンにはスコープ設定がないため、特定のスコープは必要ありません。

Copied!
1
export TOKEN="insert_token_here"
Copied!
1
$env:TOKEN = "insert_token_here"

FOUNDRY_URL と TOKEN の変数は、ステップ3のインストールコマンドによって読み取られ、エンロールメントから CLI をダウンロードするために使われます。これらは、インストール後に CLI 自体が使用する資格情報ではありません。その資格情報は、次のセクションで foundry login を使って設定します。このトークンは CLI のインストールにのみ必要なため、サインイン後に削除できます。また、トークンの有効期限が切れても、インストール済みの CLI には影響しません。

ステップ3：CLI をインストールする

お使いのオペレーティングシステムに対応するインストールコマンドを実行します。CLI は常にエンロールメントからダウンロードされます。パッケージマネージャー経由や単体のダウンロードとしては配布されていません。

Windows では、ステップ1と2で設定した $env:FOUNDRY_URL と $env:TOKEN の値を使って install-foundry.bat がダウンロードされるため、先に同じ PowerShell セッションでこれらの手順を実行してください。

Copied!
1
curl -sS "$FOUNDRY_URL/code/api/extension/install-script" -H "Authorization: Bearer $TOKEN" | bash
Copied!
1
2
Invoke-WebRequest -Uri "$env:FOUNDRY_URL/code/api/extension/install-bat" -Headers @{ Authorization = "Bearer $env:TOKEN" } -OutFile "install-foundry.bat"
.\install-foundry.bat

Foundry で認証する

SuperRepo プロジェクトの開発中に CLI がプラットフォームにアクセスできるように、Foundry エンロールメントにサインインします。

Copied!
1
foundry login

このコマンドでは、Foundry URL とトークンの入力を求めるプロンプトが表示され、その後、以降のすべての CLI コマンドで使用する資格情報が保存されます。これには、ローカル開発サーバーと foundry deploy も含まれます。プロンプトを表示せずにサインインするには、FOUNDRY_TOKEN 環境変数にトークンを、--foundry-url オプションにエンロールメントの URL を指定します。CI システムでは、この形式を使用してください。

認可エラーによってコマンドの実行に失敗するようになった場合は、foundry login で保存した資格情報の有効期限が切れています。次のコマンドを使い、ブラウザーで再認可します。

Copied!
1
foundry login refresh

CLI を更新する

Foundry CLI は、自身を最新バージョンに更新できます。

Copied!
1
foundry update self

詳しくはこちら

Foundry CLI のすべての機能を確認するには、オプションを一覧表示できます。

Copied!
1
foundry --help

CLI がサポートするワークフローの詳細については、SuperRepo を作成する、初回のデプロイに備える、高度なワークフローを参照してください。