Skip to main content
本繁體中文版使用機器翻譯,譯文僅供參考,若與英文版本牴觸,應以英文版本為準。

Trident Linux 統一金鑰設定 (LUKS)

貢獻者 netapp-aruldeepa juliantap joan-ing netapp-mwallis

Linux 統一金鑰設定 (LUKS) 是一種磁碟加密規範。Trident 使用 LUKS 為 ONTAP SAN 和 ONTAP SAN ECONOMY Volume 提供每個 Volume 的主機端加密,並支援密碼片語輪替與 Volume 擴充。

在 Trident 中, LUKS 加密的磁碟區使用 AES-XTS-plain64 cypher 和模式"NIST",如所建議。

註 ASA r2 系統不支援 LUKS 加密。有關 ASA r2 系統的信息,請參閱"瞭解 ASA R2 儲存系統" 。
開始之前
  • 工作者節點必須安裝密碼設定2.1或更高版本(但低於3.0)。如需詳細資訊、請造訪 "Gitlab:密碼設定"。

  • 基於效能理由, NetApp 建議工作節點支援進階加密標準新指令( AES-NI )。若要驗證AES-NI支援、請執行下列命令:

    grep "aes" /proc/cpuinfo

    如果沒有歸還任何內容、您的處理器就不支援AES-NI。如需AES-NI的詳細資訊、請造訪: "Intel:進階加密標準指令(AES-NI)"。

啟用LUKS加密

您可以使用Linux Unified Key Setup(LUKS)來啟用每個Volume、主機端的加密功能、以利ONTAP 執行SAN和ONTAP 支援SAN經濟效益的磁碟區。

步驟
  1. 在後端組態中定義LUKS加密屬性。如需ONTAP 有關支援不支援SAN的後端組態選項的詳細資訊、請參閱 "支援SAN組態選項ONTAP"。

    {
      "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

將 LUKS 與 RWX 原始區塊 Volume 一起使用

從 Trident 26.10 開始,您可以將 LUKS 加密與 iSCSI 支援的原始區塊 Volume 搭配使用,這些 Volume 使用 ReadWriteMany (RWX) 存取模式連接到多個 Kubernetes 節點。這對於需要在即時移轉期間將相同加密 Volume 連接到目的地節點,同時仍連接到來源節點的工作負載(例如 KubeVirt 虛擬機器)非常有用。

RWX LUKS 支援僅限於原始區塊 Volume。不支援檔案系統模式的 RWX LUKS Volume。應用程式負責協調對解密資料的並行存取;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

多個節點上的 Pod 可以將此 PVC 作為原始區塊裝置附加。Trident 在裝置首次附件時使用 LUKS2 進行格式化,並在後續節點上開啟現有的加密 Volume。支援現有的 LUKS 操作,包括密碼輪換和 Volume 擴充。

為什麼 Trident 會對 LUKS 作業進行序列化

LUKS2 在區塊裝置的開頭儲存其加密標頭的備援副本。 cryptsetup 當偵測到副本存在差異時,即使在看似唯讀的命令執行期間,也能修理標頭。它的鎖定機制僅限於節點,無法協調其他節點上的作業。如果一個節點正在更新標頭,而另一個節點執行 cryptsetup,則第二個節點可能會觸發標頭修理並中斷更新,這可能會導致標頭毀損。

為了防止同時存取標頭, Trident 為每個 RWX LUKS Volume 使用 Kubernetes 租約。在節點對 Volume 執行任何 `cryptsetup`命令之前,必須持有該租約。Trident 在操作成功後會釋放租約。如果在持有租約期間有其他節點要求操作, Trident 將傳回可重試的錯誤, Kubernetes 稍後會重試。對不同 Volume 的操作是獨立的。

如果 cryptsetup 作業失敗,Trident 會故意保留租約,以便只有同一節點才能重試。帶有原因 LeaseRetained 的警告事件會記錄此故障。租約不會自動過期;系統管理員只有在確認其持有節點上沒有執行 cryptsetup 作業後,才應移除租約。如需恢復步驟,請參閱 "修正 RWX Linux 統一金鑰設定(LUKS)Volume 卡住的租約"。

由於節點輪流開啟 Volume,因此在許多不同節點上啟動工作負載所需的時間可能比使用未加密 Volume 更長。Kubernetes 會在目前作業完成後重試暫時性鎖定錯誤。在大規模橫向擴充期間,Pod 可能會停留在 `ContainerCreating`更長時間;同一個節點上的工作負載可以共享單一開啟的裝置對應。

限制

LUKS加密磁碟區無法利用ONTAP 重複資料刪除技術與壓縮技術。

用於匯入 LUKS Volume 的後端組態

若要匯入 LUKS Volume 、您必須在後端將設 luksEncryption`為(`true。 luksEncryption`選項告訴 Trident 卷是否符合 LUKS (`false)(`true`或不符合 LUKS ),如下例所示。

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 Volume 的 PVC 組態

若要動態匯入 LUKS Volume 、請將註釋設 trident.netapp.io/luksEncryption`為 `true、並在 PVC 中包含啟用 LUKS 的儲存類別、如本範例所示。

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複雜密碼並確認輪調。

警告 請勿忘記密碼、除非您已驗證它不再被任何磁碟區、快照或機密所引用。如果參考的通關密碼遺失、您可能無法掛載磁碟區、而且資料將保持加密且無法存取。
關於這項工作

如果在指定新的LUKS通關密碼之後建立裝載磁碟區的Pod、則會發生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. 識別磁碟區或快照上的現有密碼。

    Volume
    tridentctl -d get volume luks-pvc1
    GET http://127.0.0.1:8000/trident/v1/volume/<volumeID>
    
    ...luksPassphraseNames:["A"]
    Snapshot
    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. 建立新的Pod以掛載Volume。這是啟動旋轉所需的。

  5. 確認複雜密碼已旋轉。

    Volume
    tridentctl -d get volume luks-pvc1
    GET http://127.0.0.1:8000/trident/v1/volume/<volumeID>
    
    ...luksPassphraseNames:["B"]
    Snapshot
    tridentctl -d get snapshot luks-pvc1
    GET http://127.0.0.1:8000/trident/v1/volume/<volumeID>/<snapshotID>
    
    ...luksPassphraseNames:["B"]
結果

只有在磁碟區和快照上傳回新的通關密碼時、才會旋轉通關密碼。

註 例如、如果傳回兩個複雜密碼 luksPassphraseNames: ["B", "A"]、旋轉不完整。您可以觸發新的Pod以嘗試完成旋轉。

啟用Volume擴充

您可以在LUKS加密的Volume上啟用Volume擴充。

步驟
  1. 啟用 CSINodeExpandSecret 功能閘道(beta 1.25 +)。請參閱 "Kubernetes 1.25:使用Secrets進行節點導向的SCSI Volume擴充" 以取得詳細資料。

  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
結果

當您啟動線上儲存擴充時、kubelet會將適當的認證資料傳遞給驅動程式。