部署适用于 Lustre 的 FSx 驱动程序

设置一些要在其余步骤中使用的变量。请将 my-csi-fsx-cluster 替换为要创建的测试集群的名称，并将 region-code 替换为要在其中创建测试集群的 Amazon 区域。

export cluster_name=my-csi-fsx-cluster
export region_code=region-code

创建测试集群。

eksctl create cluster \
  --name $cluster_name \
  --region $region_code \
  --with-oidc \
  --ssh-access \
  --ssh-public-key my-key

集群预配置需要几分钟时间。在集群创建过程中，您将看到几行输出。输出的最后一行类似于以下示例行。

[✓]  EKS cluster "my-csi-fsx-cluster" in "region-code" region is ready

使用以下命令为驱动程序创建一个 Kubernetes 服务账户，并将 AmazonFSxFullAccess Amazon 托管式策略附加到该服务账户。

eksctl create iamserviceaccount \
  --name fsx-csi-controller-sa \
  --namespace kube-system \
  --cluster $cluster_name \
  --attach-policy-arn arn:aws-cn:iam::aws:policy/AmazonFSxFullAccess \
  --approve \
  --role-name AmazonEKSFSxLustreCSIDriverFullAccess \
  --region $region_code

创建服务账户时，您将看到几行输出。输出的最后一行类似于以下行。

[ℹ]  1 task: {
    2 sequential sub-tasks: {
        create IAM role for serviceaccount "kube-system/fsx-csi-controller-sa",
        create serviceaccount "kube-system/fsx-csi-controller-sa",
    } }
[ℹ]  building iamserviceaccount stack "eksctl-my-csi-fsx-cluster-addon-iamserviceaccount-kube-system-fsx-csi-controller-sa"
[ℹ]  deploying stack "eksctl-my-csi-fsx-cluster-addon-iamserviceaccount-kube-system-fsx-csi-controller-sa"
[ℹ]  waiting for CloudFormation stack "eksctl-my-csi-fsx-cluster-addon-iamserviceaccount-kube-system-fsx-csi-controller-sa"
[ℹ]  created serviceaccount "kube-system/fsx-csi-controller-sa"

记录已部署的 Amazon CloudFormation 堆栈的名称。在上面的示例输出中，堆栈的名称为 eksctl-my-csi-fsx-cluster-addon-iamserviceaccount-kube-system-fsx-csi-controller-sa。

使用以下命令部署驱动程序。将 release-X.XX 替换为所需的分支。不支持主分支，因为它可能包含与当前发布的稳定版本驱动程序不兼容的即将推出的功能。建议使用最新发布的版本。有关分支的列表，请参阅 GitHub 上的 aws-fsx-csi-driver Branches。

kubectl apply -k "github.com/kubernetes-sigs/aws-fsx-csi-driver/deploy/kubernetes/overlays/stable/?ref=release-X.XX"

示例输出如下。

serviceaccount/fsx-csi-controller-sa created
serviceaccount/fsx-csi-node-sa created
clusterrole.rbac.authorization.k8s.io/fsx-csi-external-provisioner-role created
clusterrole.rbac.authorization.k8s.io/fsx-external-resizer-role created
clusterrolebinding.rbac.authorization.k8s.io/fsx-csi-external-provisioner-binding created
clusterrolebinding.rbac.authorization.k8s.io/fsx-csi-resizer-binding created
deployment.apps/fsx-csi-controller created
daemonset.apps/fsx-csi-node created
csidriver.storage.k8s.io/fsx.csi.aws.com created

记录所创建角色的 ARN。如果您早些时候没有注意到它并且没有在 Amazon CLI 输出中再提供它，您可以执行以下操作以在 Amazon Web Services Management Console中查看它。

使用以下命令修补驱动程序部署以添加之前创建的服务账户。将 ARN 替换为您记下的 ARN。请将 111122223333 替换为您的账户 ID。

kubectl annotate serviceaccount -n kube-system fsx-csi-controller-sa \
  eks.amazonaws.com/role-arn=arn:aws-cn:iam::111122223333:role/AmazonEKSFSxLustreCSIDriverFullAccess --overwrite=true

示例输出如下。

serviceaccount/fsx-csi-controller-sa annotated

注意集群的安全组。您可以在 Amazon Web Services Management Console中的联网部分下或通过使用以下 Amazon CLI 命令来查看它。

aws eks describe-cluster --name $cluster_name --query cluster.resourcesVpcConfig.clusterSecurityGroupId

根据《Amazon FSx for Lustre 用户指南》中的 Amazon VPC 安全组显示的标准，为您的 Amazon FSx 文件系统创建安全组。对于 VPC，选择 Networking（联网）部分下显示的集群的 VPC。对于“与 Lustre 客户端关联的安全组”，请使用您的集群安全组。您可以单独保留出站规则以允许所有流量。

使用下面的命令下载存储类清单。

curl -O https://raw.githubusercontent.com/kubernetes-sigs/aws-fsx-csi-driver/master/examples/kubernetes/dynamic_provisioning/specs/storageclass.yaml

编辑 storageclass.yaml 文件的参数部分。将所有 example value 替换为您自己的值。

parameters:
  subnetId: subnet-0eabfaa81fb22bcaf
  securityGroupIds: sg-068000ccf82dfba88
  deploymentType: PERSISTENT_1
  automaticBackupRetentionDays: "1"
  dailyAutomaticBackupStartTime: "00:00"
  copyTagsToBackups: "true"
  perUnitStorageThroughput: "200"
  dataCompressionType: "NONE"
  weeklyMaintenanceStartTime: "7:09:00"
  fileSystemTypeVersion: "2.12"

创建存储类清单。

kubectl apply -f storageclass.yaml

示例输出如下。

storageclass.storage.k8s.io/fsx-sc created

下载持久卷注册清单。

curl -O https://raw.githubusercontent.com/kubernetes-sigs/aws-fsx-csi-driver/master/examples/kubernetes/dynamic_provisioning/specs/claim.yaml

（可选）编辑 claim.yaml 文件。根据您的存储需求和上一步选择的 deploymentType，将 1200Gi 更改为下面列出的增量值之一。

storage: 1200Gi

创建持久卷注册。

kubectl apply -f claim.yaml

示例输出如下。

persistentvolumeclaim/fsx-claim created

确认已预配置文件系统。

kubectl describe pvc

示例输出如下。

Name:          fsx-claim
Namespace:     default
StorageClass:  fsx-sc
Status:        Bound
[...]

部署示例应用程序。

kubectl apply -f https://raw.githubusercontent.com/kubernetes-sigs/aws-fsx-csi-driver/master/examples/kubernetes/dynamic_provisioning/specs/pod.yaml

验证示例应用程序正在运行。

kubectl get pods

示例输出如下。

NAME      READY   STATUS              RESTARTS   AGE
fsx-app   1/1     Running             0          8s

验证应用程序是否正确挂载了文件系统。

kubectl exec -ti fsx-app -- df -h

示例输出如下。

Filesystem                   Size  Used Avail Use% Mounted on
overlay                       80G  4.0G   77G   5% /
tmpfs                         64M     0   64M   0% /dev
tmpfs                        3.8G     0  3.8G   0% /sys/fs/cgroup
192.0.2.0@tcp:/abcdef01      1.1T  7.8M  1.1T   1% /data
/dev/nvme0n1p1                80G  4.0G   77G   5% /etc/hosts
shm                           64M     0   64M   0% /dev/shm
tmpfs                        6.9G   12K  6.9G   1% /run/secrets/kubernetes.io/serviceaccount
tmpfs                        3.8G     0  3.8G   0% /proc/acpi
tmpfs                        3.8G     0  3.8G   0% /sys/firmware

验证示例应用程序已将数据写入 FSx for Lustre 文件系统。

kubectl exec -it fsx-app -- ls /data

示例输出如下。

out.txt

此示例输出显示示例应用程序成功编写了 out.txt 文件到文件系统。