Skip to main content
日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

Astra Control Provisionerを有効にする

共同作成者

Astra Tridentバージョン23.10以降には、Astra Control Provisionerを使用するオプションが用意されています。このオプションを使用すると、ライセンスを取得したAstra Controlユーザは、高度なストレージプロビジョニング機能にアクセスできます。Astra Control Provisionerは、Astra Trident CSIベースの標準機能に加えて、この拡張機能を提供します。

今後のAstra Controlの更新では、Astra Control ProvisionerがAstra Tridentの代わりにストレージプロビジョニングツールおよびオーケストレータとして使用され、Astra Controlでは必須となります。そのため、Astra ControlのユーザはAstra Control Provisionerを有効にすることを強く推奨します。Astra Tridentは引き続きオープンソースであり、NetAppの新しいCSIやその他の機能でリリース、メンテナンス、サポート、更新されます。

このタスクについて

Astra Control Centerのライセンスを取得していて、Astra Control Provisioner機能を使用する場合は、この手順に従う必要があります。また、Astra Tridentを使用していて、Astra Control Provisionerが提供する追加機能をAstra Controlを使用せずに使用する場合も、この手順に従う必要があります。

どちらの場合も、Astra Trident 24.02ではプロビジョニングツール機能はデフォルトでは有効になっていないため、有効にする必要があります。

作業を開始する前に

Astra Control Provisionerを有効にする場合は、まず次の手順を実行します。

Astra ControlプロビジョニングツールユーザとAstra Control Center

  • * Astra Control Centerライセンスの取得*： "Astra Control Centerのライセンス" Astra Control Provisionerを有効にし、提供される機能にアクセスするため。

  • * Astra Control Center 23.10以降をインストールまたはアップグレード*：Astra Control Provisionerの最新機能（24.02）をAstra Controlで使用する場合は、最新のAstra Control Centerバージョン（24.02）が必要です。

  • クラスタにAMD64システムアーキテクチャがあることを確認する：Astra Control ProvisionerイメージはAMD64とARM64の両方のCPUアーキテクチャで提供されますが、Astra Control CenterでサポートされるのはAMD64のみです。

  • レジストリアクセス用のAstra Controlサービスアカウントを取得：NetApp Support SiteではなくAstra Controlレジストリを使用してAstra Control Provisionerイメージをダウンロードする場合は、 "Astra Controlサービスのアカウント"。フォームに必要事項を入力して送信し、BlueXPアカウントを作成すると、Astra Control ServiceのようこそEメールが届きます。

  • * Astra Tridentがインストールされている場合は、バージョンが4リリース期間内であることを確認してください*：Astra Tridentがバージョン24.02の4リリース期間内であれば、Astra Control Provisionerを使用してAstra Trident 24.02への直接アップグレードを実行できます。たとえば、Astra Trident 23.04から24.02に直接アップグレードできます。

Astra Control Provisionerのみユーザ

  • * Astra Control Centerライセンスの取得*： "Astra Control Centerのライセンス" Astra Control Provisionerを有効にし、提供される機能にアクセスするため。

  • * Astra Tridentがインストールされている場合は、バージョンが4リリース期間内であることを確認してください*：Astra Tridentがバージョン24.02の4リリース期間内であれば、Astra Control Provisionerを使用してAstra Trident 24.02への直接アップグレードを実行できます。たとえば、Astra Trident 23.04から24.02に直接アップグレードできます。

  • レジストリアクセス用のAstra Controlサービスアカウントを取得：Astra Control Provisionerイメージをダウンロードするには、レジストリへのアクセスが必要です。使用を開始するには、 "Astra Controlサービスのアカウント"。フォームに必要事項を入力して送信し、BlueXPアカウントを作成すると、Astra Control ServiceのようこそEメールが届きます。

（手順1）Astra Control Provisionerの画像を取得

Astra Control Centerのユーザは、Astra ControlのレジストリまたはNetApp Support Siteメソッドを使用してAstra Control Provisionerイメージを取得できます。Astra Controlを使用せずにAstra Control Provisionerを使用する場合は、レジストリ方式を使用する必要があります。

Astra Controlイメージレジストリ
メモ この手順のコマンドには、Dockerの代わりにPodmanを使用できます。Windows環境を使用している場合は、PowerShellを推奨します。

  1. NetApp Astra Controlイメージのレジストリにアクセスします。

    1. Astra Control Service Web UIにログオンし、ページの右上にある図アイコンを選択します。

    2. [API access*]を選択します。

    3. アカウントIDを書き留めます。

    4. 同じページから* APIトークンの生成*を選択し、APIトークン文字列をクリップボードにコピーしてエディターに保存します。

    5. 任意の方法で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. (カスタムレジストリのみ)イメージをカスタムレジストリに移動するには、次の手順に従います。レジストリを使用していない場合は、 "次のセクション"。

    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

    1. 画像にタグを付けます。

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

    2. イメージをカスタムレジストリにプッシュします。

      docker push <my_custom_registry>/trident-acp:24.02.0
メモ 次のDockerコマンドを実行する代わりに、クレーンコピーを使用できます。
crane copy cr.astra.netapp.io/astra/trident-acp:24.02.0 <my_custom_registry>/trident-acp:24.02.0
NetApp Support Site

  1. Astra Control Provisionerバンドルをダウンロード (trident-acp-[version].tar）をクリックします "Astra Control Centerのダウンロードページ"。

  2. （推奨、ただしオプション）Astra Control Centerの証明書とシグネチャバンドル（astra-control-center-certs-[version].tar.gz）をダウンロードして、trident-acp-[version] tarバンドルのシグネチャを確認します。

    tar -vxzf astra-control-center-certs-[version].tar.gz
    openssl dgst -sha256 -verify certs/AstraControlCenterDockerImages-public.pub -signature certs/trident-acp-[version].tar.sig trident-acp-[version].tar

  3. Astra Control Provisionerのイメージをロードします。

    docker load < trident-acp-24.02.0.tar

    対応：

    Loaded image: trident-acp:24.02.0-linux-amd64

  4. 画像にタグを付けます。

    docker tag trident-acp:24.02.0-linux-amd64 <my_custom_registry>/trident-acp:24.02.0

  5. イメージをカスタムレジストリにプッシュします。

    docker push <my_custom_registry>/trident-acp:24.02.0

（ステップ2）Astra TridentでAstra Control Provisionerを有効にする

元のインストール方法で "オペレータ（手動またはHelmを使用）またはtridentctl" そして、元の方法に従って適切な手順を完了します。

Astra Trident運用者

  1. "Astra Tridentインストーラをダウンロードして展開"。

  2. Astra Tridentをまだインストールしていない場合、または元のAstra Trident環境からオペレータを削除した場合は、次の手順を実行します。

    1. CRDを作成します。

      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-secrets]]シークレットを使用するレジストリがある場合は、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. operator、deployment、およびReplicaSetsが作成されていることを確認します。

    kubectl get all -n trident
    重要 Kubernetes クラスタには、オペレータのインスタンスが * 1 つしか存在しないようにしてください。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
Tridentctl

  1. "Astra Tridentインストーラをダウンロードして展開"。

  2. "既存のAstra Tridentがある場合は、その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. | +----------------+----------------+-------------+
Helm

  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-operator 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の画像" 1つのレジストリまたは別のレジストリに配置できますが、すべてのCSIイメージは同じレジストリに配置する必要があります。

    • Tridentネームスペース

オプション（ Options ）

  • レジストリなしのイメージ

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

  • 1つまたは複数のレジストリ内の画像

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 TridentのCRDを完全に削除" Astra Control Provisionerを再度有効にする前に、アンインストールの一環として実行します。

結果

Astra Control Provisionerの機能が有効になっており、実行しているバージョンで使用可能なすべての機能を使用できます。

（Astra Control Centerユーザのみ）Astra Control Provisionerをインストールすると、Astra Control Center UIでプロビジョニングツールをホストしているクラスタに ACP version 代わりに Trident version フィールドと現在インストールされているバージョン番号。

Astra Control Provisionerのバージョンを示すUIのスクリーンショット

を参照してください。