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. 登录到 web 控制台。

2. 安装 AWS EFS CSI Operator：

   1. 点 Operators OperatorHub。
   2. 通过在过滤框中键入 AWS EFS CSI 来找到 AWS EFS CSI Operator。
   3. 点 AWS EFS CSI Driver Operator 按钮。
   重要

   确保选择 AWS EFS CSI Driver Operator，而不是 AWS EFS Operator。AWS EFS Operator 是一个社区 Operator，不受红帽支持。

   1. 在 AWS EFS CSI Driver Operator 页面中，点 Install。

   2. 在 Install Operator 页面中，确保：

      • 如果您使用 AWS Secure Token Service (STS) 的 AWS EFS，在角色 ARN 字段中输入从 Obtaining a role Amazon Resource Name for Security Token Service 过程的最后一步中复制的 ARN 角色。
      • 选择 All namespaces on the cluster (default)。
      • 安装的命名空间 被设置为 openshift-cluster-csi-drivers。

   3. 点 Install。

      安装完成后，AWS EFS CSI Operator 会在 web 控制台的 Installed 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. 点 Create。

5. 等待以下 Conditions 更改为 "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 Driver 中的卷指标集合通过递归浏览卷中的文件来执行。

   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. 点击 Save。

1. 运行以下命令来编辑 ClusterCSIDriver ：

   $ oc edit clustercsidriver efs.csi.aws.com

2. 在 spec.aws.efsVolumeMetrics.state 下，将值设为 RecursiveWalk。

   RecursiveWalk 表示 AWS EFS CSI Driver 中的卷指标集合通过递归浏览卷中的文件来执行。

   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 对象的更改。