Skip to main content
日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

AI Data Engineのプロキシについて

共同作成者 netapp-dbagwell

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 のインターネット宛先はすべて、ポート 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 CONNECT を使用して接続をトンネリングし、宛先証明書は変更しません。

HTTPSトラフィックを復号し、プロキシの検査CAを使用して各宛先の証明書に再署名します。

--proxy-ca-cert

プロキシ自体がHTTPSを使用し、その証明書にプライベート認証局が署名している場合にのみ必要です。

必須。プロキシが検査に使用するCA証明書を提供してください。これを省略すると、インストーラーはネットワーク接続を行う前にコマンドを拒否します。

--proxy-type

r(デフォルト)

t

TLS検査プロキシはHTTPSプロキシとは異なります。HTTPSプロキシとは、TLS経由で接続するプロキシのことです(--proxy-scheme https)。TLS検査プロキシとは、接続先の証明書を再署名するプロキシのことです。TLS検査プロキシはどちらの方式も使用できます。

その他のプロキシ機能の一部はサポートされていません。"既知の制限事項"を参照してください。

インストーラは、すべてのインターネットの宛先とすべてのAI Data Engineコンポーネントに対して1つのプロキシを使用します。プロキシ設定はインストール時に設定されます。

プロキシ設定パラメータ

パラメータ デフォルト 説明

--proxy-host <host[:port]>

None

フォワード プロキシのホスト名またはIPv4アドレス( http://`または `https://`なし)。プロキシ設定を有効にします。インラインポートを受け入れます(`host:port)。 `--proxy-host`のポートは `--proxy-port`よりも優先されます。

--proxy-port <port>

80 HTTPの場合、 443 HTTPSの場合

プロキシがリッスンするポート。 --proxy-host にポートがすでに含まれている場合は無視されます。

`--proxy-scheme <http

https>`

https

プロキシ サーバ自体への接続に使用されるプロトコル。これは、プロキシが到達する宛先のスキームではありません。ほとんどのフォワード プロキシはプレーンなHTTPでリッスンするため、それらには `--proxy-scheme http`を渡します。

--proxy-ca-cert <path>

None

プロキシのCA証明書を含むPEMファイル、または `.crt`および `.pem`ファイルのフラットディレクトリへのパス。インストーラーは、サブディレクトリを再帰的に検索することなくディレクトリを読み込み、ファイルを1つのバンドルに統合します。

これは以下の場合に必要です:

  • プライベートCAが署名した証明書を持つHTTPSプロキシを使用します。プロキシ証明書に署名したCA証明書を提供してください。

  • TLS検査プロキシを使用します(--proxy-type t)。プロキシが検査に使用するCA証明書を提供してください。

通常のプロキシ(--proxy-type r)には指定しないでください(HTTP経由で接続する場合(--proxy-scheme http)。検証するプロキシ証明書がないため、インストーラーはCA証明書を使用しません。

--proxy-user <user>

None

ベーシック認証のユーザー名。HTTPプロキシを使用する場合、インストーラは認証情報が暗号化されずにプロキシに送信されることを警告します。パスワードが必要です。 `--proxy-password-file`で指定するか、プロンプトで入力します。

--proxy-password-file <path>

None

プロキシパスワードのみを含むローカルファイルへのパス。権限は `0600`または `0400`に設定します。省略した場合、インストーラは非表示の入力でパスワードの入力を求めます。

`--proxy-type

t>`

r

プロキシの種類。 `r`は通常のフォワード プロキシであり、デフォルトです。 `t`はTLSインスペクションプロキシであり、各宛先の証明書に再署名します。 `t`を使用する場合は、 `--proxy-ca-cert`も指定する必要があります。

--no-proxy

メモ インストーラは `--proxy-password`や `PROXY_PASSWORD`環境変数を受け付けません。代わりに `--proxy-password-file`またはインタラクティブなプロンプトを使用してください。

インストーラーのダウンロード

NetApp Consoleからコピーしたインストールコマンドは、コンテンツ配信ネットワーク(CDN)からインストーラをダウンロードし、1つのステップで実行します。ダウンロードにはプロキシは使用されません。対象ホストがプロキシ経由でのみインターネットに接続できる場合は、お客様ご自身でインストーラをダウンロードし、展開したインストーラからインストールコマンドを実行します。導入に関するトピックでは、これらの手順について説明しています。

プロキシ検証

インストーラは、何かをダウンロードする前に、インストーラホストからチェックを実行します。このチェックにより、プロキシが応答すること、プロキシが認証情報を受け入れること、およびプロキシ証明書が選択したスキームに対して有効であることが確認されます。チェックが失敗した場合、インストーラは停止し、原因(たとえば、誤ったポート、誤ったスキーム、パスワードの拒否(HTTP 407)など)を示します。

マルチノード構成の場合、チェック対象はプロキシのみです。クラスタノードがプロキシに到達できるかどうかはテストしません。

インストール後にプロキシ設定を変更する

プロキシ設定はインストール時に設定されます。インストール済みのクラスターでは、インストーラーは再度実行されません。インストール後にプロキシホスト、ポート、認証情報、またはCA証明書を変更するには、NetAppサポートにお問い合わせください。