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

COSIを使用してオブジェクトストレージをプロビジョニングする

共同作成者 joan-ing

Container Object Storage Interface(COSI)を使用して、Tridentが管理するKubernetesリソースを介してKubernetesワークロード用のS3バケットをプロビジョニングします。

概要

COSIは、オブジェクトストレージプロバイダーをKubernetesワークロードに接続します。Tridentは以下のリソースを提供します:

  • TridentObjectStore:Tridentをオブジェクトストレージシステムおよびその認証情報に接続します。このリソースはTridentネームスペースに作成します。

  • BucketClass:オブジェクトストアの選択およびバケットの削除ポリシーを定義します。

  • BucketClaim:バケットを要求します。

  • BucketAccessClass:バケットへのアクセスのプロビジョニング方法を定義します。

  • BucketAccess:1つ以上のバケットの認証情報を要求します。

Tridentは、以下のオブジェクトストレージドライバでCOSIをサポートしています:

  • StorageGRID:一般提供されています。

  • ONTAP S3:テクニカルプレビュー。

TridentはS3プロトコルをサポートしています。初期リリースでは、パス形式のS3アドレス指定のみがサポートされています。

要件および制限事項

  • `TridentOrchestrator`カスタムリソース(TORC)で `enableConcurrency`と `enableCOSI`の両方を有効にします。COSI はデフォルトでは有効になっていません。

  • コントローラの同時実行を有効にする前に、設定されたすべてのTridentバックエンドがサポートされているドライバを使用していることを確認してください。サポートされていないバックエンドドライバを使用すると、Tridentが起動しなくなります。"コントローラーのスケーラビリティを有効にする前に"を参照してください。

  • Trident COSIをコミュニティCOSIコントローラと並行して実行しないでください。

  • 最初のリリースでは、 objectstorage.k8s.io/v1alpha2 COSI APIを使用します。

  • StorageGRID `TridentObjectStore`リソースは、長期間有効なテナントのルート認証情報を使用します。各 `TridentObjectStore`は1つのStorageGRIDテナントに接続します。複数のリソースを同じテナントに接続できます。認証情報はTridentネームスペースのKubernetes Secretに保存し、セキュリティ要件に従って保護してください。

  • StorageGRID `BucketAccess`は、最大8つのバケットをサポートします。

並行コントローラ操作に関する一般的な情報については、"コントローラのスケーラビリティ"を参照してください。

COSI を有効にする

両方のオプションを `TridentOrchestrator`仕様で設定します:

apiVersion: trident.netapp.io/v1
kind: TridentOrchestrator
metadata:
  name: trident
spec:
  namespace: trident
  enableConcurrency: true
  enableCOSI: true

TORCを適用するか、通常のオペレータワークフローを使用して既存のリソースを更新します。TORCの設定の詳細については、"Tridentオペレータのインストールをカスタマイズ"を参照してください。

StorageGRIDオブジェクトストアを設定する

TridentネームスペースにStorageGRIDテナントの認証情報を含むKubernetes Secretを作成します:

apiVersion: v1
kind: Secret
metadata:
  name: tenant3
  namespace: trident
type: Opaque
stringData:
  username: <tenant-root-username>
  password: <tenant-root-password>

Secretを参照する `TridentObjectStore`を作成します。サンプルのエンドポイントとアカウントIDを、ご使用のStorageGRID環境の値に置き換えます:

apiVersion: trident.netapp.io/v1
kind: TridentObjectStore
metadata:
  name: trident-tenant3
  namespace: trident
spec:
  accountId: "<account-id>"
  credentials:
    secretName: tenant3
  labels:
    tenantInstance: three
  managementEndpoint: https://<storagegrid-management-endpoint>
  objectStoreDriver: storage-grid
  s3Endpoint: https://<storagegrid-s3-endpoint>

両方のリソースを適用します:

kubectl apply -f tenant-secret.yaml
kubectl apply -f trident-object-store.yaml

ONTAP S3オブジェクトストアを構成する

メモ

COSIを介したONTAP S3のサポートは、Trident 26.10ではテクニカルプレビューであり、本番環境での使用はサポートされていません。設定項目や動作は、一般提供開始前に変更される場合があります。

TridentネームスペースにONTAP S3ユーザー認証情報を含むKubernetes Secretを作成し、そのSecretを参照する `TridentObjectStore`を作成します。プレースホルダーをONTAP S3環境の値に置き換えます:

apiVersion: v1
kind: Secret
metadata:
  name: ontap-s3-credentials
  namespace: trident
type: Opaque
stringData:
  username: "<user>"
  password: "<password>"
---
apiVersion: trident.netapp.io/v1
kind: TridentObjectStore
metadata:
  name: ontap-s3
  namespace: trident
spec:
  objectStoreDriver: ontap-s3
  objectStoreName: ontap-object-store
  managementEndpoint: "<management-endpoint>"
  svmName: "<svm-name>"
  storagePrefix: trident
  credentials:
    secretName: ontap-s3-credentials
`storagePrefix`はオプションであり、省略した場合はデフォルトで `trident`になります。Secretと `TridentObjectStore`を適用します:
kubectl apply -f ontap-s3-object-store.yaml

BucketClassを作成してバケットをリクエストする

`BucketClass`は、ラベルセレクタ、オブジェクトストアタイプ、またはその両方を使用してオブジェクトストアを選択できます。選択パラメータがない場合、Tridentは設定済みのすべてのオブジェクトストアから選択できます。
apiVersion: objectstorage.k8s.io/v1alpha2
kind: BucketClass
metadata:
  name: sg-delete
spec:
  driverName: cosi.trident.netapp.io
  deletionPolicy: Delete
  parameters:
    selector: tenantInstance=three
    objectStoreType: storage-grid

クラスを使用する `BucketClaim`を作成します:

apiVersion: objectstorage.k8s.io/v1alpha2
kind: BucketClaim
metadata:
  name: claim-a1
  namespace: default
spec:
  bucketClassName: sg-delete
  protocols:
    - S3

Tridentがクレームを処理する際、一致するオブジェクトストアを選択します。複数のストアが一致する場合、Tridentは一致するストア間でバケットを分散させるために、ランダムに1つを選択します。

ワークロードにバケットへのアクセス権限を付与する

アクセスプロビジョニングを定義する `BucketAccessClass`を作成します:

apiVersion: objectstorage.k8s.io/v1alpha2
kind: BucketAccessClass
metadata:
  name: sg-access
spec:
  authenticationType: Key
  driverName: cosi.trident.netapp.io
  multiBucketAccess: MultipleBuckets

バケットクレームを参照する `BucketAccess`を作成します:

apiVersion: objectstorage.k8s.io/v1alpha2
kind: BucketAccess
metadata:
  name: sg-claim-a1
  namespace: default
spec:
  bucketAccessClassName: sg-access
  bucketClaims:
    - accessMode: ReadWrite
      accessSecretName: sg-claim-a1
      bucketClaimName: claim-a1
  protocol: S3

Tridentは、バケットへのアクセス情報を含むKubernetes Secretを作成します。ワークロードは、標準のKubernetes Secretメカニズムを使用してこのSecretを利用できます。生成されたSecretには、バケット識別子、エンドポイント、リージョン、アクセスキーなどのS3接続の詳細が含まれます。生成されたSecretを、許可されていないユーザーやワークロードに公開しないでください。

生成されたシークレットには、 COSI_S3_ACCESS_KEY_ID、 COSI_S3_ACCESS_SECRET_KEY、 COSI_S3_ADDRESSING_STYLE、 COSI_S3_BUCKET_ID、 COSI_S3_ENDPOINT、 `COSI_S3_REGION`などのキーが含まれます。