# エアギャップ環境でのDynamic Engineサービス用のHTTPプロキシの使用

エアギャップ環境において、アウトバウンドのHTTPおよびHTTPSトラフィックにHTTPプロキシを使用するようにDynamic Engineサービスを設定します。

## 始める前に

* HTTP/HTTPSプロキシサーバーのアドレスとポートを取得します。
* プロキシサーバーのアドレスを許可リストに追加します。
* dynamic-engine-crdカスタムリソース定義は、oci://ghcr.io/talend/helm/dynamic-engine-crd Helmチャートを使用してインストールされている必要があります。インストールされていない場合は、次のコマンドを実行してインストールしてください。
  1. 使用するチャートのバージョンを見つけます。

     * 次のHelmコマンドを実行します:
       ```
       helm show chart oci://ghcr.io/talend/helm/dynamic-engine-crd --version <engine_version>
       ```
     * Talend Management Consoleから直接バージョンを見るか、自分のDynamic Engineバージョンに含まれているチャートバージョンの[Dynamic Engine変更ログ](https://help.qlik.com/talend/en-US/dynamic-engine-changelog/Cloud)をチェックしてください。
     * [Dynamic Engineバージョンエンドポイント](https://talend.qlik.dev/apis/dynamic-engine/2021-03/#operation_return-all-supported-dynamic-engine-versions)へのAPIコールを使用します。

  2. 次のコマンドを実行し、目的のバージョンのHelmチャートをインストールします。

     ```
     helm install dynamic-engine-crd oci://ghcr.io/talend/helm/dynamic-engine-crd --version <helm_chart_version>
     ```

     &lt;helm\_chart\_version&gt;を、お使いのDynamic Engineバージョンでサポートされているチャートのバージョンに置換します。

     バージョンを指定しないと、利用可能な最新のdynamic-engine-crdチャートバージョンがインストールされます。

## このタスクについて

インターネットへの直接アクセスが制限されており、アウトバウンドトラフィックをプロキシ経由でルーティングする必要がある場合は、この手順を使用してください。

## 手順

1. HTTPプロキシのDynamic Engineとその環境のカスタムvaluesファイルを作成します。
   ```
   cat <<EOF > $DYNAMIC_ENGINE_ID-custom-http-proxy-values.yaml
   global:
     proxy:
       enabled: true
       httpProxy: http://<proxy-server-address>[:<port>]
       httpsProxy: http[s]://<proxy-server-address>[:<port>]
   EOF

   cat <<EOF > $DYNAMIC_ENGINE_ENVIRONMENT_ID-custom-http-proxy-values.yaml
   global:
     proxy:
       enabled: true
       httpProxy: http://<proxy-server-address>[:<port>]
       httpsProxy: http[s]://<proxy-server-address>[:<port>]
   EOF
   ```
   * HTTPプロキシを有効にするには、enabled: trueを設定します。
   * HTTPプロキシを無効にするには、enabled: falseを設定します。
   * 外部呼び出しのすべてのHTTPトラフィックをブロックするには、httpProxy: ~を設定します(nullはプロキシの使用を無効にします)。
   * ポートはオプションです。
   * スキームはhttpまたはhttpsになります。
2. HTTPプロキシを使用して、Dynamic Engineとその環境をインストールまたはアップグレードします。
   ```
   helm upgrade dynamic-engine-$DYNAMIC_ENGINE_ID --install \
     -f $DYNAMIC_ENGINE_ID-values.yaml  \
     -f $DYNAMIC_ENGINE_ID-custom-http-proxy-values.yaml \
     oci://ghcr.io/talend/helm/dynamic-engine \
     --version $DYNAMIC_ENGINE_VERSION

   helm upgrade dynamic-engine-environment-$DYNAMIC_ENGINE_ENVIRONMENT_ID --install \
     -f $DYNAMIC_ENGINE_ENVIRONMENT_ID-values.yaml  \
     -f $DYNAMIC_ENGINE_ENVIRONMENT_ID-custom-http-proxy-values.yaml \
     oci://ghcr.io/talend/helm/dynamic-engine-environment \
     --version $DYNAMIC_ENGINE_VERSION
   ```

## タスクの結果

dynamic-engineネームスペースでは、dynamic-engine-operatorサービスは、設定されたプロキシ経由でクラウドのエンドポイントを呼び出すことができます。

dynamic-engine-environmentネームスペースでは、クラウドエンドポイントを呼び出すサービスは、設定されたプロキシを使用するため、ブロックされることはありません。