プログラミングでRemote Engineを作成およびペアリング - Cloud

Talend Remote Engineユーザーガイド (Windows)

Version
Cloud
Language
日本語
Operating system
Windows
Product
Talend Cloud
Module
Talend Remote Engine
Content
インストールとアップグレード
ジョブデザインと開発
Last publication date
2024-02-23

Remote EngineをAPI経由でプログラムを使って作成し、ペアリングして、フローを自動化します。

始める前に

以下のAPIリクエストを実行するマシンにRemote Engineのアーカイブファイルをダウンロードし、ローカルに解凍済みであること。Remote Engineがまだペアリングされていません。

このタスクについて

次の例のコードサンプルには、シェルスクリプトのさまざまな部分が示されています。

手順

  1. POSTを使い、runtimes/remote-enginesエンドポイントにRemote Engineを作成します。

    payloadにいくつかのパラメーターが定義されており、その一部はオプションです。

    注:

    パラメーターの完全リストについては、https://api.<env>.cloud.talend.com/tmc (<env>はお使いのクラウドリージョン名)で利用できるSwagger UI APIリファレンスをチェックしてください。リージョン名がわからない場合は、Talend CloudのリージョンとURLをご覧ください。

    environmentIdパラメーターとworkspaceIdパラメーターを検索する場合は、GETリクエストをworkspacesエンドポイントに送信します。

    curl -X POST 
    --header 'Content-Type: application/json' 
    --header 'Accept: application/json' 
    --header 'Authorization: Bearer 'personal_access_token or service_account_token' -d '{
           "name": "My Remote Engine",
    		"environmentId": "5d1619bb818cfe3dca795e41",  
            "workspaceId": "5d1619bb818cfe3dca795e44" 
           }' 
    'https://api.us.cloud.talend.com/tmc/v1.3/runtimes/remote-engines'
    
  2. 新しいRemote Engineのペアリングキーを取得し、そのRemote Engineのインストールディレクトリーにあるpreauthorized.key.cfgファイルに挿入します。このペアリングキーは事前承認キーとも呼ばれます。このペアリングキーは、Talend Management Console[Processing] (処理中)ページにある[Engines] (エンジン)タブで、またはRemote Engine作成レスポンスボディのpreAuthorizedKeyパラメーターから取得できます。
    echo "remote.engine.pre.authorized.key = $PAIRING_KEY" > <RemoteEngineInstallationDirectory>/etc/preauthorized.key.cfg 
  3. Remote Engineのインストールディレクトリーのorg.talend.ipaas.rt.pairing.client.cfgファイルにあるデプロイリージョンに一致するよう、このペアリングサービスをアップデートします。
    次の例をTalend Cloudリージョンに適用させます。
    echo "pairing.service.url=https://pair.us.cloud.talend.com" > <RemoteEngineInstallationDirectory>/etc/org.talend.ipaas.rt.pairing.client.cfg

タスクの結果

新しいRemote Engineは起動時にペアリングされます。次の例では、作成したRemote Engineを既存のRemote Engineクラスターに追加する方法を説明しています。

Remote Engineは、Talend Management Consoleとの通信を保護するためにキーペアを使います。ペアリングのプロセス中にランダムなパスワードが生成されます。

独自のパスワードを定義する必要がある場合は、エンジンをペアリングする前に、このエンジンのパブリックキーとプライベートキーを保護手順を完了してください。