Skip to main content
简体中文版经机器翻译而成,仅供参考。如与英语版出现任何冲突,应以英语版为准。

Trident Linux 统一密钥设置(LUKS)

贡献者 netapp-aruldeepa juliantap joan-ing netapp-mwallis

Linux 统一密钥设置(LUKS)是一种磁盘加密规范。Trident 使用 LUKS 为 ONTAP SAN 和 ONTAP SAN ECONOMY 卷提供基于每个卷的主机端加密,并支持密码短语轮换和卷扩展。

在Trident中,根据的建议,经过LUN加密的卷使用AES-XTS-PLAN 64 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加密

您可以对ONTAP SAN和ONTAP SAN经济卷使用Linux统一密钥设置(Unified Key Setup、LUKS)启用每个卷的主机端加密。

步骤
  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

将 LUKS 与 RWX 原始块卷一起使用

从 Trident 26.10 开始,您可以使用 ReadWriteMany(RWX)访问模式将 LUKS 加密与连接到多个 Kubernetes 节点的基于 iSCSI 的原始块卷结合使用。这对于 KubeVirt 虚拟机等工作负载非常有用,这些工作负载在实时迁移期间需要在目标节点上挂载相同的加密卷,而此时该卷仍挂载在源节点上。

RWX LUKS 支持仅限于原始块卷。不支持文件系统模式 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

多个节点上的 Pod 可以将此 PVC 作为原始块设备附加。Trident 在首次附加时使用 LUKS2 格式化该设备,并在后续节点上打开现有的加密卷。支持现有的 LUKS 操作,包括密码短语轮换和卷扩展。

为什么 Trident 序列化 LUKS 操作

LUKS2 在块设备的开头存储其加密标头的冗余副本。 cryptsetup 可以在检测到副本不同时修复标头,包括在执行看似只读的命令期间。它的锁定是节点本地的,无法协调其他节点上的操作。如果一个节点正在更新标头,而另一个节点正在运行 cryptsetup,则第二个节点可能会触发标头修复并中断更新,从而可能损坏标头。

为了防止并发标头访问, Trident 为每个 RWX LUKS 卷使用 Kubernetes 租约。在节点对该卷运行任何 `cryptsetup`命令之前,它必须持有该租约。Trident 在操作成功后释放该租约。如果在持有该租约期间另一个节点请求操作, Trident 会返回一个可重试的错误,并且 Kubernetes 会在稍后重试。不同卷上的操作是独立的。

如果 cryptsetup 操作失败,Trident 故意保留租约,因此只有同一个节点可以重试。带有原因 LeaseRetained 的警告事件会记录故障。租约不会自动过期;只有在确认其持有者节点上没有运行任何 cryptsetup 操作后,管理员才应删除租约。有关恢复步骤,请参见 "修复 RWX Linux 统一密钥设置(LUKS)卷的停滞租约"。

由于节点轮流打开卷,因此在许多不同节点上启动工作负载可能需要比使用未加密卷更长的时间。Kubernetes 在当前操作完成后会重试瞬态锁定错误。在大规模横向扩展期间,Pod 可能会在 `ContainerCreating`中停留更长时间;同一节点上的工作负载可以共享单个打开的设备映射。

限制

LUKS加密的卷无法利用ONTAP 重复数据删除和数据压缩功能。

用于导入LUKS卷的后端配置

要导入LUN卷、必须在后端将设置 luksEncryption`为(`true。该 luksEncryption`选项会告诉Trident卷是符合LUN (`true(兼容)还是不符合LUN (false(兼容),如以下示例所示。

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'

用于导入UKS卷的PVC配置

要动态导入LUKS卷、请将标注设置 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会将卷上的LUN密码短语与密钥中的活动密码短语进行比较。

  • 如果卷上的密码短语与密钥中的活动密码短语不匹配、则会发生轮换。

  • 如果卷上的密码短语与密钥中的活动密码短语匹配、则会显示 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。这是启动轮换所必需的。

  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以尝试完成轮换。

启用卷扩展

您可以在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
结果

启动联机存储扩展时、kubelet会将相应的凭据传递给驱动程序。