本繁體中文版使用機器翻譯，譯文僅供參考，若與英文版本牴觸，應以英文版本為準。

在 Azure 中手動安裝 Connector

10/25/2024 貢獻者

Connector 是在雲端網路或內部部署網路中執行的 NetApp 軟體、可讓您使用所有 BlueXP 功能和服務。其中一個可用的安裝選項是在 Azure 中執行的 Linux 主機上手動安裝 Connector 軟體。若要在您自己的 Linux 主機上手動安裝 Connector 、您必須檢閱主機需求、設定網路、準備 Azure 權限、安裝 Connector 、然後提供您準備的權限。

開始之前

您應該擁有 "瞭解連接器".
您應該檢閱 "連接器限制"。

步驟 1 ：檢閱主機需求

Connector 軟體必須在符合特定作業系統需求、 RAM 需求、連接埠需求等的主機上執行。

專用主機

與其他應用程式共用的主機不支援 Connector 。主機必須是專屬主機。

Hypervisor

需要經過認證可執行支援作業系統的裸機或託管 Hypervisor 。

作業系統與容器需求

在標準模式或受限模式下使用 BlueXP 時、 BlueXP 支援連接器搭配下列作業系統。安裝 Connector 之前、需要使用容器協調工具。

作業系統	支援 OS 的支援版本	支援的 Connector 版本	必要的容器工具	SELinux
Red Hat Enterprise Linux	9.1 至 9.4 8.6 至 8.10	3.9.40 或更新版本、 BlueXP 為標準模式或受限模式	Podman 4.6.1 或 4.9.4 版檢視 Podman 組態需求。	在強制模式或允許模式 ¹ 中支援
Ubuntu	24.04 LTS	3.9.45 或更新版本、 BlueXP 為標準模式或受限模式	Docker Engine 26.0.0	不支援

作業系統

支援 OS 的支援版本

支援的 Connector 版本

必要的容器工具

SELinux

Red Hat Enterprise Linux

9.1 至 9.4

8.6 至 8.10

3.9.40 或更新版本、 BlueXP 為標準模式或受限模式

Podman 4.6.1 或 4.9.4 版

檢視 Podman 組態需求。

在強制模式或允許模式 ¹ 中支援

Ubuntu

24.04 LTS

3.9.45 或更新版本、 BlueXP 為標準模式或受限模式

Docker Engine 26.0.0

不支援

附註：

在作業系統上啟用 SELinux 的 Connectors 不支援 Cloud Volumes ONTAP 系統的管理。
這些作業系統的英文版本支援 Connector 。
對於 RHEL 、主機必須向 Red Hat Subscription Management 登錄。如果主機尚未登錄、則無法在 Connector 安裝期間存取儲存庫來更新所需的協力廠商軟體。

CPU

8 個核心或 8 個 vCPU

RAM

32GB

Azure VM 大小

符合上述 CPU 和 RAM 需求的執行個體類型。我們建議您使用 Standard_D8s_v3 。

/opt 中的磁碟空間

必須有100 GiB的可用空間

BlueXP 使用 `/opt`安裝 `/opt/application/netapp`目錄及其內容。

/var.中的磁碟空間

必須提供20 GiB的空間

BlueXP 需要此空間 /var 因為 Docker 或 Podman 是專為在此目錄中建立容器而設計。具體而言、他們會在中建立容器 /var/lib/containers/storage 目錄。外部掛載或 symlinks 無法用於此空間。

步驟 2 ：安裝 Podman 或 Docker Engine

根據您的作業系統而定、安裝 Connector 之前需要使用 Podman 或 Docker Engine 。

Red Hat Enterprise Linux 8 和 9 需要 Podman 。

檢視 BlueXP 支援的 Podman 版本。
Ubuntu 需要 Docker Engine 。

檢視 BlueXP 支援的 Docker Engine 版本。

範例 1. 步驟

Podman

請依照下列步驟安裝 Podman 、並將其設定為符合下列需求：

必須啟用並啟動 podman.socket 服務
必須安裝 python3
必須安裝 podman-compose 套件 1.0.6 版
必須將 podman-compose 新增至 PATH 環境變數

步驟

如果主機上已安裝 podman-泊塢視窗套件、請將其移除。
```
dnf remove podman-docker
rm /var/run/docker.sock
```
安裝 Podman 。

Podman 可從官方 Red Hat Enterprise Linux 儲存庫取得。

對於 Red Hat Enterprise Linux 9 ：
```
sudo dnf install podman-2:<version>
```
其中 <version> 是您正在安裝的 Podman 支援版本。檢視 BlueXP 支援的 Podman 版本。

對於 Red Hat Enterprise Linux 8 ：
```
sudo dnf install podman-3:<version>
```
其中 <version> 是您正在安裝的 Podman 支援版本。檢視 BlueXP 支援的 Podman 版本。

啟用並啟動 podman.socket 服務。

sudo systemctl enable --now podman.socket

安裝 python3 。
```
sudo dnf install python3
```
如果您的系統上尚未提供 EPEL 儲存庫套件、請加以安裝。

這是必要步驟、因為 podman-compose 可從 Enterprise Linux （ EPEL ）儲存庫取得。

對於 Red Hat Enterprise Linux 9 ：
```
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
```
對於 Red Hat Enterprise Linux 8 ：
```
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 主機上的選項。

Docker引擎

請遵循 Docker 的文件來安裝 Docker Engine 。

步驟

"檢視 Docker 的安裝指示"

請務必依照步驟安裝 Docker Engine 的特定版本。安裝最新版本將會安裝 BlueXP 不支援的 Docker 版本。

確認 Docker 已啟用且正在執行。

sudo systemctl enable docker && sudo systemctl start docker

步驟 3 ：設定網路

請確定您計畫安裝 Connector 的網路位置支援下列需求。滿足這些需求後、 Connector 便能在混合雲環境中管理資源和程序。

Azure地區

如果您使用 Cloud Volumes ONTAP 、 Connector 應部署在與其管理的 Cloud Volumes ONTAP 系統所在的同一個 Azure 區域、或部署在中 "Azure區域配對" 適用於整個系統。Cloud Volumes ONTAP這項需求可確保Cloud Volumes ONTAP Azure Private Link連線可用於連接至相關的儲存帳戶。

"瞭Cloud Volumes ONTAP 解如何使用Azure Private Link"

連線至目標網路

Connector 需要網路連線、才能連線到您計畫建立和管理工作環境的位置。例如、您計畫在內部部署環境中建立 Cloud Volumes ONTAP 系統或儲存系統的網路。

傳出網際網路存取

您部署 Connector 的網路位置必須具有傳出網際網路連線、才能連絡特定端點。

使用 BlueXP 網路型主控台時、從電腦連絡的端點

從網頁瀏覽器存取 BlueXP 主控台的電腦必須能夠連絡多個端點。您需要使用 BlueXP 主控台來設定連接器、並用於 BlueXP 的日常使用。

"為 BlueXP 主控台準備網路"。

手動安裝期間聯絡的端點

當您在自己的 Linux 主機上手動安裝 Connector 時、 Connector 的安裝程式需要在安裝過程中存取下列 URL ：

https://support.netapp.com
https://mysupport.netapp.com
https://signin.b2c 。 NetApp ． com （此端點為 https://mysupport ． NetApp ． com 的 CNAME URL ）
https://cloudmanager.cloud.netapp.com/tenancy
https://stream.cloudmanager.cloud.netapp.com
https://production-artifacts.cloudmanager.cloud.netapp.com
https://*.blob.core.windows.net
https://cloudmanagerinfraprod.azurecr.io

主機可能會在安裝期間嘗試更新作業系統套件。主機可聯絡不同的鏡射站台、以取得這些 OS 套件。

已從 Connector 聯絡的端點

Connector 需要外傳網際網路存取才能連絡下列端點、以便管理公有雲環境中的資源和程序、以進行日常營運。

請注意、下列端點均為所有的 CNAME 項目。

端點	目的
https://management.azure.com https://login.microsoftonline.com https://blob.core.windows.net https://core.windows.net	管理Azure公共區域的資源。
https://management.chinacloudapi.cn https://login.chinacloudapi.cn https://blob.core.chinacloudapi.cn https://core.chinacloudapi.cn	管理Azure中國地區的資源。
https://support.netapp.com https://mysupport.netapp.com	以取得授權資訊、並將AutoSupport 資訊傳送給NetApp支援部門。
https://.api.bluexp.netapp.com https://api.bluexp.netapp.com https://.cloudmanager.cloud.netapp.com https://cloudmanager.cloud.netapp.com https://netapp-cloud-account.auth0.com	在BlueXP中提供SaaS功能與服務。請注意、 Connector 目前正在聯絡「 cloudmanager.cloud.netapp.com" 」、但在即將推出的版本中、會開始聯絡「 api.bluexp.netapp.com" 」。
https://*.blob.core.windows.net https://cloudmanagerinfraprod.azurecr.io	升級Connector及其Docker元件。

端點

目的

https://management.azure.com
https://login.microsoftonline.com
https://blob.core.windows.net
https://core.windows.net

管理Azure公共區域的資源。

https://management.chinacloudapi.cn
https://login.chinacloudapi.cn
https://blob.core.chinacloudapi.cn
https://core.chinacloudapi.cn

管理Azure中國地區的資源。

https://support.netapp.com
https://mysupport.netapp.com

以取得授權資訊、並將AutoSupport 資訊傳送給NetApp支援部門。

https://*.api.bluexp.netapp.com

https://api.bluexp.netapp.com

https://*.cloudmanager.cloud.netapp.com

https://cloudmanager.cloud.netapp.com

https://netapp-cloud-account.auth0.com

在BlueXP中提供SaaS功能與服務。

請注意、 Connector 目前正在聯絡「 cloudmanager.cloud.netapp.com" 」、但在即將推出的版本中、會開始聯絡「 api.bluexp.netapp.com" 」。

https://*.blob.core.windows.net

https://cloudmanagerinfraprod.azurecr.io

升級Connector及其Docker元件。

Proxy伺服器

如果您的企業需要為所有傳出的網際網路流量部署 Proxy 伺服器、請取得下列關於 HTTP 或 HTTPS Proxy 的資訊。您必須在安裝期間提供此資訊。請注意、 BlueXP 不支援透明 Proxy 伺服器。

IP 位址
認證資料
HTTPS憑證

連接埠

除非您啟動連接器、或使用連接器做為 Proxy 、將 AutoSupport 訊息從 Cloud Volumes ONTAP 傳送至 NetApp 支援、否則不會有傳入的流量傳入連接器。

HTTP（80）和HTTPS（443）可存取本機UI、在極少數情況下使用。
只有在需要連線至主機進行疑難排解時、才需要SSH（22）。
如果您在無法使用輸出網際網路連線的子網路中部署 Cloud Volumes ONTAP 系統、則需要透過連接埠 3128 進行輸入連線。

如果 Cloud Volumes ONTAP 系統沒有輸出網際網路連線來傳送 AutoSupport 訊息、 BlueXP 會自動將這些系統設定為使用 Connector 隨附的 Proxy 伺服器。唯一的需求是確保連接器的安全群組允許透過連接埠3128進行傳入連線。部署Connector之後、您需要開啟此連接埠。

啟用 NTP

如果您打算使用 BlueXP 分類來掃描公司資料來源、則應該在 BlueXP Connector 系統和 BlueXP 分類系統上啟用網路時間傳輸協定（ NTP ）服務、以便在系統之間同步時間。 "深入瞭解 BlueXP 分類"

步驟 4 ：設定權限

您必須使用下列其中一個選項、提供 Azure BlueXP 權限：

選項 1 ：使用系統指派的託管身分識別、將自訂角色指派給 Azure VM 。
選項 2 ：為 BlueXP 提供具有必要權限的 Azure 服務主體認證。

請依照步驟準備 BlueXP 的權限。

自訂角色

請注意、您可以使用 Azure 入口網站、 Azure PowerShell 、 Azure CLI 或 REST API 來建立 Azure 自訂角色。下列步驟說明如何使用 Azure CLI 建立角色。如果您想要使用不同的方法、請參閱 "Azure文件"

步驟

如果您打算在自己的主機上手動安裝軟體、請在 VM 上啟用系統指派的託管身分識別、以便透過自訂角色提供必要的 Azure 權限。

"Microsoft Azure 文件：使用 Azure 入口網站、在 VM 上設定 Azure 資源的託管身分識別"
複製的內容 "Connector的自訂角色權限" 並將它們儲存在Json檔案中。

將 Azure 訂閱 ID 新增至可指派的範圍、以修改 Json 檔案。

您應該為每個想要搭配 BlueXP 使用的 Azure 訂閱新增 ID 。

範例 *

"AssignableScopes": [
"/subscriptions/d333af45-0d07-4154-943d-c25fbzzzzzzz",
"/subscriptions/54b91999-b3e6-4599-908e-416e0zzzzzzz",
"/subscriptions/398e471c-3b42-4ae7-9b59-ce5bbzzzzzzz"

使用 Json 檔案在 Azure 中建立自訂角色。

下列步驟說明如何在Azure Cloud Shell中使用Bash建立角色。
1. 開始 "Azure Cloud Shell" 並選擇Bash環境。
2. 上傳Json檔案。
3. 使用Azure CLI建立自訂角色：
  az role definition create --role-definition Connector_Policy.json

結果

現在您應該有一個名為BlueXP運算子的自訂角色、可以指派給連接器虛擬機器。

服務主體

在 Microsoft Entra ID 中建立並設定服務主體、並取得 BlueXP 所需的 Azure 認證。

建立 Microsoft Entra 應用程式以進行角色型存取控制

確保您在 Azure 中擁有建立 Active Directory 應用程式及將應用程式指派給角色的權限。

如需詳細資訊、請參閱 "Microsoft Azure 說明文件：必要權限"
從 Azure 入口網站開啟 * Microsoft Entra ID* 服務。
在功能表中、選取 * 應用程式註冊 * 。
選取 * 新登錄 * 。
指定應用程式的詳細資料：
- * 名稱 * ：輸入應用程式的名稱。
- 帳戶類型：選取帳戶類型（任何帳戶類型均可用於BlueXP）。
- 重新導向URI：您可以將此欄位保留空白。
選擇*註冊*。

您已建立 AD 應用程式和服務主體。

將應用程式指派給角色

建立自訂角色：

請注意、您可以使用 Azure 入口網站、 Azure PowerShell 、 Azure CLI 或 REST API 來建立 Azure 自訂角色。下列步驟說明如何使用 Azure CLI 建立角色。如果您想要使用不同的方法、請參閱 "Azure文件"
1. 複製的內容 "Connector的自訂角色權限" 並將它們儲存在Json檔案中。
2. 將 Azure 訂閱 ID 新增至可指派的範圍、以修改 Json 檔案。
  
  您應該為使用者建立 Cloud Volumes ONTAP 的各個 Azure 訂閱新增 ID 。
  - 範例 *
  "AssignableScopes": [ "/subscriptions/d333af45-0d07-4154-943d-c25fbzzzzzzz", "/subscriptions/54b91999-b3e6-4599-908e-416e0zzzzzzz", "/subscriptions/398e471c-3b42-4ae7-9b59-ce5bbzzzzzzz"
3. 使用 Json 檔案在 Azure 中建立自訂角色。
  
  下列步驟說明如何在Azure Cloud Shell中使用Bash建立角色。
  - 開始 "Azure Cloud Shell" 並選擇Bash環境。
  - 上傳Json檔案。
  - 使用Azure CLI建立自訂角色：
    
    az role definition create --role-definition Connector_Policy.json
    
    現在您應該有一個名為BlueXP運算子的自訂角色、可以指派給連接器虛擬機器。
將應用程式指派給角色：
1. 從 Azure 入口網站開啟 * 訂閱 * 服務。
2. 選取訂閱。
3. 選取 * 存取控制（ IAM ） > 新增 > 新增角色指派 * 。
4. 在 * 角色 * 索引標籤中、選取 * BlueXP 操作員 * 角色、然後選取 * 下一步 * 。
5. 在「成員」索引標籤中、完成下列步驟：
  - 保留*選取「使用者」、「群組」或「服務主體」*。
  - 選取 * 選取成員 * 。
  - 搜尋應用程式名稱。
    
    範例如下：
  - 選取應用程式、然後選取 * 選取 * 。
  - 選擇*下一步*。
6. 選取 * 檢閱 + 指派 * 。
  
  服務主體現在擁有部署Connector所需的Azure權限。
如果您想要從 Cloud Volumes ONTAP 多個 Azure 訂閱中部署支援功能、則必須將服務授權對象繫結至每個訂閱項目。BlueXP可讓您選擇部署Cloud Volumes ONTAP 時要使用的訂閱內容。

新增 Windows Azure Service Management API 權限

在 * Microsoft Entra ID* 服務中、選取 * 應用程式登錄 * 、然後選取應用程式。
選取 * API 權限 > 新增權限 * 。
在「 * Microsoft API* 」下、選取「 * Azure 服務管理 * 」。
選取 * 以組織使用者身分存取 Azure 服務管理 * 、然後選取 * 新增權限 * 。

取得應用程式的應用程式 ID 和目錄 ID

在 * Microsoft Entra ID* 服務中、選取 * 應用程式登錄 * 、然後選取應用程式。
複製 * 應用程式（用戶端） ID* 和 * 目錄（租戶） ID* 。

將Azure帳戶新增至BlueXP時、您必須提供應用程式的應用程式（用戶端）ID和目錄（租戶）ID。BlueXP使用ID以程式設計方式登入。

建立用戶端機密

開啟 * Microsoft Entra ID* 服務。
選取 * 應用程式註冊 * 、然後選取您的應用程式。
選取 * 「憑證與機密」 > 「新用戶端機密」 * 。
提供機密與持續時間的說明。
選取*「Add*」。
複製用戶端機密的值。

您現在擁有一個客戶機密、 BlueXP 可以使用它來驗證 Microsoft Entra ID 。

結果

您的服務主體現在已設定完成、您應該已經複製應用程式（用戶端） ID 、目錄（租戶） ID 、以及用戶端機密的值。新增Azure帳戶時、您必須在BlueXP中輸入此資訊。

步驟 5 ：安裝 Connector

完成先決條件後、您可以在自己的 Linux 主機上手動安裝軟體。

開始之前

您應該擁有下列項目：

安裝Connector的root權限。
Proxy伺服器的詳細資料、如果需要Proxy才能從Connector存取網際網路。

您可以選擇在安裝後設定Proxy伺服器、但需要重新啟動Connector。

請注意、 BlueXP 不支援透明 Proxy 伺服器。
CA 簽署的憑證（如果 Proxy 伺服器使用 HTTPS 或 Proxy 是攔截 Proxy ）。
Azure 中 VM 上啟用的託管身分識別、可讓您透過自訂角色提供所需的 Azure 權限。

"Microsoft Azure 文件：使用 Azure 入口網站、在 VM 上設定 Azure 資源的託管身分識別"

關於這項工作

NetApp 支援網站上提供的安裝程式可能是舊版。安裝後、如果有新版本可用、 Connector 會自動自行更新。

步驟

如果主機上已設定_http或_https或proxy_系統變數、請將其移除：
```
unset http_proxy
unset https_proxy
```
如果您未移除這些系統變數、安裝將會失敗。
從下載Connector軟體 "NetApp 支援網站"，然後將其複製到 Linux 主機。

您應該下載「線上」 Connector 安裝程式、以供您的網路或雲端使用。Connector 有獨立的「離線」安裝程式、但僅支援私有模式部署。
指派執行指令碼的權限。
```
chmod +x BlueXP-Connector-Cloud-<version>
```
其中、就是您下載的Connector版本<version> 。
執行安裝指令碼。
```
 ./BlueXP-Connector-Cloud-<version> --proxy <HTTP or HTTPS proxy server> --cacert <path and file name of a CA-signed certificate>
```
-Proxy和—cacert參數是可選的。如果您有 Proxy 伺服器、則需要輸入如圖所示的參數。安裝程式不會提示您提供Proxy的相關資訊。

以下是使用兩個選用參數的命令範例：
```
 ./BlueXP-Connector-Cloud-v3.9.40--proxy https://user:password@10.0.0.30:8080/ --cacert /tmp/cacert/certificate.cer
```
-Proxy會使用下列其中一種格式、將Connector設定為使用HTTP或HTTPS Proxy伺服器：
- http://address:port
- http://user-name:password@address:port
- http://domain-name%92user-name:password@address:port
- https://address:port
- https://user-name:password@address:port
- https://domain-name%92user-name:password@address:port
  
  請注意下列事項：
  - 使用者可以是本機使用者或網域使用者。
  - 對於網域使用者、您必須使用上方所示的 \ 的 ASCII 碼。
  - BlueXP 不支援包含 @ 字元的使用者名稱或密碼。
  - 如果密碼包含下列任何特殊字元、您必須以反斜線開頭來轉義該特殊字元： & 或 !
    
    例如：
  http://bxpproxyuser:netapp1\!@address:3128
-cacert指定用於連接器與Proxy伺服器之間HTTPS存取的CA簽署憑證。只有當您指定 HTTPS Proxy 伺服器或 Proxy 是攔截 Proxy 時、才需要此參數。
等待安裝完成。

安裝結束時、如果您指定Proxy伺服器、Connector服務（occm）會重新啟動兩次。
從連線至 Connector 虛擬機器的主機開啟網頁瀏覽器、然後輸入下列 URL ：

https://ipaddress
登入後、設定 Connector ：
1. 指定要與連接器關聯的 BlueXP 組織。
2. 輸入系統名稱。
3. 在 * 您是在安全的環境中執行？ * 保持停用限制模式。
  
  您應該保持停用受限模式、因為這些步驟說明如何在標準模式中使用 BlueXP 。只有當您擁有安全的環境、而且想要中斷此帳戶與 BlueXP 後端服務的連線時、才應啟用受限模式。如果是這樣、 "請依照步驟、以受限模式開始使用 BlueXP"。
4. 選取 * 開始 * 。

結果

現在已安裝 Connector 、並已與您的 BlueXP 組織一起設定。

如果您在建立 Connector 的同一個 Azure 訂閱中擁有 Azure Blob 儲存設備、則會在 BlueXP 畫布上自動顯示 Azure Blob 儲存設備工作環境。 "瞭解如何從 BlueXP 管理 Azure Blob 儲存設備"

步驟 6 ：提供 BlueXP 的權限

安裝 Connector 之後、您必須提供 BlueXP 先前設定的 Azure 權限。提供權限可讓 BlueXP 管理 Azure 中的資料和儲存基礎架構。

自訂角色

前往 Azure 入口網站、將 Azure 自訂角色指派給 Connector 虛擬機器、以進行一或多個訂閱。

步驟

從 Azure Portal 開啟 * Subscriptions * 服務、然後選取您的訂閱。

請務必從 * 訂閱 * 服務指派角色、因為這會指定訂閱層級的角色指派範圍。scacity 定義存取所套用的資源集。如果您在不同層級（例如虛擬機器層級）指定範圍、則從 BlueXP 中完成動作的能力將受到影響。

"Microsoft Azure 文件：瞭解 Azure RBAC 的範圍"
選取 * 存取控制（ IAM ） * > * 新增 * > * 新增角色指派 * 。
在 * 角色 * 索引標籤中、選取 * BlueXP 操作員 * 角色、然後選取 * 下一步 * 。

BlueXP運算子是在BlueXP原則中提供的預設名稱。如果您為角色選擇不同的名稱、請改為選取該名稱。
在「成員」索引標籤中、完成下列步驟：
1. 指派*託管身分識別*的存取權。
2. 選取 * 選取成員 * 、選取建立 Connector 虛擬機器的訂閱、然後在 * 管理身分識別 * 下選擇 * 虛擬機器 * 、然後選取 Connector 虛擬機器。
3. 選取 * 選取 * 。
4. 選擇*下一步*。
5. 選取 * 檢閱 + 指派 * 。
6. 如果您想要在其他 Azure 訂閱中管理資源、請切換至該訂閱、然後重複這些步驟。

結果

BlueXP 現在擁有代表您在 Azure 中執行動作所需的權限。

接下來呢？

前往 "BlueXP主控台" 開始使用Connector with BlueXP。