Documentation survey

ボリュームとストレージ

データを保持する必要があるアプリケーションをデプロイする際には、永続ストレージを作成する必要があります。永続ストレージを使用すると、アプリケーションのデータをアプリケーションを実行しているポッドの外部に保存できます。このストレージの方法により、アプリケーションのポッドが失敗してもアプリケーションデータを保持できます。

永続ボリューム（PV）はKubernetesクラスター内のストレージの一部であり、永続ボリュームクレーム（PVC）はストレージの要求です。PVとPVCの動作の詳細については、公式Kubernetesドキュメントのストレージを参照してください。

K3s, as a compliant Kubernetes distribution, uses the Container Storage Interface (CSI) and Cloud Provider Interface (CPI) to manage persistent storage.

このページでは、ローカルストレージプロバイダーまたはLonghornを使用して永続ストレージを設定する方法について説明します。

ローカルストレージプロバイダーの設定

K3sにはRancherのLocal Path Provisionerが付属しており、これにより、対応するノード上のローカルストレージを使用して永続ボリュームクレームをすぐに作成する機能が有効になります。以下に簡単な例を示します。詳細については、公式ドキュメントをこちらで参照してください。

hostPathをバックにした永続ボリュームクレームとそれを利用するポッドを作成します：

pvc.yaml

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: local-path-pvc
  namespace: default
spec:
  accessModes:
    - ReadWriteOnce
  storageClassName: local-path
  resources:
    requests:
      storage: 2Gi

pod.yaml

apiVersion: v1
kind: Pod
metadata:
  name: volume-test
  namespace: default
spec:
  containers:
  - name: volume-test
    image: nginx:stable-alpine
    imagePullPolicy: IfNotPresent
    volumeMounts:
    - name: volv
      mountPath: /data
    ports:
    - containerPort: 80
  volumes:
  - name: volv
    persistentVolumeClaim:
      claimName: local-path-pvc

yamlを適用します：

kubectl create -f pvc.yaml
kubectl create -f pod.yaml

PVとPVCが作成されたことを確認します：

kubectl get pv
kubectl get pvc

ステータスはそれぞれBoundである必要があります。

Longhornの設定

LonghornはARM32をサポートしていません。

K3sは、Kubernetes用のオープンソースの分散ブロックストレージシステムであるLonghornをサポートしています。

以下に簡単な例を示します。詳細については、https://documentation.suse.com/cloudnative/storage/1.8/en/longhorn-documentation.html[公式ドキュメント]を参照してください。

longhorn.yamlを適用してLonghornをインストールします：

kubectl apply -f https://raw.githubusercontent.com/longhorn/longhorn/v1.8.1/deploy/longhorn.yaml

Longhornはlonghorn-systemという名前空間にインストールされます。

Create a persistent volume claim and a pod to utilize it:

pvc.yaml

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: longhorn-volv-pvc
spec:
  accessModes:
    - ReadWriteOnce
  storageClassName: longhorn
  resources:
    requests:
      storage: 2Gi

pod.yaml

apiVersion: v1
kind: Pod
metadata:
  name: volume-test
  namespace: default
spec:
  containers:
  - name: volume-test
    image: nginx:stable-alpine
    imagePullPolicy: IfNotPresent
    volumeMounts:
    - name: volv
      mountPath: /data
    ports:
    - containerPort: 80
  volumes:
  - name: volv
    persistentVolumeClaim:
      claimName: longhorn-volv-pvc

PVCとポッドを作成するためにyamlを適用します：

kubectl create -f pvc.yaml
kubectl create -f pod.yaml

PVとPVCが作成されたことを確認します：

kubectl get pv
kubectl get pvc

ステータスはそれぞれBoundである必要があります。