ホーム
製品
OpenShift Container Platform
4.16
ストレージ
5.3. hostPath を使用した永続ストレージ

5.3. hostPath を使用した永続ストレージ

OpenShift Container Platform クラスター内の hostPath ボリュームは、ファイルまたはディレクトリーをホストノードのファイルシステムから Pod にマウントします。ほとんどの Pod には hostPath ボリュームは必要ありませんが、アプリケーションが必要とする場合は、テスト用のクイックオプションが提供されます。

重要

クラスター管理者は、特権付き Pod として実行するように Pod を設定する必要があります。これにより、同じノードの Pod へのアクセスが付与されます。

5.3.1. 概要
リンクのコピー

OpenShift Container Platform はシングルノードクラスターでの開発およびテスト用の hostPath マウントをサポートします。

実稼働クラスターでは、hostPath を使用しません。代わりにクラスター管理者は、GCE Persistent Disk ボリューム、NFS 共有、Amazon EBS ボリュームなどのネットワークリソースをプロビジョニングします。ネットワークリソースは、ストレージクラスを使用した動的プロビジョニングの設定をサポートします。

hostPath ボリュームは静的にプロビジョニングする必要があります。

重要

コンテナーのルート (/) や、ホストとコンテナーで同じパスにはマウントしないでください。これは、コンテナーに十分な特権が付与されている場合、ホストシステムを破壊する可能性があります。ホストをマウントするには、/host を使用するのが安全です。以下の例では、ホストの / ディレクトリーが /host でコンテナーにマウントされています。

apiVersion: v1
kind: Pod
metadata:
  name: test-host-mount
spec:
  containers:
  - image: registry.access.redhat.com/ubi9/ubi
    name: test-container
    command: ['sh', '-c', 'sleep 3600']
    volumeMounts:
    - mountPath: /host
      name: host-slash
  volumes:
   - name: host-slash
     hostPath:
       path: /
       type: ''

apiVersion: v1
kind: Pod
metadata:
  name: test-host-mount
spec:
  containers:
  - image: registry.access.redhat.com/ubi9/ubi
    name: test-container
    command: ['sh', '-c', 'sleep 3600']
    volumeMounts:
    - mountPath: /host
      name: host-slash
  volumes:
   - name: host-slash
     hostPath:
       path: /
       type: ''

Copy to Clipboard

Toggle word wrap

5.3.2. hostPath ボリュームの静的なプロビジョニング
リンクのコピー

hostPath ボリュームを使用する Pod は、手動の (静的) プロビジョニングで参照される必要があります。

手順

PersistentVolume オブジェクト定義を含む pv.yaml ファイルを作成して、永続ボリューム (PV) を定義します。
```
apiVersion: v1
kind: PersistentVolume
metadata:
  name: task-pv-volume 
  labels:
    type: local
spec:
  storageClassName: manual 
  capacity:
    storage: 5Gi
  accessModes:
    - ReadWriteOnce 
  persistentVolumeReclaimPolicy: Retain
  hostPath:
    path: "/mnt/data" 
```
```
apiVersion: v1
kind: PersistentVolume
metadata:
  name: task-pv-volume 
```
1
```
  labels:
    type: local
spec:
  storageClassName: manual 
```
2
```
  capacity:
    storage: 5Gi
  accessModes:
    - ReadWriteOnce 
```
3
```
  persistentVolumeReclaimPolicy: Retain
  hostPath:
    path: "/mnt/data" 
```
4
Copy to Clipboard Toggle word wrap
1
ボリュームの名前。この名前は、永続ボリューム (PV) 要求または Pod がボリュームが識別するために使用されます。
2
永続ボリューム要求 (PVC) リクエストを PV にバインドするために使用されます。
3
ボリュームはシングルノードで read-write としてマウントできます。
4
設定ファイルでは、ボリュームがクラスターのノードの /mnt/data にあるように指定します。ホストシステムの破損を避けるため、コンテナーのルート (/) や、ホストとコンテナーで同じになるパスにマウントしないでください。/host を使用してホストを安全にマウントできます
ファイルから PV を作成します。
```
oc create -f pv.yaml
```
```
$ oc create -f pv.yaml
```
Copy to Clipboard Toggle word wrap

PersistentVolumeClaim オブジェクト定義を含む pvc.yaml ファイルを作成して PVC を定義します。

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: task-pvc-volume
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 1Gi
  storageClassName: manual

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: task-pvc-volume
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 1Gi
  storageClassName: manual

Copy to Clipboard

Toggle word wrap

ファイルから PVC を作成します。
```
oc create -f pvc.yaml
```
```
$ oc create -f pvc.yaml
```
Copy to Clipboard Toggle word wrap

5.3.3. 特権付き Pod での hostPath 共有のマウント
リンクのコピー

永続ボリューム要求の作成後に、これをアプリケーション内で使用できます。以下の例は、この共有を Pod 内にマウントする方法を示しています。

前提条件

基礎となる hostPath 共有にマップされる永続ボリューム要求があること。

手順

既存の永続ボリューム要求をマウントする特権付き Pod を作成します。
```
apiVersion: v1
kind: Pod
metadata:
  name: pod-name 
spec:
  containers:
    ...
    securityContext:
      privileged: true 
    volumeMounts:
    - mountPath: /data 
      name: hostpath-privileged
  ...
  securityContext: {}
  volumes:
    - name: hostpath-privileged
      persistentVolumeClaim:
        claimName: task-pvc-volume 
```
```
apiVersion: v1
kind: Pod
metadata:
  name: pod-name 
```
1
```
spec:
  containers:
    ...
    securityContext:
      privileged: true 
```
2
```
    volumeMounts:
    - mountPath: /data 
```
3
```
      name: hostpath-privileged
  ...
  securityContext: {}
  volumes:
    - name: hostpath-privileged
      persistentVolumeClaim:
        claimName: task-pvc-volume 
```
4
Copy to Clipboard Toggle word wrap
1
Pod の名前。
2
Pod は、ノードのストレージにアクセスするために特権付き Pod として実行される必要があります。
3
特権付き Pod 内にホストパス共有をマウントするパス。コンテナーのルート (/) や、ホストとコンテナーで同じパスにはマウントしないでください。これは、コンテナーに十分な特権が付与されている場合に、ホストシステムを破壊する可能性があります (例: ホストの /dev/pts ファイル)。ホストをマウントするには、/host を使用するのが安全です。
4
以前に作成された PersistentVolumeClaim オブジェクトの名前。

トップに戻る

5.3. hostPath を使用した永続ストレージ

5.3.1. 概要
リンクのコピー

5.3.2. hostPath ボリュームの静的なプロビジョニング
リンクのコピー

5.3.3. 特権付き Pod での hostPath 共有のマウント
リンクのコピー

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

5.3. hostPath を使用した永続ストレージ

5.3.1. 概要リンクのコピーリンクがクリップボードにコピーされました!

5.3.2. hostPath ボリュームの静的なプロビジョニングリンクのコピーリンクがクリップボードにコピーされました!

5.3.3. 特権付き Pod での hostPath 共有のマウントリンクのコピーリンクがクリップボードにコピーされました!

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

5.3.1. 概要
リンクのコピー

5.3.2. hostPath ボリュームの静的なプロビジョニング
リンクのコピー

5.3.3. 特権付き Pod での hostPath 共有のマウント
リンクのコピー