5.4. AWS Elastic File Service CSI Driver Operator

절차

1. 다음 콘텐츠를 사용하여 IAM 정책 JSON 파일을 생성합니다.

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Action": [
           "elasticfilesystem:DescribeAccessPoints",
           "elasticfilesystem:DescribeFileSystems",
           "elasticfilesystem:DescribeMountTargets",
           "ec2:DescribeAvailabilityZones",
           "elasticfilesystem:TagResource"
         ],
         "Resource": "*"
       },
       {
         "Effect": "Allow",
         "Action": [
           "elasticfilesystem:CreateAccessPoint"
         ],
         "Resource": "*",
         "Condition": {
           "StringLike": {
             "aws:RequestTag/efs.csi.aws.com/cluster": "true"
           }
         }
       },
       {
         "Effect": "Allow",
         "Action": "elasticfilesystem:DeleteAccessPoint",
         "Resource": "*",
         "Condition": {
           "StringEquals": {
             "aws:ResourceTag/efs.csi.aws.com/cluster": "true"
           }
         }
       }
     ]
   }

2. 다음 콘텐츠를 사용하여 IAM 신뢰 JSON 파일을 생성합니다.

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "Federated": "arn:aws:iam::<your_aws_account_ID>:oidc-provider/<openshift_oidc_provider>"  1
         },
         "Action": "sts:AssumeRoleWithWebIdentity",
         "Condition": {
           "StringEquals": {
             "<openshift_oidc_provider>:sub": [  2
               "system:serviceaccount:openshift-cluster-csi-drivers:aws-efs-csi-driver-operator",
               "system:serviceaccount:openshift-cluster-csi-drivers:aws-efs-csi-driver-controller-sa"
             ]
           }
         }
       }
     ]
   }

   1

   AWS 계정 ID와 OpenShift OIDC 공급자 끝점을 지정합니다.

   다음 명령을 실행하여 AWS 계정 ID를 가져옵니다.

   $ aws sts get-caller-identity --query Account --output text

   다음 명령을 실행하여 OpenShift OIDC 끝점을 가져옵니다.

   $ rosa describe cluster \
     -c $(oc get clusterversion -o jsonpath='{.items[].spec.clusterID}{"\n"}') \
     -o yaml | awk '/oidc_endpoint_url/ {print $2}' | cut -d '/' -f 3,4

   2

   OpenShift OIDC 엔드포인트를 다시 지정합니다.

3. IAM 역할을 생성합니다.

   ROLE_ARN=$(aws iam create-role \
     --role-name "<your_cluster_name>-aws-efs-csi-operator" \
     --assume-role-policy-document file://<your_trust_file_name>.json \
     --query "Role.Arn" --output text); echo $ROLE_ARN

   ARN 역할을 복사합니다. AWS EFS CSI Driver Operator를 설치할 때 필요합니다.

4. IAM 정책을 생성합니다.

   POLICY_ARN=$(aws iam create-policy \
     --policy-name "<your_cluster_name>-aws-efs-csi" \
     --policy-document file://<your_policy_file_name>.json \
     --query 'Policy.Arn' --output text); echo $POLICY_ARN

5. IAM 정책을 IAM 역할에 연결합니다.

   $ aws iam attach-role-policy \
     --role-name "<your_cluster_name>-aws-efs-csi-operator" \
     --policy-arn $POLICY_ARN

1. 웹 콘솔에 로그인합니다.

2. AWS EFS CSI Operator를 설치합니다.

   1. Operators OperatorHub를 클릭합니다.
   2. 필터 상자에 AWS EFS CSI를 입력하여 AWS EFS CSI Operator를 찾습니다.
   3. AWS EFS CSI Driver Operator 버튼을 클릭합니다.
   중요

   AWS EFS Operator가 아닌 AWS EFS CSI Driver Operator를 선택해야 합니다. AWS EFS Operator는 커뮤니티 Operator이며 Red Hat에서 지원하지 않습니다.

   1. AWS EFS CSI Driver Operator 페이지에서 설치를 클릭합니다.

   2. Operator 설치 페이지에서 다음을 확인합니다.

      • 역할 ARN 필드에 AWS EFS(Secure Token Service)를 사용하는 경우 보안 토큰 서비스 프로세스의 Amazon Resource Name(보안 토큰 서비스) 절차의 마지막 단계에서 복사한 ARN 역할을 입력합니다.
      • 클러스터의 모든 네임스페이스(기본값)가 선택됩니다.
      • 설치된 네임스페이스는 openshift-cluster-csi-drivers로 설정됩니다.

   3. 설치를 클릭합니다.

      설치가 완료되면 AWS EFS CSI Operator가 웹 콘솔의 설치된 Operators 섹션에 나열됩니다.

절차

1. Administration CustomResourceDefinitions ClusterCSIDriver 를 클릭합니다.
2. Instances 탭에서 Create ClusterCSIDriver를 클릭합니다.

3. 다음 YAML 파일을 사용합니다.

   apiVersion: operator.openshift.io/v1
   kind: ClusterCSIDriver
   metadata:
       name: efs.csi.aws.com
   spec:
     managementState: Managed

4. 생성을 클릭합니다.

5. 다음 조건이 "True" 상태로 변경될 때까지 기다립니다.

   • AWSEFSDriverNodeServiceControllerAvailable
   • AWSEFSDriverControllerServiceControllerAvailable

1. Administration > CustomResourceDefinitions 를 클릭합니다.
2. Name 드롭다운 옆에 있는 CustomResourceDefinitions 페이지에서 clustercsidriver 를 입력합니다.
3. CRD ClusterCSIDriver 를 클릭합니다.
4. YAML 탭을 클릭합니다.

5. spec.aws.efsVolumeMetrics.state 에서 값을 RecursiveWalk 로 설정합니다.

   RecursiveWalk 는 볼륨의 파일을 재귀적으로 진행하여 AWS EFS CSI 드라이버의 볼륨 메트릭 컬렉션이 수행됨을 나타냅니다.

   ClusterCSIDriver efs.csi.aws.com YAML 파일의 예

   spec:
       driverConfig:
           driverType: AWS
           aws:
               efsVolumeMetrics:
                 state: RecursiveWalk
                 recursiveWalk:
                   refreshPeriodMinutes: 100
                   fsRateLimit: 10

6. 선택 사항: 재귀우가 작동하는 방법을 정의하려면 다음 필드를 설정할 수도 있습니다.

   • refreshPeriodMinutes: 볼륨 메트릭의 새로 고침 빈도를 분 단위로 지정합니다. 이 필드를 비워 두면 적절한 기본값이 선택되며, 이는 시간이 지남에 따라 변경될 수 있습니다. 현재 기본값은 240분입니다. 유효한 범위는 1 ~ 43,200 분입니다.
   • fsRateLimit: 파일 시스템당 goroutines에서 볼륨 메트릭을 처리하기 위한 속도 제한을 정의합니다. 이 필드를 비워 두면 적절한 기본값이 선택되며, 이는 시간이 지남에 따라 변경될 수 있습니다. 현재 기본값은 5 goroutines입니다. 유효한 범위는 1에서 100 goroutines입니다.
7. 저장을 클릭합니다.

1. 다음 명령을 실행하여 ClusterCSIDriver를 편집합니다.

   $ oc edit clustercsidriver efs.csi.aws.com

2. spec.aws.efsVolumeMetrics.state 에서 값을 RecursiveWalk 로 설정합니다.

   RecursiveWalk 는 볼륨의 파일을 재귀적으로 진행하여 AWS EFS CSI 드라이버의 볼륨 메트릭 컬렉션이 수행됨을 나타냅니다.

   ClusterCSIDriver efs.csi.aws.com YAML 파일의 예

   spec:
       driverConfig:
           driverType: AWS
           aws:
               efsVolumeMetrics:
                 state: RecursiveWalk
                 recursiveWalk:
                   refreshPeriodMinutes: 100
                   fsRateLimit: 10

3. 선택 사항: 재귀우가 작동하는 방법을 정의하려면 다음 필드를 설정할 수도 있습니다.

   • refreshPeriodMinutes: 볼륨 메트릭의 새로 고침 빈도를 분 단위로 지정합니다. 이 필드를 비워 두면 적절한 기본값이 선택되며, 이는 시간이 지남에 따라 변경될 수 있습니다. 현재 기본값은 240분입니다. 유효한 범위는 1 ~ 43,200 분입니다.
   • fsRateLimit: 파일 시스템당 goroutines에서 볼륨 메트릭을 처리하기 위한 속도 제한을 정의합니다. 이 필드를 비워 두면 적절한 기본값이 선택되며, 이는 시간이 지남에 따라 변경될 수 있습니다. 현재 기본값은 5 goroutines입니다. 유효한 범위는 1에서 100 goroutines입니다.
4. efs.csi.aws.com 오브젝트에 변경 사항을 저장합니다.