以受限模式手動部署 NetApp Console 代理程式
如果您要使用傳出連線受限的 NetApp Console,您需要手動以受限模式部署 Console 代理程式。
如果您不想使用市場訂閱或正在部署 Google Cloud,則需要手動安裝 Console 代理程式。
步驟 1:準備雲端權限
在安裝 Console 代理程式之前,請準備其管理資源所需的雲端供應商權限。
步驟 2:啟用 Google Cloud API(僅限 Google Cloud)
如果您要在 Google Cloud 中安裝 Console 代理程式,請在安裝前在專案中啟用所需的 API。這些 API 是 Cloud Volumes ONTAP 特定功能所必需的。
-
-
Cloud Build API (使用 Infrastructure Manager 進行私有模式 Cloud Volumes ONTAP 部署所需)
-
雲端部署管理器 V2 API
-
雲端基礎架構管理器 API
-
雲端日誌 API
-
雲端資源管理器 API
-
計算引擎 API
-
身分識別和存取管理 (IAM) API
-
雲端金鑰管理服務(KMS)API(僅當您打算使用 NetApp Backup and Recovery 搭配客戶管理的加密金鑰(CMEK)時才需要)
-
Cloud Quotas API(使用 Infrastructure Manager 部署 Cloud Volumes ONTAP 時需要)
-
步驟 3:準備網路存取
允許安裝 Console 代理程式的雲端供應商所需的傳出端點。
雲端供應商端點
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 支援、Console 功能,以及 Console 代理程式部署與升級。
| 端點 | 目的 |
|---|---|
取得授權資訊並將 AutoSupport 訊息傳送至 NetApp 支援部門。 |
|
更新NetApp支援網站 (NSS) 憑證或將新的 NSS 憑證新增至NetApp Console。 |
|
以取得授權資訊並將 AutoSupport 訊息傳送至 NetApp 支援,以及接收 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 系統關聯,請考慮增加與該代理程式關聯的執行緒數量以提高效能。"了解如何增加代理程式的 Container 執行緒限制"。
依照 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 權限。
-
如果控制台代理需要代理才能存取互聯網,則提供有關代理伺服器的詳細資訊。
安裝後您可以選擇設定 Proxy 伺服器,但這樣做需要重新啟動 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。
選擇下載 agent 安裝程式檔案或檔案的 URL。
-
"NetApp支援站點"(如果您還沒有存取 NetApp Console 的權限,則需要此步驟)。
下載適用於網路或雲端的「線上」代理安裝程式。NetApp 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 簽署憑證設定明確 Proxy 伺服器的範例:
./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 Proxy 伺服器:-
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 代理程式
如果您手動安裝 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 執行個體。
-
如果您想管理其他專案中的資源,請透過將具有控制台代理角色的服務帳戶新增至該專案來授予存取權限。您需要對每個項目重複此步驟。