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

Google Cloud NetApp Volumes ONTAP モードストレージプールの設定

共同作成者 joan-ing

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認証については、認証の例を参照してください。

ontap-san バックエンド
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>"
ontap-nas backend
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は、プロキシアクセス用の認証情報を以下の順序で解決します:

  1. Workload Identity プール(WIP)

  2. サービスアカウントキー

  3. アプリケーションのデフォルト認証情報(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`を使用します。