メインコンテンツまでスキップ

FSx for OpenZFSを使用した動的プロビジョニング

FSx for OpenZFSのKubernetes用ストレージクラスについて理解したところで、永続ボリュームを作成し、UIコンポーネントを変更してこのボリュームをマウントしましょう。

まず、fsxzpvcclaim.yamlファイルを確認しましょう：

~/environment/eks-workshop/modules/fundamentals/storage/fsxz/deployment/fsxzpvcclaim.yaml
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: fsxz-claim
  namespace: ui
spec:
  accessModes:
    - ReadWriteMany
  storageClassName: fsxz-vol-sc
  resources:
    requests:
      storage: 1Gi
A

定義されているリソースはPersistentVolumeClaimです

B

これは先ほど作成したfsxz-vol-scストレージクラスを参照しています

C

1GBのストレージを要求しています

次に、UIコンポーネントを更新してFSx for OpenZFS PVCを参照するようにします：

~/environment/eks-workshop/modules/fundamentals/storage/fsxz/deployment/deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: ui
spec:
  replicas: 2
  template:
    spec:
      containers:
        - name: ui
          volumeMounts:
            - name: fsxzvolume
              mountPath: /fsxz
          env:
            - name: RETAIL_UI_PRODUCT_IMAGES_PATH
              value: /fsxz
      volumes:
        - name: fsxzvolume
          persistentVolumeClaim:
            claimName: fsxz-claim

以下のコマンドでこれらの変更を適用しましょう：

~$kubectl apply -k ~/environment/eks-workshop/modules/fundamentals/storage/fsxz/deployment
namespace/ui unchanged
serviceaccount/ui unchanged
configmap/ui unchanged
service/ui unchanged
persistentvolumeclaim/fsxz-claim created
deployment.apps/ui configured
~$kubectl rollout status --timeout=130s deployment/ui -n ui


デプロイメントのvolumeMountsを確認しましょう。fsxzvolumeという名前の新しいボリュームが/fsxzにマウントされていることに注目してください：


~$kubectl get deployment -n ui \
  -o yaml | yq '.items[].spec.template.spec.containers[].volumeMounts'
- mountPath: /fsxz
  name: fsxzvolume
- mountPath: /tmp
  name: tmp-volume


PersistentVolumeClaimを満たすために、PersistentVolume（PV）が自動的に作成されました：


~$kubectl get pv
NAME                                       CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS   CLAIM                                 STORAGECLASS   REASON   AGE
pvc-342a674d-b426-4214-b8b6-7847975ae121   1Gi        RWX            Delete           Bound    ui/fsxz-claim                      fsxz-vol-sc                  2m33s


PersistentVolumeClaim（PVC）の詳細を確認しましょう：


~$kubectl describe pvc -n ui
Name:          fsxz-claim
Namespace:     ui
StorageClass:  fsxz-vol-sc
Status:        Bound
Volume:        pvc-342a674d-b426-4214-b8b6-7847975ae121
Labels:        <none>
Annotations:   pv.kubernetes.io/bind-completed: yes
               pv.kubernetes.io/bound-by-controller: yes
               volume.beta.kubernetes.io/storage-provisioner: fsx.openzfs.csi.aws.com
               volume.kubernetes.io/storage-provisioner: fsx.openzfs.csi.aws.com
Finalizers:    [kubernetes.io/pvc-protection]
Capacity:      5Gi
Access Modes:  RWX
VolumeMode:    Filesystem
Used By:       <none>
Events:
  Type    Reason                 Age   From                                                                                      Message
  ----    ------                 ----  ----                                                                                      -------
  Normal  ExternalProvisioning   34s   persistentvolume-controller                                                               waiting for a volume to be created, either by external provisioner "fsx.openzfs.csi.aws.com" or manually created by system administrator
  Normal  Provisioning           34s   fsx.openzfs.csi.aws.com_fsx-openzfs-csi-controller-6b9cdcddf6-kwx7p_35a063fc-5d91-4ba1-9bce-4d71de597b14  External provisioner is provisioning volume for claim "ui/fsxz-claim"
  Normal  ProvisioningSucceeded  33s   fsx.openzfs.csi.aws.com_fsx-openzfs-csi-controller-6b9cdcddf6-kwx7p_35a063fc-5d91-4ba1-9bce-4d71de597b14  Successfully provisioned volume pvc-342a674d-b426-4214-b8b6-7847975ae121


この時点で、FSx for OpenZFSファイルシステムは正常にマウントされていますが、現在は空です：


~$POD_1=$(kubectl -n ui get pods -l app.kubernetes.io/instance=ui -o jsonpath='{.items[0].metadata.name}')
~$kubectl exec --stdin $POD_1 -n ui -- bash -c 'ls /fsxz/'


Kubernetesジョブを使用して、FSx for OpenZFSボリュームに画像を配置しましょう：


~$export PVC_NAME="fsxz-claim"
~$cat ~/environment/eks-workshop/modules/fundamentals/storage/populate-images-job.yaml | envsubst | kubectl apply -f -
~$kubectl wait --for=condition=complete -n ui \
  job/populate-images --timeout=300s


次に、UIコンポーネントPodの1つを通じて/fsxzの現在のファイルを一覧表示して、共有ストレージ機能を実証しましょう：


~$POD_1=$(kubectl -n ui get pods -l app.kubernetes.io/instance=ui -o jsonpath='{.items[0].metadata.name}')
~$kubectl exec --stdin $POD_1 -n ui -- bash -c 'ls /fsxz/'
1ca35e86-4b4c-4124-b6b5-076ba4134d0d.jpg
4f18544b-70a5-4352-8e19-0d070f46745d.jpg
631a3db5-ac07-492c-a994-8cd56923c112.jpg
79bce3f3-935f-4912-8c62-0d2f3e059405.jpg
8757729a-c518-4356-8694-9e795a9b3237.jpg
87e89b11-d319-446d-b9be-50adcca5224a.jpg
a1258cd2-176c-4507-ade6-746dab5ad625.jpg
cc789f85-1476-452a-8100-9e74502198e0.jpg
d27cf49f-b689-4a75-a249-d373e0330bb5.jpg
d3104128-1d14-4465-99d3-8ab9267c687b.jpg
d4edfedb-dbe9-4dd9-aae8-009489394955.jpg
d77f9ae6-e9a8-4a3e-86bd-b72af75cbc49.jpg


さらに共有ストレージ機能を実証するために、最初のPodを通じてplaceholder.jpgという新しい画像を作成し、FSx for OpenZFSボリュームに追加しましょう：


~$POD_1=$(kubectl -n ui get pods -l app.kubernetes.io/instance=ui -o jsonpath='{.items[0].metadata.name}')
~$kubectl exec --stdin $POD_1 -n ui -- bash -c 'curl -sS -o /fsxz/placeholder.jpg https://placehold.co/600x400/jpg?text=EKS+Workshop\\nPlaceholder'


次に、2番目のUIPodがこの新しく作成されたファイルにアクセスできることを確認し、FSx for OpenZFSストレージの共有特性を実証しましょう：


~$POD_2=$(kubectl -n ui get pods -o jsonpath='{.items[1].metadata.name}')
~$kubectl exec --stdin $POD_2 -n ui -- bash -c 'ls /fsxz/'
1ca35e86-4b4c-4124-b6b5-076ba4134d0d.jpg
4f18544b-70a5-4352-8e19-0d070f46745d.jpg
631a3db5-ac07-492c-a994-8cd56923c112.jpg
79bce3f3-935f-4912-8c62-0d2f3e059405.jpg
8757729a-c518-4356-8694-9e795a9b3237.jpg
87e89b11-d319-446d-b9be-50adcca5224a.jpg
a1258cd2-176c-4507-ade6-746dab5ad625.jpg
cc789f85-1476-452a-8100-9e74502198e0.jpg
d27cf49f-b689-4a75-a249-d373e0330bb5.jpg
d3104128-1d14-4465-99d3-8ab9267c687b.jpg
d4edfedb-dbe9-4dd9-aae8-009489394955.jpg
d77f9ae6-e9a8-4a3e-86bd-b72af75cbc49.jpg
placeholder.jpg      <----------------


ご覧のとおり、最初のPodを通じてファイルを作成しましたが、2番目のPodはすぐにそれにアクセスできます。これは、両方のPodが同じ共有FSx for OpenZFSファイルシステムにアクセスしているためです。


最後に、UIサービスを通じて画像にアクセスできることを確認しましょう：


~$LB_HOSTNAME=$(kubectl -n ui get service ui-nlb -o jsonpath='{.status.loadBalancer.ingress[*].hostname}{"\n"}')
~$echo "http://$LB_HOSTNAME/assets/img/products/placeholder.jpg"
http://k8s-ui-uinlb-647e781087-6717c5049aa96bd9.elb.us-west-2.amazonaws.com/assets/img/products/placeholder.jpg


ブラウザでURLにアクセスしてください：


http://k8s-ui-uinlb-647e781087-6717c5049aa96b...


Amazon FSx for OpenZFSがAmazon EKSで実行されるワークロードに永続的な共有ストレージを提供する方法を正常に実証しました。このソリューションにより、複数のポッドが同時に同じストレージボリュームから読み取りおよび書き込みを行うことができ、共有コンテンツホスティングやハイパフォーマンスでエンタープライズ機能を備えた分散ファイルシステムアクセスを必要とする他のユースケースに最適です。