Remote EngineをAPI経由でプログラムを使って作成し、ペアリングして、フローを自動化します。
始める前に
以下のAPIリクエストを実行するマシンにRemote Engineのアーカイブファイルをダウンロードし、ローカルに解凍済みであること。Remote Engineがまだペアリングされていません。
このタスクについて
次の例のコードサンプルには、シェルスクリプトのさまざまな部分が示されています。
手順
-
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'
-
新しいRemote Engineのペアリングキーを取得し、そのRemote Engineのインストールディレクトリーにあるpreauthorized.key.cfgファイルに挿入します。このペアリングキーは事前承認キーとも呼ばれます。このペアリングキーは、Talend Cloud Management Consoleの[Processing] (処理中)ページにある[Engines] (エンジン)タブで、またはRemote Engine作成レスポンスボディのpreAuthorizedKeyパラメーターから取得できます。
echo "remote.engine.pre.authorized.key = $PAIRING_KEY" > <RemoteEngineInstallationDirectory>/etc/preauthorized.key.cfg
-
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 Cloud Management Consoleとの通信を保護するためにキーペアを使います。ペアリングのプロセス中にランダムなパスワードが生成されます。
独自のパスワードを定義する必要がある場合は、エンジンをペアリングする前に、このエンジンのパブリックキーとプライベートキーを保護手順を完了してください。