5.7. AWS Elastic File Service CSI Driver Operator

• AWS EFS CSI Driver Operator 는 설치 후 PVC(영구 볼륨 클레임)를 생성하는 데 사용할 스토리지 클래스를 기본적으로 생성하지 않습니다. 그러나 AWS EFS StorageClass를 수동으로 생성할 수 있습니다. AWS EFS CSI Driver Operator는 온디맨드로 스토리지 볼륨을 생성할 수 있어 클러스터 관리자가 스토리지를 사전 프로비저닝할 필요가 없어 동적 볼륨 프로비저닝을 지원합니다.
• AWS EFS CSI 드라이버를 사용하면 AWS EFS PV를 생성하고 마운트할 수 있습니다. AWS EFS CSI 드라이버는 수동으로 설치해야 합니다.

사전 요구 사항

• OpenShift Container Platform 웹 콘솔에 액세스합니다.

사전 요구 사항

• AWS 계정 인증 정보

사전 요구 사항

• AWS EFS 볼륨이 생성되어 있습니다.
• AWS EFS 스토리지 클래스를 생성했습니다.

• 위에서 만든 StorageClass를 참조하여 PVC(또는 StatefulSet 또는 Template)를 만듭니다.

  apiVersion: v1
  kind: PersistentVolumeClaim
  metadata:
    name: test
  spec:
    storageClassName: efs-sc
    accessModes:
      - ReadWriteMany
    resources:
      requests:
        storage: 5Gi

사전 요구 사항

• AWS EFS 볼륨 생성.

절차

• 다음 YAML 파일을 사용하여 PV를 생성합니다.

  apiVersion: v1
  kind: PersistentVolume
  metadata:
    name: efs-pv
  spec:
    capacity: 1
      storage: 5Gi
    volumeMode: Filesystem
    accessModes:
      - ReadWriteMany
      - ReadWriteOnce
    persistentVolumeReclaimPolicy: Retain
    csi:
      driver: efs.csi.aws.com
      volumeHandle: fs-ae66151a 2
      volumeAttributes:
        encryptInTransit: "false" 3

  1

  spec.capacity에는 의미가 없으며 CSI 드라이버에서 무시합니다. PVC에 바인딩할 때만 사용됩니다. 애플리케이션은 볼륨에 원하는 양의 데이터를 저장할 수 있습니다.

  2

  volumeHandle은 AWS에서 생성한 EFS 볼륨과 동일해야 합니다. 자체 액세스 지점을 제공하는 경우 volumeHandle은 <EFS volume ID>::<access point ID> 여야 합니다. 예: fs-6e633ada::fsap-081a1d293f0004630.

  3

  필요한 경우 전송 시 암호화를 비활성화할 수 있습니다. 암호화는 기본적으로 활성화되어 있습니다.

• AWS EFS Operator 및 CSI 드라이버는 openshift-cluster-csi-drivers에서 실행됩니다.

• AWS EFS Operator 및 CSI 드라이버의 로그 수집을 시작하려면 다음 명령을 실행합니다.

  $ oc adm must-gather
  [must-gather      ] OUT Using must-gather plugin-in image: quay.io/openshift-release-dev/ocp-v4.0-art-dev@sha256:125f183d13601537ff15b3239df95d47f0a604da2847b561151fedd699f5e3a5
  [must-gather      ] OUT namespace/openshift-must-gather-xm4wq created
  [must-gather      ] OUT clusterrolebinding.rbac.authorization.k8s.io/must-gather-2bd8x created
  [must-gather      ] OUT pod for plug-in image quay.io/openshift-release-dev/ocp-v4.0-art-dev@sha256:125f183d13601537ff15b3239df95d47f0a604da2847b561151fedd699f5e3a5 created

• AWS EFS Operator 오류를 표시하려면 ClusterCSIDriver 상태를 확인합니다.

  $ oc get clustercsidriver efs.csi.aws.com -o yaml

• 볼륨을 Pod에 마운트할 수 없는 경우(다음 명령의 출력에 표시된 대로):

  $ oc describe pod
  ...
    Type     Reason       Age    From               Message
    ----     ------       ----   ----               -------
    Normal   Scheduled    2m13s  default-scheduler  Successfully assigned default/efs-app to ip-10-0-135-94.ec2.internal
    Warning  FailedMount  13s    kubelet            MountVolume.SetUp failed for volume "pvc-d7c097e6-67ec-4fae-b968-7e7056796449" : rpc error: code = DeadlineExceeded desc = context deadline exceeded 1
    Warning  FailedMount  10s    kubelet            Unable to attach or mount volumes: unmounted volumes=[persistent-storage], unattached volumes=[persistent-storage kube-api-access-9j477]: timed out waiting for the condition

  1

  볼륨이 마운트되지 않았음을 나타내는 경고 메시지입니다.

  이 오류는 AWS가 OpenShift Container Platform 노드와 AWS EFS 간에 패킷을 삭제하기 때문에 발생하는 경우가 많습니다.

  다음 사항이 올바른지 확인합니다(AWS의 EFS 볼륨에 대한 액세스 생성 및 구성 참조).

  • AWS 방화벽 및 보안 그룹
  • 네트워킹: 포트 번호 및 IP 주소

사전 요구 사항

• OpenShift Container Platform 웹 콘솔에 액세스합니다.