Skip to main content
Astra Control Service
所有雲端供應商
  • Amazon Web Services
  • Google Cloud
  • Microsoft Azure
  • 所有雲端供應商
本繁體中文版使用機器翻譯，譯文僅供參考，若與英文版本牴觸，應以英文版本為準。

啟用 Astra Control Provisioner

貢獻者
PDF

Astra Trident 版本 23.10 及更新版本包含使用 Astra Control Provisioner 的選項、可讓獲授權的 Astra Control 使用者存取進階儲存資源配置功能。Astra Control Provisioner 除了提供標準 Astra Trident CSI 型功能之外、還提供這項延伸功能。您可以使用此程序來啟用和安裝 Astra Control Provisioner 。

您的 Astra Control Service 訂閱會自動包含 Astra Control Provisioner 使用授權。

Astra Control 的更新將取代 Astra Trident 做為儲存資源配置程式和 Orchestrator 、並成為 Astra Control 使用的必要項目。因此、強烈建議 Astra Control 使用者啟用 Astra Control Provisioner 。Astra Trident 將繼續保持開放原始碼、並以 NetApp 的新 CSI 和其他功能來發行、維護、支援及更新。

如何知道我是否需要啟用 Astra Control Provisioner ？

如果您將叢集新增至先前未安裝 Astra Trident 的 Astra Control Service 、叢集將會標示為 Eligible。您先請 "將叢集新增至 Astra Control"、 Astra Control Provisioner 將自動啟用。

如果您的叢集未標記 Eligible`將會標示 `Partially eligible 因為下列其中一項原因：

  • 它使用的是舊版 Astra Trident

  • 它使用的 Astra Trident 23.10 尚未啟用置備程式選項

  • 這是一種不允許自動啟用的叢集類型

適用於 Partially eligible 案例中、請使用這些指示來手動為叢集啟用 Astra Control Provisioner 。

在新增叢集工作流程中描述叢集資格的螢幕擷取畫面

啟用 Astra Control Provisioner 之前

如果您現有的 Astra Trident 不含 Astra Control Provisioner 、而且想要啟用 Astra Control Provisioner 、請先執行下列步驟：

  • * 如果您已安裝 Astra Trident 、請確認其版本位於四個版本的視窗 * ：如果 Astra Trident 位於 24.02 版的四個版本視窗內、您可以使用 Astra Control Provisioner 直接升級至 Astra Trident 24.02 。例如、您可以直接從 Astra Trident 23.04 升級至 24.02 。

  • * 確認您的叢集具有 AMD64 系統架構 * ： Astra Control Provisioner 映像同時在 AMD64 和 ARM64 CPU 架構中提供、但 Astra Control 僅支援 AMD64 。

步驟

  1. 存取 NetApp Astra Control 影像登錄：

    1. 登入 Astra Control Service UI 並記錄 Astra Control 帳戶 ID 。

      1. 選取頁面右上角的圖示。

      2. 選擇* API存取*。

      3. 記下您的帳戶 ID 。

    2. 從同一頁面選取 * 產生 API 權杖 * 、然後將 API 權杖字串複製到剪貼簿、並將其儲存在編輯器中。

    3. 使用您偏好的方法登入 Astra Control 登錄：

      docker login cr.astra.netapp.io -u <account-id> -p <api-token>
      crane auth login cr.astra.netapp.io -u <account-id> -p <api-token>

  2. （僅限自訂登錄）請依照下列步驟將映像移至自訂登錄。如果您未使用登錄 , 請遵循中的 Trident 運算子步驟 下一節。

    註 您可以使用 Podman 而非 Docker 來執行下列命令。如果您使用的是 Windows 環境、建議您使用 PowerShell 。
    Docker

    1. 從登錄中拉出 Astra Control Provisioner 映像：

      註 所擷取的映像不支援多個平台、而且僅支援與擷取映像的主機相同的平台、例如 Linux AMD64 。 
      docker pull cr.astra.netapp.io/astra/trident-acp:24.02.0 --platform <cluster platform>

      範例：

      docker pull cr.astra.netapp.io/astra/trident-acp:24.02.0 --platform linux/amd64

    2. 標記影像：

      docker tag cr.astra.netapp.io/astra/trident-acp:24.02.0 <my_custom_registry>/trident-acp:24.02.0

    3. 將映像推送至自訂登錄：

      docker push <my_custom_registry>/trident-acp:24.02.0
    起重機

    1. 將 Astra Control Provisioner 資訊清單複製到您的自訂登錄：

      crane copy cr.astra.netapp.io/astra/trident-acp:24.02.0 <my_custom_registry>/trident-acp:24.02.0

  3. 判斷原始 Astra Trident 安裝方法是否使用。

  4. 使用您最初使用的安裝方法、在 Astra Trident 中啟用 Astra Control Provisioner ：

    Astra Trident 運算子

    1. "下載 Astra Trident 安裝程式並將其解壓縮"。

    2. 如果您尚未安裝 Astra Trident 、或是從原始 Astra Trident 部署中移除運算子、請完成下列步驟：

      1. 建立客戶需求日：

        kubectl create -f deploy/crds/trident.netapp.io_tridentorchestrators_crd_post1.16.yaml

      2. 建立 Trident 命名空間 (kubectl create namespace trident）或確認 Trident 命名空間仍然存在 (kubectl get all -n trident）。如果已移除命名空間、請重新建立。

    3. 將 Astra Trident 更新為 24.02.0 ：

      註 對於執行 Kubernetes 1.24 或更早版本的叢集、請使用 bundle_pre_1_25.yaml。對於執行 Kubernetes 1.25 或更新版本的叢集、請使用 bundle_post_1_25.yaml。 
      kubectl -n trident apply -f trident-installer/deploy/<bundle-name.yaml>

    4. 確認 Astra Trident 正在執行：

      kubectl get torc -n trident

      回應：

      NAME      AGE
trident   21m

    5. [[Pull 機密 ]] 如果您有使用機密的登錄、請建立秘密來拉出 Astra Control Provisioner 映像：

      kubectl create secret docker-registry <secret_name> -n trident --docker-server=<my_custom_registry> --docker-username=<username> --docker-password=<token>

    6. 編輯 TridentOrchestrator CR 並進行下列編輯：

      kubectl edit torc trident -n trident

      1. 為 Astra Trident 映像設定自訂登錄位置、或從 Astra Control 登錄中拉出 (tridentImage: <my_custom_registry>/trident:24.02.0 或 tridentImage: netapp/trident:24.02.0）。

      2. 啟用 Astra Control Provisioner (enableACP: true）。

      3. 設定 Astra Control Provisioner 映像的自訂登錄位置、或從 Astra Control 登錄中拉出映像 (acpImage: <my_custom_registry>/trident-acp:24.02.0 或 acpImage: cr.astra.netapp.io/astra/trident-acp:24.02.0）。

      4. 如果您已建立 影像拉出秘密 在本程序稍早的部分、您可以在此設定 (imagePullSecrets: - <secret_name>）。請使用您在先前步驟中建立的相同名稱密碼名稱。

      apiVersion: trident.netapp.io/v1
kind: TridentOrchestrator
metadata:
  name: trident
spec:
  debug: true
  namespace: trident
  tridentImage: <registry>/trident:24.02.0
  enableACP: true
  acpImage: <registry>/trident-acp:24.02.0
  imagePullSecrets:
  - <secret_name>

    7. 儲存並結束檔案。部署程序將會自動開始。

    8. 確認已建立運算子、部署和複本集。

      kubectl get all -n trident
      重要 Kubernetes叢集中只應有*一個運算子執行個體*。請勿建立 Astra Trident 運算子的多個部署。

    9. 驗證 trident-acp 容器正在執行 acpVersion 是 24.02.0 狀態為 Installed：

      kubectl get torc -o yaml

      回應：

      status:
  acpVersion: 24.02.0
  currentInstallationParams:
    ...
    acpImage: <registry>/trident-acp:24.02.0
    enableACP: "true"
    ...
  ...
  status: Installed
    試用

    1. "下載 Astra Trident 安裝程式並將其解壓縮"。

    2. "如果您有現有的 Astra Trident 、請將其從裝載它的叢集上解除安裝"。

    3. 在啟用 Astra Control Provisioner 的情況下安裝 Astra Trident (--enable-acp=true）：

      ./tridentctl -n trident install --enable-acp=true --acp-image=mycustomregistry/trident-acp:24.02

    4. 確認 Astra Control Provisioner 已啟用：

      ./tridentctl -n trident version

      回應：

      +----------------+----------------+-------------+ | SERVER VERSION | CLIENT VERSION | ACP VERSION | +----------------+----------------+-------------+ | 24.02.0 | 24.02.0 | 24.02.0. | +----------------+----------------+-------------+
    掌舵

    1. 如果您已安裝 Astra Trident 23.07.1 或更早版本、 "解除安裝" 操作員和其他元件。

    2. 如果 Kubernetes 叢集執行 1.24 或更早版本、請刪除 PSP ：

      kubectl delete psp tridentoperatorpod

    3. 新增Astra Trident Helm儲存庫：

      helm repo add netapp-trident https://netapp.github.io/trident-helm-chart

    4. 更新 Helm 圖表：

      helm repo update netapp-trident

      回應：

      Hang tight while we grab the latest from your chart repositories...
...Successfully got an update from the "netapp-trident" chart repository
Update Complete. ⎈Happy Helming!⎈

    5. 列出影像：

      ./tridentctl images -n trident

      回應：

      | v1.28.0            | netapp/trident:24.02.0|
|                    | docker.io/netapp/trident-autosupport:24.02|
|                    | registry.k8s.io/sig-storage/csi-provisioner:v4.0.0|
|                    | registry.k8s.io/sig-storage/csi-attacher:v4.5.0|
|                    | registry.k8s.io/sig-storage/csi-resizer:v1.9.3|
|                    | registry.k8s.io/sig-storage/csi-snapshotter:v6.3.3|
|                    | registry.k8s.io/sig-storage/csi-node-driver-registrar:v2.10.0 |
|                    | netapp/trident-operator:24.02.0 (optional)

    6. 確保 Trident 操作員 24.02.0 可用：

      helm search repo netapp-trident/trident-operator --versions

      回應：

      NAME                            CHART VERSION   APP VERSION     DESCRIPTION
netapp-trident/trident-operator 100.2402.0      24.02.0         A

    7. 使用 helm install 然後執行下列其中一個選項、其中包括這些設定：

      • 部署位置的名稱

      • Astra Trident 版本

      • Astra Control Provisioner 映像的名稱

      • 啟用資源配置程式的旗標

      • （選用）本機登錄路徑。如果您使用的是本機登錄 "Trident 影像" 可以位於一個登錄或不同的登錄中、但所有的SCSI映像都必須位於同一個登錄中。

      • Trident 命名空間

    選項

    • 沒有登錄的映像

    helm install trident netapp-trident/trident-operator --version 100.2402.0 --set acpImage=cr.astra.netapp.io/astra/trident-acp:24.02.0 --set enableACP=true --set operatorImage=netapp/trident-operator:24.02.0 --set tridentAutosupportImage=docker.io/netapp/trident-autosupport:24.02 --set tridentImage=netapp/trident:24.02.0 --namespace trident

    • 一個或多個登錄中的影像

    helm install trident netapp-trident/trident-operator --version 100.2402.0 --set acpImage=<your-registry>:<acp image> --set enableACP=true --set imageRegistry=<your-registry>/sig-storage --set operatorImage=netapp/trident-operator:24.02.0 --set tridentAutosupportImage=docker.io/netapp/trident-autosupport:24.02 --set tridentImage=netapp/trident:24.02.0 --namespace trident

    您可以使用 helm list 若要檢閱安裝詳細資料、例如名稱、命名空間、圖表、狀態、應用程式版本、和修訂編號。

    如果您在使用 Helm 部署 Trident 時遇到任何問題、請執行此命令以完全解除安裝 Astra Trident ：

./tridentctl uninstall -n trident
結果

Astra Control Provisioner 功能已啟用、您可以使用任何適用於所執行版本的功能。

安裝 Astra Control Provisioner 之後、在 Astra Control UI 中裝載置備程式的叢集將會顯示 ACP version 而非 Trident version 欄位和目前安裝的版本號碼。

在 UI 中描繪 ACP 版本位置的螢幕擷取畫面

以取得更多資訊