Documentation
ドキュメントの検索
karat

+

K

APIリファレンス ↗
データ統合データ接続エージェントおよびデータ接続エージェントの設定

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

エージェントの設定

エージェントは、ユーザーの組織ネットワーク内にインストールされ、Foundry の Data Connection インターフェースから管理されるダウンロード可能なプログラムです。エージェントは、ユーザーの組織ネットワーク内の異なるデータソースに接続する能力を持っています。その主な目的は、これらのソースからデータを読み取り、制限されたアクセストークンを用いてそれを Foundry に安全に取り込むことです。

エージェントを設定するために必要な高レベルのステップは次のとおりです：

  1. エージェントがインストールされるユーザーの組織ネットワーク内にスペースを作成します。
  2. エージェントが Foundry と通信するために必要なネットワークエグレスを確認します。
  3. Data Connection を通じてエージェントソフトウェアをダウンロードし、インストールします。
  4. エージェントマネージャーの自動再起動を設定します。

エージェントを稼働させたい場合、そして Foundry にソースを接続したい場合は、エージェントがデータを安全に読み取るために使用できるソースシステムの資格情報を取得する必要があります。ユーザーの組織のネットワーク設定によっては、エージェントがソースシステムに到達できるようにネットワーク設定を設定する必要があるかもしれません。

プラットフォーム内ガイド

このガイドの残りの部分は、エージェントを作成するために必要なステップを詳しく説明します。Data Connection 内でエージェント作成のステップバイステップのチュートリアルも利用できます。それにアクセスするには：

  • ログインした後、サイドバーを使用して Data Connection に移動します。
  • Agents タブを選択します。
  • 右上の New agent を選択します。

新しいエージェントを作成するオプションが表示されない場合、それを行うための必要な役割がない可能性があります。Control Panel でのエージェント作成ワークフローの管理について詳しく学びます。

設定手順

エージェントホストの作成

エージェントプログラムを実行するためには、それをホストする適切な環境が必要です。理想的には、オペレーティングシステムとして Linux を使用する環境です。

Foundry エージェントのホスティング方法として最も一般的に使用されるのは、クラウド環境で Linux 仮想マシン（VM）をプロビジョニングすることです。例えば、AWS、Azure、または GCP で Linux VM をプロビジョニングすることができます。しかし、ユーザーの組織に所属する Linux サーバー上でエージェントをホストすることもできます。Foundry エージェントを Windows 上でホストすることは可能ですが、これは Palantir によって推奨されておらず、Linux 環境でホストすることができない場合にのみ使用すべきです。

エージェントをホストする適切な場所が確定したら、次のステップは、ホストが Foundry エージェントが動作するための必要なハードウェアと OS の要件を満たすことを確認することです。これらは次のとおりです：

  • 64-bit Linux または他の Linux オペレーティングシステム（推奨 CentOS 7、RHEL、または同等のもの）

    • エージェントは自身の JDK 上で動作しますが、これは Linux/x86-64 用にコンパイルされています。必要に応じて（例えば、AWS Graviton や他の ARM ベースの CPU 上で実行する場合）、service/bin/launcher-static.yml の javaHome の値を変更することで、別の JDK 上でエージェントを実行することが可能です。

    一般的に、別の JDK 上でエージェントを実行することは推奨されておらず、将来的にこれをサポートするかどうかは保証されていません。この設定オプションが必要な場合は、Palantir サポートに連絡して支援を依頼してください。

  • 4 CPU コア

  • 16 GB RAM

  • 500GB のフリーディスクスペース（/opt にマウント、SSD が望ましい）

  • エージェント用に使用するホストは、単一の Foundry Agent を実行するためだけに使用し、他のサービスやプロセスと共存しないようにするべきです。

さらに、これらが推奨される ulimits です：

  • コアファイルサイズ：ハードリミットとソフトリミットは共に 0
  • オープンファイル：ハードリミットとソフトリミットは共に 262144
  • 実行プロセス：ハードリミットとソフトリミットは共に 65536
  • スタックサイズ：ハードリミットとソフトリミットは共に 32768
  • 最大ロックメモリ：ハードリミットとソフトリミットは共に "無制限"
エージェント要件

エージェントのネットワークアクセスを設定する

ユーザーの組織ネットワーク内のホストにエージェントがインストールされていると仮定すると、エージェントはインターネットを経由してアクセスされる Foundry VPC（Virtual Private Cloud）に到達するためにネットワークエグレスが必要となります。ユーザーのネットワークがデフォルトでエグレスを許可していない場合、エージェント（および/またはそのホスト）からユーザーの Foundry インスタンスへのアウトバウンド接続を許可するために特定の設定が必要となる可能性があります。これには、ファイアウォールを開くか、エグレス用のプロキシを設定するなどがあります。

最初のステップとして、ユーザーのサーバーから Foundry へのエグレスが利用可能であることを確認してください。ユーザーは プラットフォーム内ガイド からドメイン名とポートをコピーして、ネットワークアクセスを適切に設定することができます。

egress

ユーザーのホストが Foundry VPC と通信できることを確認するために、ユーザーの VM 上でこのコマンドを実行することができます：

Copied!
1
2
3
4
5
6
7
# curlコマンドを用いて特定のドメインに対してリクエストを送信します。
# -s オプションはサイレントモードを意味し、プログレスメーターやエラーメッセージを表示しません。
# https://<あなたのドメイン名>/magritte-coordinator/api/ping はリクエストを送信するURLです。
# > /dev/null という部分は、リクエストの結果を/dev/null（つまり何も表示しない）にリダイレクトすることを意味します。
# && echo pass はリクエストが成功した場合（HTTPステータスコードが200の場合）、"pass"と表示します。
# || echo fail はリクエストが失敗した場合（HTTPステータスコードが200以外の場合）、"fail"と表示します。
curl -s https://<あなたのドメイン名>/magritte-coordinator/api/ping > /dev/null && echo pass || echo fail

すべてが正常に動作している場合、出力として pass が表示されます。

ping は、Foundry VPC への接続性を不完全にテストするものであることに注意してください。

自動再起動の設定

自動再起動が設定されていない場合、エージェントがクラッシュしたり、エージェントホストが再起動したりするたびにダウンタイムが発生します。

エージェントマネージャがクラッシュした場合に自動的に再起動するように設定するには、VM/マシンのターミナルで、cron ジョブを作成する権限を持つユーザーとして、エージェントマネージャのサービスディレクトリから ${AGENT_MANAGER_DIR}/service/bin/auto_restart.sh コマンドを実行します。

エージェントマネージャをアップグレードする際など、自動再起動を停止する必要がある場合は、${AGENT_MANAGER_DIR}/service/bin/auto_restart.sh clear を実行することで停止できます。

プロジェクトにエージェントリソースを保存する

次に、新しいエージェントに名前を付け、それを保存するプロジェクトを選択する必要があります。Foundry では、エージェントは リソース であり、プロジェクトに保存されることで、権限が高度に設定可能になります。

エージェントを保存するための新しいプロジェクトを作成することをお勧めします。

Foundry の権限は広範なトピックです。詳しく知りたい場合は、以下のリソースを参照してください。

エージェントのダウンロードとインストール

エージェント用のハードウェアが用意されたら、次のステップは、Foundry からエージェントソフトウェアをダウンロードし、ホストにインストールすることです。ホスト上で、プラットフォーム内のガイドに記載された手順に従って、パッケージをダウンロードし、展開し、エージェントを起動します。

プロキシを設定する必要がある場合は、プロキシ設定ドキュメントで詳細を確認できます。

エージェントの起動が成功した後は、自動アップグレードを設定するガイドに従って、エージェントが時間の経過とともにアップグレードされるようにします。

次のステップ

エージェントの作成、インストール、起動が完了したら、Data Connection のエージェントページに移動し、エージェントの健康状態と接続性を監視する方法を確認してください。

エージェントについてもっと詳しく知る。

エージェントの設定が完了したら、ソースの設定に進んで、エージェントを組織のデータソースと接続します。