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 ドライバー 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 Operator ではなく AWS EFS CSI Driver Operator を必ず選択してください。AWS EFS Operator はコミュニティー Operator であり、Red Hat ではサポートしていません。

   1. AWS EFS CSI Driver Operator ページで Install をクリックします。

   2. Install Operator のページで、以下のことを確認してください。

      • AWS EFS と AWS Secure Token Service (STS) を使用している場合は、role ARN フィールドに、セキュリティートークンサービスの Amazon リソース名ロールの取得 に記載されている最後の手順からコピーした ARN ロールを入力します。
      • All namespaces on the cluster (default) が選択されている。
      • Installed Namespace が 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. 以下の条件が "True" に変わるのを待ちます。

   • AWSEFSDriverNodeServiceControllerAvailable
   • AWSEFSDriverControllerServiceControllerAvailable

1. Administration > CustomResourceDefinitions をクリックします。
2. CustomResourceDefinitions ページの Name ドロップダウンボックスの横に、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: ファイルシステムごとに、goroutine でボリュームメトリクスを処理するためのレート制限を定義します。このフィールドを空白のままにすると、適切なデフォルトが選択されますが、これは時間の経過とともに変更される可能性があります。現在のデフォルトは 5 つの goroutine です。有効な範囲は 1 - 100 の goroutine です。
7. Save をクリックします。

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: ファイルシステムごとに、goroutine でボリュームメトリクスを処理するためのレート制限を定義します。このフィールドを空白のままにすると、適切なデフォルトが選択されますが、これは時間の経過とともに変更される可能性があります。現在のデフォルトは 5 つの goroutine です。有効な範囲は 1 - 100 の goroutine です。
4. efs.csi.aws.com オブジェクトへの変更を保存します。