在受限模式下手动部署 NetApp Console 代理
如果您要使用具有有限出站连接的 NetApp Console,则需要在受限模式下手动部署 Console 代理。
如果您不想使用市场订阅或正在部署 Google Cloud,则需要手动安装控制台代理。
步骤 1:准备云权限
在安装 Console 代理之前,请准备其管理资源所需的云提供商权限。
步骤 2:启用 Google Cloud API(仅限 Google Cloud)
如果要在 Google Cloud 中安装控制台代理,请在安装之前在项目中启用所需的 API。特定的 Cloud Volumes ONTAP 功能需要这些 API。
-
-
Cloud Build API (使用 Infrastructure Manager 进行私有模式 Cloud Volumes ONTAP 部署时需要)
-
云部署管理器 V2 API
-
云基础设施管理器 API
-
云日志 API
-
云资源管理器 API
-
计算引擎 API
-
身份和访问管理 (IAM) API
-
云密钥管理服务 (KMS) API(仅当您计划使用客户管理的加密密钥 (CMEK) 进行 NetApp Backup and Recovery 时才需要)
-
Cloud Quotas API(使用 Infrastructure Manager 部署 Cloud Volumes ONTAP 时需要)
-
步骤 3:准备网络访问
允许安装控制台代理的云提供商所需的出站端点。
云提供商端点
AWS 环境
允许这些 AWS 服务端点管理 AWS 资源,包括 FSx for ONTAP。
| 端点 | 目的 |
|---|---|
AWS 服务(amazonaws.com):
|
管理 AWS 资源。端点取决于您的 AWS 区域。 "有关详细信息,请参阅 AWS 文档" |
Amazon FSx for NetApp ONTAP:
|
基于 Web 的控制台通过与 Workload Factory API 交互来管理和操作基于ONTAP 的FSx 工作负载。 |
Azure 环境
允许适用于您的 Azure 区域的终结点:公共、政府或中国。
| 端点 | 目的 |
|---|---|
|
管理 Azure 公共区域中的资源。 |
|
管理 Azure 政府区域中的资源。 |
|
管理 Azure 中国区域的资源。 |
Google Cloud 环境
允许这些 Google Cloud API 端点管理项目中的资源。
| 端点 | 目的 |
|---|---|
|
管理 Google Cloud 中的资源。 |
NetApp Console 端点
允许 NetApp 支持、控制台功能以及控制台代理部署和升级的共享端点。
| 端点 | 目的 |
|---|---|
获取许可信息并将 AutoSupport 消息发送到 NetApp 支持。 |
|
更新NetApp支持站点 (NSS) 凭据或将新的 NSS 凭据添加到NetApp Console。 |
|
获取许可信息并向 NetApp 支持发送 AutoSupport 消息,以及接收 Cloud Volumes ONTAP 的软件更新。 |
|
|
在NetApp Console中提供功能和服务。 |
对于非政府区域,请使用以下端点: 对于政府区域,请改用以下端点: |
获取用于 Console 代理部署和升级的映像。 |
有关浏览器访问和其他网络要求,请参见 "为受限模式准备网络访问"。
步骤 4:安装 Podman 或 Docker Engine
根据您的操作系统,安装代理之前需要 Podman 或 Docker Engine。
-
Red Hat Enterprise Linux 8 和 9 需要 Podman。
-
Ubuntu 需要 Docker 引擎。
按照以下步骤安装和配置 Podman:
-
启用并启动 podman.socket 服务
-
安装python3
-
安装 podman-compose 包(因 Red Hat 版本而异)
-
将 podman-compose 添加到 PATH 环境变量
-
如果使用 Red Hat Enterprise Linux,请验证您的 Podman 版本使用的是 Netavark Aardvark DNS 而不是 CNI
|
|
安装代理后调整 aardvark-dns 端口(默认值:53),以避免 DNS 端口冲突。按照说明配置端口。 |
-
如果主机上安装了 podman-docker 包,请将其删除。
dnf remove podman-docker rm /var/run/docker.sock -
安装 Podman。
您可以从官方 Red Hat Enterprise Linux 存储库获取 Podman。
-
对于 Red Hat Enterprise Linux 9.6:
sudo dnf install podman-5:<version>其中 <version> 是您正在安装的 Podman 支持的版本。查看支持的 Podman 版本 。
-
适用于 Red Hat Enterprise Linux 9.1 至 9.4:
sudo dnf install podman-4:<version>其中 <version> 是您正在安装的 Podman 支持的版本。查看支持的 Podman 版本 。
-
对于 Red Hat Enterprise Linux 8:
sudo dnf install podman-4:<version>其中 <version> 是您正在安装的 Podman 支持的版本。查看支持的 Podman 版本 。
-
-
启用并启动 podman.socket 服务。
sudo systemctl enable --now podman.socket -
安装 python3。
sudo dnf install python3 -
如果您的系统上还没有 EPEL 存储库包,请安装它。
此步骤是必需的,因为 podman-compose 可从 Extra Packages for Enterprise Linux (EPEL) 存储库中获得。
-
如果使用 Red Hat Enterprise 9:
-
安装EPEL存储库软件包。
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm+
-
安装 podman-compose 包 1.5.0。
sudo dnf install podman-compose-1.5.0
-
-
如果使用的是 Red Hat Enterprise Linux 8:
-
安装EPEL存储库软件包。
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm -
安装 podman-compose 包 1.0.6。
sudo dnf install podman-compose-1.0.6使用 `dnf install`命令满足将 podman-compose 添加到 PATH 环境变量的要求。安装命令将 podman-compose 添加到 /usr/bin,它已经包含在 `secure_path`主机上的选项。 -
如果使用 Red Hat Enterprise Linux 8,请验证您的 Podman 版本是否使用带有 Aardvark DNS 的 NetAvark 而不是 CNI。
-
通过运行以下命令检查您的 networkBackend 是否设置为 CNI:
podman info | grep networkBackend -
如果 networkBackend 设置为
CNI,你需要将其更改为netavark。 -
安装 `netavark`和 `aardvark-dns`使用以下命令:
dnf install aardvark-dns netavark -
打开 `/etc/containers/containers.conf`文件并修改 network_backend 选项以使用“netavark”而不是“cni”。
如果
/etc/containers/containers.conf`不存在,请将配置更改为 `/usr/share/containers/containers.conf。 -
重新启动 podman。
systemctl restart podman -
使用以下命令确认 networkBackend 现在已更改为“netavark”:
podman info | grep networkBackend
-
-
-
如果将此代理与 Cloud Volumes ONTAP 系统关联,请考虑增加与代理关联的线程数,以提高性能。"了解如何增加代理的容器线程限制"。
按照 Docker 的文档安装 Docker Engine。
-
按照步骤安装受支持的 Docker Engine 版本。请勿安装最新版本,因为控制台不支持它。
-
验证 Docker 是否已启用并正在运行。
sudo systemctl enable docker && sudo systemctl start docker
第 5 步:在云环境中手动安装 NetApp Console 受限模式(必须用于 Google Cloud)
您可以将控制台代理手动安装到运行在 AWS、Azure 或 Google Cloud 上的 Linux 主机上。
您应该具有以下内容:
-
安装控制台代理的 root 权限。
-
如果控制台代理需要代理才能访问互联网,则提供有关代理服务器的详细信息。
您可以选择在安装后配置代理服务器,但这样做需要重新启动 Console 代理。
-
如果代理服务器使用 HTTPS 或代理是拦截代理,则需要 CA 签名的证书。
|
|
手动安装控制台代理时,无法为透明代理服务器设置证书。如果需要为透明代理服务器设置证书,则必须在安装后使用维护控制台。详细了解"代理维护控制台"。 |
-
您需要禁用安装期间验证出站连接的配置检查。如果未禁用此检查,手动安装将失败。"了解如何禁用手动安装的配置检查。"
安装后,如果有新版本可用,控制台代理会自动更新。
-
如果主机上设置了 http_proxy 或 https_proxy 系统变量,请将其删除:
unset http_proxy unset https_proxy如果不删除这些系统变量,安装将失败。
-
下载控制台代理软件,然后将其复制到 Linux 主机。您可以从NetApp Console或NetApp支持网站下载。
-
NetApp Console:转到 Agents > Management > Deploy agent > On-prem > Manual install。
选择下载代理安装程序文件或文件的 URL。
-
"NetApp 支持站点" (如果您还没有 Console 的访问权限,则需要此选项)。
下载适用于您的网络或云端的"在线"代理安装程序。Console 代理可使用单独的"脱机"安装程序,但它仅受专用模式部署支持。 -
NetApp 支持站点(如果您还没有 Console 的访问权限,则需要该站点) "NetApp 支持站点"。
-
-
分配运行脚本的权限。
chmod +x NetApp_Console_Agent_Cloud_<version>其中 <version> 是您下载的控制台代理的版本。
-
如果在政府云环境中安装,请禁用配置检查。"了解如何禁用手动安装的配置检查。"
-
运行安装脚本。
./NetApp_Console_Agent_Cloud_<version> --proxy <HTTP or HTTPS proxy server> --cacert <path and file name of a CA-signed certificate>如果您的网络需要代理才能访问互联网,则需要添加代理信息。您可以在安装过程中添加显式代理。
--proxy和--cacert参数是可选的,系统不会提示您添加它们。如果您有显式代理服务器,则需要输入如图所示的参数。如果要配置透明代理,可以在安装后进行此操作。"了解代理维护控制台". 以下是使用 CA 签名证书配置显式代理服务器的示例:
./NetApp_Console_Agent_Cloud_v4.0.0 --proxy https://user:password@10.0.0.30:8080/ --cacert /tmp/cacert/certificate.cer ./NetApp_Console_Agent_Cloud_v4.0.0 --proxy https://user:password@10.0.0.30:8080/ --cacert /tmp/cacert/certificate.cer--proxy使用以下格式之一将 Console 代理配置为使用 HTTP 或 HTTPS 代理服务器:-
http://地址:端口
-
http://用户名:密码@地址:端口
-
http://域名%92用户名:密码@地址:端口
-
https://地址:端口
-
https://用户名:密码@地址:端口
-
https://域名%92用户名:密码@地址:端口
请注意以下事项:
-
用户可以是本地用户或域用户。
-
对于域用户,您必须使用 \ 的 ASCII 代码,如上所示。
-
Console 代理不支持包含 @ 字符的用户名或密码。
-
如果密码包含以下任何特殊字符,则必须在该特殊字符前面加上反斜杠来转义该特殊字符:& 或 !
例如:
-
http://bxpproxyuser:netapp1\!@地址:3128
-
-
如果您使用 Podman,则需要调整 aardvark-dns 端口。
-
通过 SSH 连接到控制台代理虚拟机。
-
打开 podman /usr/share/containers/containers.conf 文件并修改 Aardvark DNS 服务的选定端口。例如,将其更改为54。
vi /usr/share/containers/containers.conf例如:
# Port to use for dns forwarding daemon with netavark in rootful bridge # mode and dns enabled. # Using an alternate port might be useful if other DNS services should # run on the machine. # dns_bind_port = 54-
重新启动控制台代理虚拟机。
-
控制台代理现已安装。安装结束时,如果您指定了代理服务器,控制台代理服务 (occm) 将重新启动两次。
设置NetApp Console。
第 6 步:设置 NetApp Console
首次访问控制台时,系统会提示您为控制台代理选择一个组织,并需要启用受限模式。
设置控制台代理的人员必须使用尚不属于控制台组织的登录名登录控制台。
如果您的登录信息与另一个组织关联,您需要注册一个新的登录信息。否则,您将在设置屏幕上看不到启用受限模式的选项。
-
从与控制台代理实例有连接的主机打开 Web 浏览器,然后输入您安装的控制台代理的以下 URL。
-
注册或登录NetApp Console。
-
登录后,设置控制台:
-
输入控制台代理的名称。
-
输入新控制台组织的名称。
-
选择*您是否在安全环境中运行?*
-
选择*在此帐户上启用受限模式*。
请注意,帐户创建后您无法更改此设置。您以后无法启用受限模式,也无法禁用它。
如果您在政府区域部署了控制台代理,则该复选框已启用且无法更改。这是因为限制模式是政府区域唯一支持的模式。
-
选择*让我们开始吧*。
-
控制台代理现已安装并设置到您的控制台组织。所有用户都需要使用控制台代理实例的 IP 地址访问控制台。
向控制台提供您之前设置的权限。
步骤 7:向控制台代理提供权限
如果您手动安装了 Console 代理,则需要授予之前设置的权限。
将您之前创建的 IAM 角色附加到安装了控制台代理的 EC2 实例。
仅当您在 AWS 中手动安装了控制台代理时,这些步骤才适用。对于 AWS Marketplace 部署,您已将控制台代理实例与包含所需权限的 IAM 角色关联。
-
转到 Amazon EC2 控制台。
-
选择*实例*。
-
选择控制台代理实例。
-
选择*操作 > 安全 > 修改 IAM 角色*。
-
选择 IAM 角色并选择 更新 IAM 角色。
向NetApp Console提供具有所需权限的 IAM 用户的 AWS 访问密钥。
-
选择“管理 > 凭证”。
-
选择*组织凭证*。
-
选择“添加凭据”并按照向导中的步骤操作。
-
凭证位置:选择*Amazon Web Services > 代理*。
-
定义凭证:输入 AWS 访问密钥和密钥。
-
市场订阅:通过立即订阅或选择现有订阅将市场订阅与这些凭证关联。
-
审核:确认有关新凭证的详细信息并选择*添加*。
-
转到 Azure 门户并将 Azure 自定义角色分配给一个或多个订阅的控制台代理虚拟机。
-
从 Azure 门户打开“订阅”服务并选择您的订阅。
从*订阅*服务分配角色很重要,因为这指定了订阅级别的角色分配范围。 _范围_定义了访问适用的资源集。如果您在不同级别(例如,虚拟机级别)指定范围,则您在NetApp Console内完成操作的能力将受到影响。
-
选择*访问控制 (IAM)* > 添加 > 添加角色分配。
-
在*角色*选项卡中,选择*控制台操作员*角色并选择*下一步*。
控制台操作员是策略中提供的默认名称。如果您为角色选择了不同的名称,则选择该名称。 -
在“成员”选项卡中,完成以下步骤:
-
分配对*托管身份*的访问权限。
-
选择“选择成员”,选择创建控制台代理虚拟机的订阅,在“托管标识”下,选择“虚拟机”,然后选择控制台代理虚拟机。
-
选择*选择*。
-
选择“下一步”。
-
选择*审阅+分配*。
-
如果要管理其他 Azure 订阅中的资源,请切换到该订阅,然后重复这些步骤。
-
向 NetApp Console 提供之前设置的 Azure 服务主体的凭据。
-
选择“管理 > 凭证”。
-
选择“添加凭据”并按照向导中的步骤操作。
-
凭证位置:选择*Microsoft Azure > 代理*。
-
定义凭据:输入有关授予所需权限的 Microsoft Entra 服务主体的信息:
-
应用程序(客户端)ID
-
目录(租户)ID
-
客户端密钥
-
-
市场订阅:通过立即订阅或选择现有订阅将市场订阅与这些凭证关联。
-
审核:确认有关新凭证的详细信息并选择*添加*。
-
NetApp Console 现在具有代表您在 Azure 中执行操作所需的权限。
将服务帐户与控制台代理 VM 关联。
-
转到 Google Cloud 门户并将服务帐户分配给控制台代理 VM 实例。
-
如果您想管理其他项目中的资源,请通过将具有控制台代理角色的服务帐户添加到该项目来授予访问权限。您需要对每个项目重复此步骤。