Amazon EBS CSI驱动程序允许EKS集群管理EBS卷的生命周期,当我们运行在EKS中的pod需要挂载EBS盘进行持久化存储时,必须先安装好EBS CSI驱动,具体可以参考Amazon EBS CSI driver。
权限设置
为EBS CSI Driver创建IAM role
Amazon EBS CSI 驱动需要 IAM 权限才能代表您调用 AWS API,所以我们需要先创建EBS CSI Driver的IAM Role
查看当前集群的OIDC信息
aws eks describe-cluster --name <eks-cluster-name> --query "cluster.identity.oidc.issuer" --output text
将上一步读取到的OIDC信息补充下面的json模板中,并保存为aws-ebs-csi-driver-trust-policy.json
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Federated": "arn:aws:iam::<aws-account-id>:oidc-provider/oidc.eks.<aws-region>.amazonaws.com/id/<oidc-id>"
},
"Action": "sts:AssumeRoleWithWebIdentity",
"Condition": {
"StringEquals": {
"oidc.eks.<aws-region>.amazonaws.com/id/<oidc-id>:aud": "sts.amazonaws.com",
"oidc.eks.<aws-region>.amazonaws.com/id/<oidc-id>:sub": "system:serviceaccount:kube-system:ebs-csi-controller-sa"
}
}
},
{
"Effect": "Allow",
"Principal": {
"Service": "pods.eks.amazonaws.com"
},
"Action": [
"sts:AssumeRole",
"sts:TagSession"
]
}
]
}
其中需要系替换的是<aws-account-id>、<aws-region>和OIDC的<oidc-id>,如图中红色部分
进行EBS CSI Driver的IAM Role的创建,role名称为AmazonEKS_EBS_CSI_DriverRole,执行下面的命令:
# 设置role名称为AmazonEKS_EBS_CSI_DriverRole
aws iam create-role --role-name AmazonEKS_EBS_CSI_DriverRole --assume-role-policy-document file://aws-ebs-csi-driver-trust-policy.json
# 为AmazonEKS_EBS_CSI_DriverRole附加policy
aws iam attach-role-policy --policy-arn arn:aws:iam::aws:policy/service-role/AmazonEBSCSIDriverPolicy --role-name AmazonEKS_EBS_CSI_DriverRole
如果你不需要使用自定义的KMS对EBS盘进行静态加密,那么role到这里就完成了。否则你需要额外的创建policy并继续附加到AmazonEKS_EBS_CSI_DriverRole,详情请看csi-iam-role。
CSI addon安装
我们可以直接使用命令行进行addon安装,其中role arn需要填写我们刚才创建的AmazonEKS_EBS_CSI_DriverRole的arn
aws eks create-addon --cluster-name <eks-cluster-name> --addon-name aws-ebs-csi-driver --service-account-role-arn arn:aws:iam::843xxxx1269:role/AmazonEKS_EBS_CSI_DriverRole
执行完成后,我们可以在AWS控制台上看到EBS CSI驱动正在被安装,只需要略微等待即可完成。我们会看到CSI驱动安装完成,并使用了AmazonEKS_EBS_CSI_DriverRole
此外我们使用eksctl也可以进行快速的查询
查询EBS CSI addon的版本
aws eks describe-addon-versions --addon-name aws-ebs-csi-driver
查询EBS CSI addon的详细信息
eksctl get addon --name aws-ebs-csi-driver --cluster <eks-cluster-name>
测试
后面你可以自行参考Deploy a sample application and verify that the CSI driver is working来对我们前面安装好的EBS CSI驱动进行功能测试