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

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のアプリケーションにアクセス](https://help.qlik.com/talend/ja-JP/installation-guide-windows/Cloud/talend-cloud-application-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との通信を保護するためにキーペアを使います。ペアリングのプロセス中にランダムなパスワードが生成されます。

独自のパスワードを定義する必要がある場合は、エンジンをペアリングする前に、この[エンジンのパブリックキーとプライベートキーを保護](https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-windows/securing-keystore-access-remote-engines)手順を完了してください。