Configuring the PGAI agent#

注釈

TPAは現在、PGAIエージェントを使用してクラスターをEDB Postgres AI Cloud Serviceと統合することのみをサポートしています。 EDB Postgres AI Hybrid Managerと統合するためのエージェントの使用、または使用状況レポートは、TPAの将来のリリースでサポートされる予定です。

PGAIエージェントパッケージバージョン#

デフォルトでは、TPAはbeacon-agent の利用可能な最新バージョンをインストールします。

config.yml ファイルのcluster_vars セクションの下にbeacon_agent_package_version: xxx を含めることにより、インストールされるbeacon-agent パッケージのバージョンを指定できます。

cluster_vars:
    …
    beacon_agent_package_version: 1.56.2-1
    …

aptまたはyumが受け入れるバージョン指定子を使用できます。

バージョンが一致しない場合は、 * ワイルドカードを追加してみてください。これは、パッケージバージョンに2:... のようなエポック修飾子がある場合に必要になることがよくあります。

PGAIエージェント構成#

PGAIエージェント構成には、クラスターごとに設定する必要がある2つのパラメーター、アクセスキーとプロジェクトIDが含まれています。

アクセスキーはクラスターディレクトリで暗号化されたままで、 tpaのstore-password およびshow-password コマンドを使用して設定または読み取ることができます。

tpaexec store-password . beacon_agent_access_key
Password:
tpaexec show-password . beacon_agent_access_key

tpaexec provision の実行時に環境変数BEACON_AGENT_ACCESS_KEYが設定されている場合、アクセスキーはその値から設定されます。

プロジェクトIDは、cluster_vars のbeacon_agent_project_id キーの下のconfig.yml に保存されます。 --beacon_agent_project_id 引数がtpaexec configure に渡される場合、その値はconfig.yml に適切に書き込まれます。

PGAIエージェントのインストール#

TPAはEDBのリポジトリからPGAIエージェントをインストールし、beacon というオペレーティングシステムユーザーとbeacon というデータベースユーザーを作成します。エージェントの構成ファイルは、ビーコンユーザーのホームディレクトリの.beacon/beacon_agent.yaml に書き込まれます。

PGAIエージェントの実行#

TPAは、 systemdサービスユニットファイルをインストールして、ブート時にエージェントを起動し、ビーコンユーザーとして実行します。