1.5. Podman および Buildah 用の fuse-overlayfs ストレージドライバーの使用

手順

1. pod-overrides 属性を使用して、https://access.redhat.com/documentation/ja-jp/red_hat_openshift_dev_spaces/3.20/html-single/administration_guide/index#administration-guide:configuring-fuse で定義されている必要なアノテーションをワークスペースに追加します。pod-overrides 属性を使用すると、ワークスペース Pod の spec 内の特定のフィールドをマージできます。

   OpenShift バージョン 4.15 より前のバージョンの場合:

   $ oc patch devworkspace <DevWorkspace_name> \
     --patch '{"spec":{"template":{"attributes":{"pod-overrides":{"metadata":{"annotations":{"io.kubernetes.cri-o.Devices":"/dev/fuse","io.openshift.podman-fuse":""}}}}}}}' \
     --type=merge

   Copy to Clipboard Toggle word wrap

   OpenShift バージョン 4.15 以降の場合:

   $ oc patch devworkspace <DevWorkspace_name> \
     --patch '{"spec":{"template":{"attributes":{"pod-overrides":{"metadata":{"annotations":{"io.kubernetes.cri-o.Devices":"/dev/fuse"}}}}}}}' \
     --type=merge

   Copy to Clipboard Toggle word wrap

検証手順

1. ワークスペースを起動し、ワークスペースコンテナーで /dev/fuse が使用できることを確認します。

   $ stat /dev/fuse

   Copy to Clipboard Toggle word wrap

手順

1. プロジェクトに /home/user/.config/containers/storage.conf ファイルをマウントする ConfigMap を適用します。

   kind: ConfigMap
   apiVersion: v1
   metadata:
     name: fuse-overlay
     labels:
       controller.devfile.io/mount-to-devworkspace: 'true'
       controller.devfile.io/watch-configmap: 'true'
     annotations:
       controller.devfile.io/mount-as: subpath
       controller.devfile.io/mount-path: /home/user/.config/containers
   data:
     storage.conf: |
       [storage]
       driver = "overlay"
   
       [storage.options.overlay]
       mount_program="/usr/bin/fuse-overlayfs"

   Copy to Clipboard Toggle word wrap
   警告

   この ConfigMap を作成すると、実行中のワークスペースがすべて再起動されます。

検証手順

1. 必要なアノテーションを含むワークスペースを起動し、ストレージドライバーが overlay であることを確認します。

   $ podman info | grep overlay

   Copy to Clipboard Toggle word wrap

   出力例:

   graphDriverName: overlay
     overlay.mount_program:
       Executable: /usr/bin/fuse-overlayfs
       Package: fuse-overlayfs-1.12-1.module+el8.9.0+20326+387084d0.x86_64
         fuse-overlayfs: version 1.12
     Backing Filesystem: overlayfs

   Copy to Clipboard Toggle word wrap
   注記

   既存のワークスペースで、次のエラーが発生する可能性があります。

   ERRO[0000] User-selected graph driver "overlay" overwritten by graph driver "vfs" from database - delete libpod local files ("/home/user/.local/share/containers/storage") to resolve.  May prevent use of images created by other tools

   Copy to Clipboard Toggle word wrap

   この場合、エラーメッセージに記載されているように libpod ローカルファイルを削除します。