了解 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 服务器和集群内部网络
支持的代理配置
| 配置 | 问题描述 | 身份验证 |
|---|---|---|
无代理 |
直接连接到互联网;不使用代理。 |
无 |
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 支持两种代理类型。使用 `--proxy-type`设置类型。
常规正向代理 (r) |
TLS 检查代理 (t) |
|
|---|---|---|
如何处理 HTTPS 流量 |
通过 HTTP |
解密 HTTPS 流量并使用代理的检查 CA 对每个目标的证书进行重新签名。 |
|
仅当代理本身使用 HTTPS 且其证书由私有 CA 签名时才需要。 |
必需。提供代理用于检查的 CA 证书。如果省略它,则安装程序会在建立任何网络连接之前拒绝该命令。 |
|
|
|
TLS 检查代理与 HTTPS 代理不同。HTTPS 代理是您通过 TLS 连接的代理(--proxy-scheme https)。TLS 检查代理是重新签名您通过其到达的目标的证书的代理。TLS 检查代理可以使用任一方案。
某些其他代理功能不受支持。请参阅"已知限制"。
安装程序为每个互联网目的地和每个 AI Data Engine 组件使用一个代理。代理设置在安装过程中进行设置。
代理配置参数
| 参数 | 默认 | 问题描述 |
|---|---|---|
|
无 |
转发代理的主机名或 IPv4 地址,不带 |
|
|
代理侦听的端口。如果端口已包含在 `--proxy-host`中,则忽略。 |
`--proxy-scheme <http |
https>` |
|
用于连接到代理服务器本身的协议。这不是代理到达的目的地的方案。大多数正向代理监听纯 HTTP,因此请为它们传递 |
|
无 |
包含代理的 CA 证书的 PEM 文件或 `.crt`和 `.pem`文件的扁平目录的路径。安装程序读取目录而不递归到子目录,并将文件合并到一个捆绑包中。 在以下情况下需要执行此操作:
请勿为通过 HTTP 连接的常规代理 ( |
|
无 |
基本身份验证的用户名。使用 HTTP 代理时,安装程序会警告凭据以未加密形式传输到代理。需要密码,通过 `--proxy-password-file`提供或在提示符处输入。 |
|
无 |
指向仅包含代理密码的本地文件的路径,其权限设置为 |
`--proxy-type |
t>` |
|
代理类型。 |
|
|
|
安装程序不接受 `--proxy-password`或 `PROXY_PASSWORD`环境变量。请改用 `--proxy-password-file`或交互式提示符。 |
安装程序下载
从 NetApp Console 复制的 install 命令从内容交付网络(CDN)下载安装程序,然后一步运行。下载不使用代理。如果目标主机仅通过代理访问互联网,则可自行下载安装程序,并从提取的安装程序中运行 install 命令。部署主题描述了这些步骤。
代理验证
在安装程序下载任何内容之前,它会从安装程序主机运行检查。检查确认代理响应,代理接受您的凭据,并且代理证书对您选择的方案有效。如果检查失败,安装程序将停止并指出原因,例如错误的端口、错误的方案或被拒绝的密码(HTTP 407)。
对于多节点部署,检查仅涵盖代理。它不测试集群节点是否可以到达代理。
安装后更改代理设置
代理设置在安装过程中进行配置。安装程序不会在已安装的集群上再次运行。若要在安装后更改代理主机、端口、凭据或 CA 证书,请联系 NetApp 支持人员。