Google Cloud NetApp Volumes ONTAP モードストレージプールの設定
Trident 26.06以降、既存の `ontap-san`および `ontap-nas`バックエンドを設定して、Google Cloud NetApp Volumes(GCNV)のONTAPモードストレージプールにストレージをプロビジョニングできます。この機能はテクニカルプレビューです。
|
|
この機能は Trident 26.10 のテクニカルプレビューです。テクニカルプレビュー機能は、本番環境での使用はサポートされていません。機能、設定項目、およびサポートされるマトリックスは、一般提供開始(GA)前に変更される場合があります。 |
仕組み
Trident は既存の `ontap-san`および `ontap-nas`ドライバーロジックを再利用し、GCNV プロキシエンドポイントを介して ONTAP REST 呼び出しをルーティングします。このアプローチにより、直接 ONTAP バックエンドに使用するのと同じ運用ワークフローを維持しながら、GCNV ホスト上の ONTAP クラスターのストレージをプロビジョニングおよび管理できます。ONTAP モードでは、新しいストレージドライバーは導入されません。バックエンドごとに有効にするには、 `gcnv`構成ブロックを `ontap-san`または `ontap-nas`バックエンドに追加します。
プロビジョニングのパスは次のとおりです:
PersistentVolumeClaim → Trident (ontap-san または ontap-nas) → ONTAP REST クライアント → GCNV プロキシ → GCNV プール内の ONTAP クラスター
サポート対象範囲とサポート対象外範囲
このテクニカルプレビューでは、以下をサポートしています。
-
ドライバー:
ontap-san(iSCSI)およびontap-nas(NFSまたはSMB)。 -
プロキシを介したライフサイクル操作:バックエンドの初期化、ボリュームの作成と削除、および関連する ONTAP REST フロー。
-
認証モデル:Workload Identity Pool (WIP)、サービスアカウントキー、およびApplication Default Credentials (ADC)フォールバック。
このテクニカルプレビューでは、以下の項目は対象外となります。
-
ontap-san-economy、ontap-nas-economy、および `ontap-nas-flexgroup`ドライバー。 -
ASA r2 パーソナリティパス。
-
ZAPIのフォールバック。ONTAPモードはONTAP RESTのみを使用します。
前提条件
ONTAPモードのバックエンドを設定する前に、以下のものを用意してください:
-
Trident 26.06以降。
-
対象プロジェクトおよび対象場所に、GCNV ONTAP モードのストレージプールが必要です。
-
プロキシ操作に必要な GCP IAM 権限を、お客様の環境に合わせて適切にスコープ設定します。
-
proxyURL、projectNumber、location、および `poolID`を含むバックエンド構成。 -
iSCSI SANワークフローの場合、プラットフォームのノード側iSCSIおよびマルチパスの前提条件が必要です。"ワーカーノードを準備します"を参照してください。
バックエンドの設定
A TridentBackendConfig には、Kubernetes Secret を参照する credentials`が必要です。ONTAPモードの場合、シークレットはGCPプロキシアクセスの認証情報を提供しますが、ONTAP `managementLIF / username / `password`の認証情報ではありません。認証方法によっては、サービスアカウントキーのフィールドが含まれる場合もあれば、空になる場合もあります。 `svm`はオプションです:各GCNV ONTAPモードプールには現在1つのSVMがあり、省略された場合、Tridentはプールからそれを取得します。
サービスアカウントキー認証には、ネイティブGCNVと同じパターンを使用します:非機密フィールドは `gcnv.apiKey`に、 `private_key`および `private_key_id`はシークレットに配置します。"Google Cloud NetApp Volumes の構成例"を参照してください。Workload Identity PoolまたはGKEクラウドID認証については、認証の例を参照してください。
apiVersion: trident.netapp.io/v1
kind: TridentBackendConfig
metadata:
name: gcnv-ontap-san
namespace: trident
spec:
version: 1
storageDriverName: ontap-san
backendName: gcnv-ontap-san
credentials:
name: gcnv-sa-secret
type: secret
gcnv:
proxyURL: "https://netapp.googleapis.com"
projectNumber: "<project-number>"
location: "<pool-location>"
poolID: "<pool-id>"
svm: "<svm-name>"
apiVersion: trident.netapp.io/v1
kind: TridentBackendConfig
metadata:
name: gcnv-ontap-nas
namespace: trident
spec:
version: 1
storageDriverName: ontap-nas
backendName: gcnv-ontap-nas
credentials:
name: gcnv-sa-secret
type: secret
gcnv:
proxyURL: "https://netapp.googleapis.com"
projectNumber: "<project-number>"
location: "<pool-location>"
poolID: "<pool-id>"
apiKey:
type: service_account
project_id: "<project-id>"
client_email: "<service-account-email>"
client_id: "<client-id>"
auth_uri: "https://accounts.google.com/o/oauth2/auth"
token_uri: "https://oauth2.googleapis.com/token"
auth_provider_x509_cert_url: "https://www.googleapis.com/oauth2/v1/certs"
client_x509_cert_url: "<client-x509-cert-url>"
svm: "<svm-name>"
apiVersion: v1
kind: Secret
metadata:
name: gcnv-sa-secret
namespace: trident
type: Opaque
stringData:
private_key_id: "<private-key-id>"
private_key: |
-----BEGIN PRIVATE KEY-----
<private-key>
-----END PRIVATE KEY-----
|
|
`TridentBackendConfig`仕様には `private_key`や `private_key_id`を指定しないでください。CRDによって拒否されます。ブロック ストレージには、同じ `gcnv`とクレデンシャル パターンを持つ `ontap-san`を使用してください。 |
認証
Tridentは、プロキシアクセス用の認証情報を以下の順序で解決します:
-
Workload Identity プール(WIP)
-
サービスアカウントキー
-
アプリケーションのデフォルト認証情報(ADC)
このテクニカルプレビューでは、以下の手順に従ってください:
-
Workload Identity Poolが利用可能な場合は、それを優先してください。
-
バージョン管理されたバックエンドファイルに、生の秘密鍵を埋め込まないでください。認証情報をKubernetesシークレットに保存します。
-
サービスアカウントに最小権限のIAMスコープを適用します。
`gcnv`ブロック内の `location`は、プールのロケーションと一致している必要があります。ゾーンプールにはゾーンを、リージョンプールにはリージョンを使用してください。
Workload Identity プール
`gcnv.wipCredential`は、 `TridentBackendConfig`で設定された明示的な外部アカウントフェデレーションに使用します。OpenShiftでは、TridentはトークンをÅ `/var/run/secrets/wif-token/token`にプロジェクトします。これは TridentがÅOpenShift WIF 用にプロジェクトする唯一のトークンパスであるため、 `credential_source.file`に使用してください。link:gcnv.html#openshift-wif["Workload Identity フェデレーションを使用して Google Cloud NetApp Volumes を設定する"]の説明に従って、WIF オーディエンスを使用して Trident をインストールしてください。 `credentials`フィールドは引き続き Secret を参照しますが、Secret には `private_key`を含めてはなりません。
apiVersion: v1
kind: Secret
metadata:
name: gcnv-ontap-empty
namespace: trident
type: Opaque
---
apiVersion: trident.netapp.io/v1
kind: TridentBackendConfig
metadata:
name: gcnv-ontap-nas-wip
namespace: trident
spec:
version: 1
storageDriverName: ontap-nas
backendName: gcnv-ontap-nas-wip
useREST: true
nasType: nfs
nfsMountOptions: nfsvers=4.1
credentials:
name: gcnv-ontap-empty
type: secret
gcnv:
proxyURL: "https://netapp.googleapis.com"
projectNumber: "<project-number>"
location: "<pool-location>"
poolID: "<pool-id>"
wipCredential:
type: external_account
audience: "//iam.googleapis.com/projects/<wif-pool-project-number>/locations/global/workloadIdentityPools/<wif-pool-id>/providers/<provider-id>"
subject_token_type: "urn:ietf:params:oauth:token-type:jwt"
token_url: "https://sts.googleapis.com/v1/token"
service_account_impersonation_url: "https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/<service-account-email>:generateAccessToken"
credential_source:
file: "/var/run/secrets/wif-token/token"
GKEクラウドアイデンティティ
GKEの場合は、"GKEワークロードIDを使用する"で説明されているように、インストール時にTridentのクラウドIDを設定します。バックエンドはApplication Default Credentials(ADC)を使用します。 `gcnv.apiKey`と `gcnv.wipCredential`の両方を省略してください。 `credentials`フィールドは引き続きSecretを参照しますが、そこに `private_key`を含めないでください。
apiVersion: v1
kind: Secret
metadata:
name: gcnv-ontap-empty
namespace: trident
type: Opaque
---
apiVersion: trident.netapp.io/v1
kind: TridentBackendConfig
metadata:
name: gcnv-ontap-nas-wi
namespace: trident
spec:
version: 1
storageDriverName: ontap-nas
backendName: gcnv-ontap-nas-wi
useREST: true
nasType: nfs
nfsMountOptions: nfsvers=4.1
credentials:
name: gcnv-ontap-empty
type: secret
gcnv:
proxyURL: "https://netapp.googleapis.com"
projectNumber: "<project-number>"
location: "<pool-location>"
poolID: "<pool-id>"
検証および初期化動作
Tridentは初期化中にONTAPモードのバックエンドを検証し、部分的に初期化するのではなく、すぐにエラーで終了します。
必須の `gcnv`フィールドが欠落しているか、ドライバがONTAPモードでサポートされていないか、または認証情報の解決に失敗した場合、バックエンドの初期化は失敗します。
既知の制限事項
-
この機能はテクニカルプレビュー版です。動作およびサポートマトリックスはGA前に変更される可能性があります。
-
ONTAPモードではZAPIフォールバックは使用されません。
-
プロトコルおよびノードの準備状況に関する要件は引き続き適用されます。たとえば、iSCSIワークフローでは、"ワーカーノードを準備します"で説明されているノード側の前提条件が必要です。
-
既存のONTAPおよびGCNV環境の制約は引き続き適用されます。
アップグレードと互換性
ONTAPモードは、 `gcnv`設定ブロックを介してバックエンドごとにオプトインします:
-
既存の非GCNV ONTAPバックエンドには影響はありません。
-
直接ONTAPバックエンドとONTAPモードのプロキシバックエンドを組み合わせた混在環境での導入は、バックエンドレベルの設定を通じてサポートされます。各バックエンドは個別に設定されます。
-
ONTAPモードの使用を停止するには、影響を受けるバックエンドを削除または交換してください。グローバルな切り替えは不要です。
次の手順
TBCの前にシークレットを適用します。例に合わせるには、 `kubectl apply`と `-n trident`を使用します。