IAMロールとAWS Secrets Managerシークレットを作成する
KubernetesポッドがAWSリソースにアクセスするように設定するには、明示的なAWSクレデンシャルを指定する代わりに、AWS IAMロールとして認証します。
|
|
AWS IAMロールを使用して認証するには、Amazon EKSまたはRed Hat OpenShiftを使用してデプロイされたKubernetesクラスターが必要です。 |
AWS Secrets Managerシークレットの作成
TridentがFSx for ONTAP SVM上のストレージを管理するには、認証情報が必要です。 `vsadmin`認証情報をAWS Secrets Managerのシークレットに保存します。
次の例では、Trident CSIクレデンシャルを格納するAWS Secrets Managerシークレットを作成します。
aws secretsmanager create-secret --name trident-secret --description "Trident CSI credentials" \
--secret-string "{\"username\":\"vsadmin\",\"password\":\"<svm_password>\"}"
IAMポリシーを作成する
Tridentを正しく実行するには、AWSの権限も必要です。そのため、必要な権限をTridentに付与するポリシーを作成する必要があります。
次の例では、AWS CLIを使用してIAMポリシーを作成します:
aws iam create-policy --policy-name AmazonFSxNCSIDriverPolicy --policy-document file://policy.json \
--description "This policy grants Trident CSI access to FSx for ONTAP and AWS Secrets Manager" \
--query Policy.Arn --output text
このコマンドはポリシーARNを返します。以下のコマンドで使用してください。
ポリシーJSONの例:
{
"Statement": [
{
"Action": [
"fsx:DescribeFileSystems",
"fsx:DescribeVolumes",
"fsx:CreateVolume",
"fsx:RestoreVolumeFromSnapshot",
"fsx:DescribeStorageVirtualMachines",
"fsx:UntagResource",
"fsx:UpdateVolume",
"fsx:TagResource",
"fsx:DeleteVolume"
],
"Effect": "Allow",
"Resource": "*"
},
{
"Action": "secretsmanager:GetSecretValue",
"Effect": "Allow",
"Resource": "arn:aws:secretsmanager:<aws-region>:<aws-account-id>:secret:<aws-secret-manager-name>*"
}
],
"Version": "2012-10-17"
}
Pod Identity用のIAMロール、またはサービスアカウント(IRSA)用のIAMロールを作成します
EKS Pod Identityまたはサービスアカウント用のIAMロール(IRSA)を使用して、KubernetesサービスアカウントがAWS Identity and Access Management(IAM)ロールを引き受けるように構成できます。サービスアカウントを使用するように構成されたPodは、そのロールがアクセスを許可されているAWSサービスにアクセスできるようになります。
Amazon EKS ポッドアイデンティティの関連付けは、Amazon EC2 インスタンスプロファイルが Amazon EC2 インスタンスに認証情報を提供するのと同様に、アプリケーションの認証情報を管理する機能を提供します。
EKS クラスターに Pod Identity をインストールします:
AWS コンソールまたは次の AWS CLI コマンドを使用して、Pod ID を作成できます。
aws eks create-addon --cluster-name <EKS_CLUSTER_NAME> --addon-name eks-pod-identity-agent
詳細については、"Amazon EKS ポッドアイデンティティエージェントを設定する"を参照してください。
trust-relationship.json を作成:
EKS サービスプリンシパルがポッド ID に対してこのロールを引き受けられるように、trust-relationship.json を作成します。次に、以下の信頼ポリシーを持つロールを作成します。
aws iam create-role \ --role-name fsxn-csi-role --assume-role-policy-document file://trust-relationship.json \ --description "fsxn csi pod identity role"
trust-relationship.json ファイル:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "pods.eks.amazonaws.com"
},
"Action": [
"sts:AssumeRole",
"sts:TagSession"
]
}
]
}
IAM ロールにロールポリシーをアタッチします:
前の手順のロールポリシーを、作成した IAM ロールにアタッチします。
aws iam attach-role-policy \ --policy-arn arn:aws:iam::aws:111122223333:policy/fsxn-csi-policy \ --role-name fsxn-csi-role
ポッド ID の関連付けを作成する:
IAMロールとTridentサービスアカウントの間にPod IDの関連付けを作成します(trident-controller)。
aws eks create-pod-identity-association \ --cluster-name <EKS_CLUSTER_NAME> \ --role-arn arn:aws:iam::111122223333:role/fsxn-csi-role \ --namespace trident --service-account trident-controller
AWS CLI の使用:
aws iam create-role --role-name AmazonEKS_FSxN_CSI_DriverRole \ --assume-role-policy-document file://trust-relationship.json
-
trust-relationship.jsonファイル:*
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Federated": "arn:aws:iam::<account_id>:oidc-provider/<oidc_provider>"
},
"Action": "sts:AssumeRoleWithWebIdentity",
"Condition": {
"StringEquals": {
"<oidc_provider>:aud": "sts.amazonaws.com",
"<oidc_provider>:sub": "system:serviceaccount:trident:trident-controller"
}
}
}
]
}
ファイルの次の値を更新し `trust-relationship.json`ます。
-
<account_id> - AWSアカウントID
-
<oidc_provider> - EKSクラスターのOIDCプロバイダーURL。以下のコマンドを実行することで入手できます:
aws eks describe-cluster --name my-cluster --query "cluster.identity.oidc.issuer" \ --output text | sed -e "s/^https:\/\///"
IAMポリシーをIAMロールにアタッチします:
ロールを作成したら、次のコマンドを使用して(上記の手順で作成した)ポリシーをロールに関連付けます。
aws iam attach-role-policy --role-name my-role --policy-arn <IAM policy ARN>
OIDCプロバイダーの関連付けを確認します:
次のコマンドを実行して、OIDCプロバイダがクラスタに関連付けられていることを確認してください:
aws iam list-open-id-connect-providers | grep $oidc_id | cut -d "/" -f4
出力が空の場合は、次のコマンドを使用してIAM OIDCをクラスタに関連付けます。
eksctl utils associate-iam-oidc-provider --cluster $cluster_name --approve
`eksctl`を使用している場合は、次の例を使用してEKSのサービスアカウントにIAMロールを作成します:
eksctl create iamserviceaccount --name trident-controller --namespace trident \
--cluster <my-cluster> --role-name AmazonEKS_FSxN_CSI_DriverRole --role-only \
--attach-policy-arn <IAM-Policy ARN> --approve
自己管理型OpenShiftデプロイメントでは、IAMロールを作成し、それらをクラスタノードにアタッチします。各ノードに割り当てられたロールにTrident IAMポリシーをアタッチします。
クラスター内のノードのインスタンスIDを確認するには、次のコマンドを実行します:
oc get nodes -o jsonpath='{range .items[*]}{.spec.providerID}{"\n"}{end}'
各インスタンスに関連付けられているIAMロールを確認するには、各インスタンスに対して次のコマンドを実行します:
aws ec2 describe-instances --instance-ids <instance-id> --query 'Reservations[*].Instances[*].IamInstanceProfile.Arn' --output text
以下のコマンドを実行して、各ロールにIAMポリシーをアタッチします:
aws iam attach-role-policy --role-name <role-name> --policy-arn <IAM policy ARN>