AI Data Engineのプロキシについて
AI Data Engine(AIDE)ホストまたはクラスタがインターネットに直接アクセスできない場合は、インストーラとAI Data Engineがコンポーネントをダウンロードし、コンテナイメージをプルして、NetApp Consoleに登録できるように、フォワード プロキシを設定します。プロキシのオプションは、シングルノード構成とマルチノード構成で同じです。インストールの準備と実行の手順は異なるため、展開タイプごとに独自のワークフローがあります。
インストーラーは、パッケージマネージャーなど、ホスト上の他のソフトウェアのプロキシを設定しません。シングルノード展開の場合、インストーラーはk3sおよびAI Data Engineのプロキシを設定し、 `--proxy-ca-cert`で指定したCA証明書をホストのトラストストアに追加します。マルチノード展開の場合、インストーラーはAI Data Engineワークロードのみを設定します。各ノードでコンテナランタイムプロキシと証明書の信頼を設定します。
プロキシを使用したAI Data Engineの展開
各導入タイプごとに専用のトピックがあり、環境準備からインストーラーの実行まで、手順全体が詳しく説明されています。
-
"プロキシを使用したシングルノード展開としてAI Data Engineを展開します":インストーラは、k3sランタイムおよびAI Data Engineのプロキシを設定し、提供されたCA証明書をトラストストアに追加します。
-
"プロキシを使用したマルチノード展開としてAI Data Engineを展開する":インストーラーを実行する前に、各ノードでコンテナランタイムプロキシとCA証明書の信頼関係を設定します。
プロキシを通過するもの
インターネット宛てのトラフィックのみがプロキシを使用します。AI Data Engine のインターネット宛先はすべて、ポート 443 で HTTPS を使用するため、プロキシは `CONNECT`が"アウトバウンドインターネットアクセス"内の各エンドポイントのポート 443 へ接続することを許可する必要があります。
ネットワーク上のトラフィックは直接接続され、プロキシなしでもアクセス可能である必要があります:
-
Consoleエージェント(
--cm-host) -
NFS、CIFS/SMB、ONTAP、およびStorageGRIDデータソース
-
Active DirectoryとLDAP
-
Kubernetes APIサーバーとクラスターの内部ネットワーク
サポートされているプロキシ構成
| 構成 | 説明 | 認証 |
|---|---|---|
プロキシなし |
インターネットに直接接続します。プロキシは使用しません。 |
None |
HTTPフォワード プロキシ |
AI Data EngineはHTTP経由でプロキシに接続し、 `CONNECT`を使用してHTTPSの宛先をトンネリングします。 |
なし、またはHTTPベーシック認証(ユーザー名とパスワード) |
HTTPSフォワード プロキシ |
AI Data EngineはTLS経由でプロキシに接続します。プライベート認証局(CA)がプロキシ証明書に署名している場合は、CA証明書を提供します。 |
なし、またはHTTPベーシック認証(ユーザー名とパスワード) |
TLS検査プロキシ |
プロキシはHTTPSトラフィックを復号化し、各宛先の証明書を独自の検査CAで再署名します。 `--proxy-type t`を設定し、 `--proxy-ca-cert`で検査CA証明書を提供します。プロキシはHTTPまたはHTTPSでリッスンできます。 |
なし、またはHTTPベーシック認証(ユーザー名とパスワード) |
プロキシにはホスト名またはIPv4アドレスでアクセスできます。
サポートされているプロキシの種類
AI Data Engineは2種類のプロキシタイプをサポートしています。 `--proxy-type`を使用してタイプを設定します。
通常のフォワード プロキシ (r) |
TLS検査プロキシ(t) |
|
|---|---|---|
HTTPSトラフィックの処理方法 |
HTTP |
HTTPSトラフィックを復号し、プロキシの検査CAを使用して各宛先の証明書に再署名します。 |
|
プロキシ自体がHTTPSを使用し、その証明書にプライベート認証局が署名している場合にのみ必要です。 |
必須。プロキシが検査に使用するCA証明書を提供してください。これを省略すると、インストーラーはネットワーク接続を行う前にコマンドを拒否します。 |
|
|
|
TLS検査プロキシはHTTPSプロキシとは異なります。HTTPSプロキシとは、TLS経由で接続するプロキシのことです(--proxy-scheme https)。TLS検査プロキシとは、接続先の証明書を再署名するプロキシのことです。TLS検査プロキシはどちらの方式も使用できます。
その他のプロキシ機能の一部はサポートされていません。"既知の制限事項"を参照してください。
インストーラは、すべてのインターネットの宛先とすべてのAI Data Engineコンポーネントに対して1つのプロキシを使用します。プロキシ設定はインストール時に設定されます。
プロキシ設定パラメータ
| パラメータ | デフォルト | 説明 |
|---|---|---|
|
None |
フォワード プロキシのホスト名またはIPv4アドレス( |
|
|
プロキシがリッスンするポート。 |
`--proxy-scheme <http |
https>` |
|
プロキシ サーバ自体への接続に使用されるプロトコル。これは、プロキシが到達する宛先のスキームではありません。ほとんどのフォワード プロキシはプレーンなHTTPでリッスンするため、それらには `--proxy-scheme http`を渡します。 |
|
None |
プロキシのCA証明書を含むPEMファイル、または `.crt`および `.pem`ファイルのフラットディレクトリへのパス。インストーラーは、サブディレクトリを再帰的に検索することなくディレクトリを読み込み、ファイルを1つのバンドルに統合します。 これは以下の場合に必要です:
通常のプロキシ( |
|
None |
ベーシック認証のユーザー名。HTTPプロキシを使用する場合、インストーラは認証情報が暗号化されずにプロキシに送信されることを警告します。パスワードが必要です。 `--proxy-password-file`で指定するか、プロンプトで入力します。 |
|
None |
プロキシパスワードのみを含むローカルファイルへのパス。権限は `0600`または `0400`に設定します。省略した場合、インストーラは非表示の入力でパスワードの入力を求めます。 |
`--proxy-type |
t>` |
|
プロキシの種類。 `r`は通常のフォワード プロキシであり、デフォルトです。 `t`はTLSインスペクションプロキシであり、各宛先の証明書に再署名します。 `t`を使用する場合は、 `--proxy-ca-cert`も指定する必要があります。 |
|
|
|
インストーラは `--proxy-password`や `PROXY_PASSWORD`環境変数を受け付けません。代わりに `--proxy-password-file`またはインタラクティブなプロンプトを使用してください。 |
インストーラーのダウンロード
NetApp Consoleからコピーしたインストールコマンドは、コンテンツ配信ネットワーク(CDN)からインストーラをダウンロードし、1つのステップで実行します。ダウンロードにはプロキシは使用されません。対象ホストがプロキシ経由でのみインターネットに接続できる場合は、お客様ご自身でインストーラをダウンロードし、展開したインストーラからインストールコマンドを実行します。導入に関するトピックでは、これらの手順について説明しています。
プロキシ検証
インストーラは、何かをダウンロードする前に、インストーラホストからチェックを実行します。このチェックにより、プロキシが応答すること、プロキシが認証情報を受け入れること、およびプロキシ証明書が選択したスキームに対して有効であることが確認されます。チェックが失敗した場合、インストーラは停止し、原因(たとえば、誤ったポート、誤ったスキーム、パスワードの拒否(HTTP 407)など)を示します。
マルチノード構成の場合、チェック対象はプロキシのみです。クラスタノードがプロキシに到達できるかどうかはテストしません。
インストール後にプロキシ設定を変更する
プロキシ設定はインストール時に設定されます。インストール済みのクラスターでは、インストーラーは再度実行されません。インストール後にプロキシホスト、ポート、認証情報、またはCA証明書を変更するには、NetAppサポートにお問い合わせください。