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

Astra Control Provisionerを有効にする

03/27/2024 共同作成者

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 Control ProvisionerがAstra Tridentの代わりにストレージプロビジョニングツールおよびオーケストレータとして使用され、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を使用している
Provisionerオプションが有効になっていないAstra Trident 23.10を使用している
このクラスタタイプでは自動有効化が許可されていません

の場合 Partially eligible ケースについては、以下の手順に従ってクラスタのAstra Control Provisionerを手動で有効にしてください。

クラスタの追加ワークフローにおけるクラスタ参加資格を示すスクリーンショット

Astra Control Provisionerを有効にする前に

Astra Control Provisionerが設定されていないAstra Tridentをすでに使用していて、Astra Control Provisionerを有効にする場合は、まず次の手順を実行します。

* Astra Tridentがインストールされている場合は、バージョンが4リリース期間内であることを確認してください*：Astra Tridentがバージョン24.02の4リリース期間内であれば、Astra Control Provisionerを使用してAstra Trident 24.02への直接アップグレードを実行できます。たとえば、Astra Trident 23.04から24.02に直接アップグレードできます。
クラスタにAMD64システムアーキテクチャがあることを確認する：Astra Control ProvisionerイメージはAMD64とARM64の両方のCPUアーキテクチャで提供されますが、Astra ControlでサポートされるのはAMD64のみです。

手順

NetApp Astra Controlイメージのレジストリにアクセスします。
1. Astra Control Service UIにログオンし、Astra ControlアカウントIDを記録します。
  1. ページの右上にある図のアイコンを選択します。
  2. [API access*]を選択します。
  3. アカウントIDを書き留めます。
2. 同じページから* APIトークンの生成*を選択し、APIトークン文字列をクリップボードにコピーしてエディターに保存します。
3. 任意の方法でAstra Controlレジストリにログインします。
  docker login cr.astra.netapp.io -u <account-id> -p <api-token>
  Docker
  Copy
  crane auth login cr.astra.netapp.io -u <account-id> -p <api-token>
  Crane
  Copy

(カスタムレジストリのみ)イメージをカスタムレジストリに移動するには、次の手順に従います。レジストリを使用していない場合は、次のセクション。

次のコマンドには、Dockerの代わりにPodmanを使用できます。Windows環境を使用している場合は、PowerShellを推奨します。

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

画像にタグを付けます。

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

イメージをカスタムレジストリにプッシュします。
```
docker push <my_custom_registry>/trident-acp:24.02.0
```
Console
Copy

元のAstra Tridentインストール方法で。

以前使用したインストール方法を使用して、Astra TridentでAstra Control Provisionerを有効にします。

"Astra Tridentインストーラをダウンロードして展開"。
Astra Tridentをまだインストールしていない場合、または元のAstra Trident環境からオペレータを削除した場合は、次の手順を実行します。
1. CRDを作成します。
  kubectl create -f deploy/crds/trident.netapp.io_tridentorchestrators_crd_post1.16.yaml
  Console
  Copy
2. Tridentネームスペースを作成 (kubectl create namespace trident）またはTridentネームスペースがまだ存在することを確認 (kubectl get all -n trident）。ネームスペースが削除されている場合は、もう一度作成します。

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>

Astra Tridentが実行されていることを確認します。
```
kubectl get torc -n trident
```
Console
Copy
対応：
```
NAME      AGE
trident   21m
```
[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>
```
Console
Copy
TridentOrchestrator CRを編集し、次の編集を行います。
```
kubectl edit torc trident -n trident
```
Console
Copy
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>
```
ファイルを保存して終了します。導入プロセスが自動的に開始されます。

operator、deployment、およびReplicaSetsが作成されていることを確認します。

kubectl get all -n trident

Kubernetes クラスタには、オペレータのインスタンスが * 1 つしか存在しないようにしてください。Astra Tridentオペレータを複数の環境に導入することは避けてください。

を確認します 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

"Astra Tridentインストーラをダウンロードして展開"。
"既存のAstra Tridentがある場合は、そのTridentをホストしているクラスタからアンインストール"。
Astra Control Provisionerを有効にしてAstra Tridentをインストール (--enable-acp=true）：
```
./tridentctl -n trident install --enable-acp=true --acp-image=mycustomregistry/trident-acp:24.02
```
Console
Copy

Astra Control Provisionerが有効になっていることを確認します。

./tridentctl -n trident version

対応：

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

Astra Trident 23.07.1以前がインストールされている場合は、 "をアンインストールします" オペレータおよびその他のコンポーネント。
Kubernetesクラスタが1.24以前を実行している場合は、pspを削除します。
```
kubectl delete psp tridentoperatorpod
```

Astra Trident Helmリポジトリを追加します。

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

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!⎈

画像を一覧表示します。

./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)

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

使用 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 Provisionerをインストールすると、Astra Control UIでプロビジョニングツールをホストしているクラスタに ACP version 代わりに Trident version フィールドと現在インストールされているバージョン番号。

UIでのACPバージョンの場所を示すスクリーンショット

を参照してください。

"Astra Tridentのアップグレードに関するドキュメント"

Astra Control Provisionerを有効にする

Creating your file...