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

Trident Linux統合キー設定(LUKS)

共同作成者 netapp-aruldeepa juliantap joan-ing netapp-mwallis

Linux Unified Key Setup (LUKS) は、ディスク暗号化の仕様です。TridentはLUKSを使用して、ONTAP SANおよびONTAP SAN ECONOMYボリュームに対してボリューム単位のホスト側暗号化を提供し、パスフレーズのローテーションとボリュームの拡張をサポートします。

Tridentでは、LUKSで暗号化されたボリュームでAES-XTS-plain64暗号化およびモードが使用されます(の推奨)"NIST"。

メモ LUKS暗号化はASA r2システムではサポートされていません。ASAr2システムの詳細については、以下を参照してください。 "ASA R2ストレージシステムの詳細" 。
作業を開始する前に
  • ワーカーノードにはcryptsetup 2.1以上(3.0よりも下位)がインストールされている必要があります。詳細については、を参照してください "Gitlab: cryptsetup"。

  • パフォーマンス上の理由から、NetAppでは、ワーカーノードでAdvanced Encryption Standard New Instructions(AES-NI)をサポートすることを推奨しています。AES-NIサポートを確認するには、次のコマンドを実行します。

    grep "aes" /proc/cpuinfo

    何も返されない場合、お使いのプロセッサはAES-NIをサポートしていません。AES-NIの詳細については、以下を参照してください。 "Intel:Advanced Encryption Standard Instructions(AES-NI)"。

LUKS暗号化を有効にします

ONTAP SANおよびONTAP SANエコノミーボリュームでは、Linux Unified Key Setup(LUKS;Linux統合キーセットアップ)を使用して、ボリューム単位のホスト側暗号化を有効にできます。

手順
  1. バックエンド構成でLUKS暗号化属性を定義します。ONTAP SANのバックエンド構成オプションの詳細については、を参照してください "ONTAP のSAN構成オプション"。

    {
      "storage": [
        {
          "labels": {
            "luks": "true"
          },
          "zone": "us_east_1a",
          "defaults": {
            "luksEncryption": "true"
          }
        },
        {
          "labels": {
            "luks": "false"
          },
          "zone": "us_east_1a",
          "defaults": {
            "luksEncryption": "false"
          }
        }
      ]
    }
  2. 使用 parameters.selector LUKS暗号化を使用してストレージプールを定義する方法。例:

    apiVersion: storage.k8s.io/v1
    kind: StorageClass
    metadata:
      name: luks
    provisioner: csi.trident.netapp.io
    parameters:
      selector: "luks=true"
      csi.storage.k8s.io/node-stage-secret-name: luks-${pvc.name}
      csi.storage.k8s.io/node-stage-secret-namespace: ${pvc.namespace}
  3. LUKSパスフレーズを含むシークレットを作成します。例:

    kubectl -n trident create -f luks-pvc1.yaml
    apiVersion: v1
    kind: Secret
    metadata:
      name: luks-pvc1
    stringData:
      luks-passphrase-name: A
      luks-passphrase: secretA

RWX rawブロックボリュームでLUKSを使用する

Trident 26.10以降では、 ReadWriteMany(RWX)アクセスモードを使用して複数のKubernetesノードに接続されたiSCSIベースのrawブロックボリュームで、LUKS暗号化を使用できます。これは、ライブマイグレーション中にソースノードに接続されたままの状態で、宛先ノードにも同じ暗号化ボリュームを接続する必要があるKubeVirt仮想マシンなどのワークロードに役立ちます。

RWX LUKSのサポートは、rawブロックボリュームに限定されます。ファイルシステムモードのRWX LUKSボリュームはサポートされていません。アプリケーションは、復号化されたデータへの同時アクセスを調整する役割を担います。TridentはLUKS処理の調整のみを行います。

LUKS暗号化を有効にしますで説明されているように、バックエンド、StorageClass、およびパスフレーズSecretでLUKSを設定します。次に、 `volumeMode: Block`および `ReadWriteMany`を使用してPVCを作成します:

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: my-rwx-pvc
  namespace: my-app
spec:
  accessModes:
    - ReadWriteMany
  volumeMode: Block
  storageClassName: san-luks-rwx
  resources:
    requests:
      storage: 10Gi

複数のノード上のポッドは、このPVCをrawブロックデバイスとして接続できます。Tridentは、最初の接続時にデバイスをLUKS2でフォーマットし、後続のノードでは既存の暗号化ボリュームを開きます。パスフレーズのローテーションやボリュームの拡張など、既存のLUKS操作がサポートされています。

TridentがLUKS操作をシリアル化する理由

LUKS2は、暗号化ヘッダーの冗長コピーをブロックデバイスの先頭に格納します。 `cryptsetup`は、読み取り専用のように見えるコマンドの実行中も含め、コピーが異なることを検出した場合にヘッダーを修復できます。そのロック機能はノード固有のものであり、他のノードでの操作を調整することはできません。1つのノードがヘッダーを更新している間に、別のノードが `cryptsetup`を実行すると、2番目のノードがヘッダー修復をトリガーして更新を中断し、ヘッダーを破損させる可能性があります。

同時ヘッダーアクセスを防止するため、Tridentは各RWX LUKSボリュームに対してKubernetesリースを使用します。ノードがボリュームに対して任意の `cryptsetup`コマンドを実行する前に、リースを保持している必要があります。Tridentは、操作が成功したあとにリースを解放します。リースが保持されている間に別のノードが操作を要求した場合、Tridentは再試行可能なエラーを返し、Kubernetesは後で再試行します。異なるボリュームに対する操作は独立しています。

`cryptsetup`操作が失敗した場合、Tridentは意図的にリースを保持し、同じノードのみが再試行できるようにします。理由が `LeaseRetained`の警告イベントに失敗が記録されます。リースは自動的に期限切れにはなりません。管理者は、その保持ノードで `cryptsetup`操作が実行されていないことを確認したあとにのみ、リースを削除する必要があります。復旧手順については、link:rwx-luks-stuck-lease.html["RWX Linux Unified Key Setup (LUKS) ボリュームのリースが停止した状態を修復する"]を参照してください。

ノードが順番にボリュームを開くため、多くの異なるノードでワークロードを開始するには、暗号化されていないボリュームの場合よりも時間がかかる場合があります。Kubernetesは、現在の操作が完了したあとに、一時的なロックエラーを再試行します。ポッドは大規模なスケールアウト中、 `ContainerCreating`に長く留まる場合があります。同一ノード上のワークロードは、単一のオープンデバイスマッピングを共有できます。

制限

LUKSで暗号化されたボリュームは、ONTAP の重複排除と圧縮を利用できません。

LUKSボリュームをインポートするためのバックエンド構成

LUKSボリュームをインポートするには、バックエンドでをに(true`設定する必要があります `luksEncryption。このオプションを指定する `luksEncryption`と、(`false`次の例に示すように、ボリュームがLUKS準拠である(`true`かどうかがTridentに通知されます。

version: 1
storageDriverName: ontap-san
managementLIF: 10.0.0.1
dataLIF: 10.0.0.2
svm: trident_svm
username: admin
password: password
defaults:
  luksEncryption: 'true'
  spaceAllocation: 'false'
  snapshotPolicy: default
  snapshotReserve: '10'

LUKSボリュームをインポートするためのPVC設定

LUKSボリュームを動的にインポートするには、 trident.netapp.io/luksEncryption `true`次の例に示すように、アノテーションをに設定し、LUKS対応のストレージクラスをPVCに含めます。

kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: luks-pvc
  namespace: trident
  annotations:
    trident.netapp.io/luksEncryption: "true"
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 1Gi
  storageClassName: luks-sc

LUKSパスフレーズをローテーションします

LUKSのパスフレーズをローテーションしてローテーションを確認できます。

警告 パスフレーズは、ボリューム、Snapshot、シークレットで参照されなくなることを確認するまで忘れないでください。参照されているパスフレーズが失われた場合、ボリュームをマウントできず、データが暗号化されたままアクセスできなくなることがあります。
このタスクについて

LUKSパスフレーズのローテーションは、ボリュームをマウントするポッドが、新しいLUKSパスフレーズの指定後に作成されたときに行われます。新しいPODが作成されると、Tridentはボリューム上のLUKSパスフレーズをシークレット内のアクティブなパスフレーズと比較します。

  • ボリュームのパスフレーズがシークレットでアクティブなパスフレーズと一致しない場合、ローテーションが実行されます。

  • ボリュームのパスフレーズがシークレットのアクティブなパスフレーズと一致する場合は、を参照してください previous-luks-passphrase パラメータは無視されます。

手順
  1. を追加します node-publish-secret-name および node-publish-secret-namespace StorageClassパラメータ。例:

    apiVersion: storage.k8s.io/v1
    kind: StorageClass
    metadata:
      name: csi-san
    provisioner: csi.trident.netapp.io
    parameters:
      trident.netapp.io/backendType: "ontap-san"
      csi.storage.k8s.io/node-stage-secret-name: luks
      csi.storage.k8s.io/node-stage-secret-namespace: ${pvc.namespace}
      csi.storage.k8s.io/node-publish-secret-name: luks
      csi.storage.k8s.io/node-publish-secret-namespace: ${pvc.namespace}
  2. ボリュームまたはSnapshotの既存のパスフレーズを特定します。

    ボリューム
    tridentctl -d get volume luks-pvc1
    GET http://127.0.0.1:8000/trident/v1/volume/<volumeID>
    
    ...luksPassphraseNames:["A"]
    スナップショット
    tridentctl -d get snapshot luks-pvc1
    GET http://127.0.0.1:8000/trident/v1/volume/<volumeID>/<snapshotID>
    
    ...luksPassphraseNames:["A"]
  3. ボリュームのLUKSシークレットを更新して、新しいパスフレーズと前のパスフレーズを指定します。確認します previous-luke-passphrase-name および previous-luks-passphrase 前のパスフレーズと同じにします。

    apiVersion: v1
    kind: Secret
    metadata:
      name: luks-pvc1
    stringData:
      luks-passphrase-name: B
      luks-passphrase: secretB
      previous-luks-passphrase-name: A
      previous-luks-passphrase: secretA
  4. ボリュームをマウントする新しいポッドを作成します。これはローテーションを開始するために必要です。

  5. パスフレーズがローテーションされたことを確認します。

    ボリューム
    tridentctl -d get volume luks-pvc1
    GET http://127.0.0.1:8000/trident/v1/volume/<volumeID>
    
    ...luksPassphraseNames:["B"]
    スナップショット
    tridentctl -d get snapshot luks-pvc1
    GET http://127.0.0.1:8000/trident/v1/volume/<volumeID>/<snapshotID>
    
    ...luksPassphraseNames:["B"]
結果

パスフレーズは、ボリュームとSnapshotに新しいパスフレーズのみが返されたときにローテーションされました。

メモ たとえば、2つのパスフレーズが返された場合などです `luksPassphraseNames: ["B", "A"]`回転が不完全です。回転を完了するために、新しいポッドをトリガできます。

ボリュームの拡張を有効にします

LUKS暗号化ボリューム上でボリューム拡張を有効にできます。

手順
  1. を有効にします CSINodeExpandSecret 機能ゲート(ベータ1.25+)。を参照してください "Kubernetes 1.25:CSIボリュームのノードベースの拡張にシークレットを使用します" を参照してください。

  2. を追加します node-expand-secret-name および node-expand-secret-namespace StorageClassパラメータ。例:

    apiVersion: storage.k8s.io/v1
    kind: StorageClass
    metadata:
      name: luks
    provisioner: csi.trident.netapp.io
    parameters:
      selector: "luks=true"
      csi.storage.k8s.io/node-stage-secret-name: luks-${pvc.name}
      csi.storage.k8s.io/node-stage-secret-namespace: ${pvc.namespace}
      csi.storage.k8s.io/node-expand-secret-name: luks-${pvc.name}
      csi.storage.k8s.io/node-expand-secret-namespace: ${pvc.namespace}
    allowVolumeExpansion: true
結果

ストレージのオンライン拡張を開始すると、ドライバに適切なクレデンシャルが渡されます。