7.10. /dev/fuse を使用した高速ビルドへのアクセス

手順

1. /dev/fuse アクセスを持つ Pod を定義します。

   • 次の内容で fuse-builder-pod.yaml という名前の YAML ファイルを作成します。

     apiVersion: v1
     kind: Pod
     metadata:
       name: fuse-builder-pod
       annotations:
         io.kubernetes.cri-o.Devices: "/dev/fuse" 

     1

     
     spec:
       containers:
       - name: build-container
         image: quay.io/podman/stable 

     2

     
         command: ["/bin/sh", "-c"]
         args: ["echo 'Container is running. Use oc exec to get a shell.'; sleep infinity"] 

     3

     
         securityContext: 

     4

     
           runAsUser: 1000

     Copy to Clipboard

     1

     io.kubernetes.cri-o.Devices: "/dev/fuse" アノテーションにより、Fuse デバイスが利用可能になります。

     2

     このアノテーションは、podman が含まれるイメージ (例: quay.io/podman/stable) を使用するコンテナーを指定します。

     3

     このコマンドはコンテナーを実行したままにして、コンテナー内で exec できるようにします。

     4

     このアノテーションは、コンテナーを権限のないユーザーとして実行する securityContext を指定します (例: runAsUser: 1000)*。

     注記

     クラスターの Security Context Constraints (SCC) またはその他のポリシーに応じて、たとえば、fuse-overlayfs が動作するために /dev/fuse だけでは不十分な場合に特定のケイパビリティーを許可するなど、securityContext 仕様をさらに調整する必要がある場合があります。

   • 以下のコマンドを実行して Pod を作成します。

     $ oc apply -f fuse-builder-pod.yaml

     Copy to Clipboard

2. Pod が実行されていることを確認します。

   $ oc get pods fuse-builder-pod

   Copy to Clipboard

3. Pod にアクセスし、ビルド環境を準備します。

   fuse-builder-pod Pod が Running 状態になったら、build-container 環境にシェルセッションを開きます。

   $ oc exec -ti fuse-builder-pod -- /bin/bash

   Copy to Clipboard

   現在地はコンテナーの中です。デフォルトの作業ディレクトリーは権限のないユーザーによる書き込みが不可能な場合があるため、/tmp などの書き込み可能なディレクトリーに変更します。

   $ cd /tmp
   $ pwd
   /tmp

   Copy to Clipboard

4. dockerfile を作成し、Podman を使用してイメージをビルドします。

   Pod のシェル内および /tmp ディレクトリー内で、Dockerfile を作成し、podman を使用してコンテナーイメージをビルドできるようになりました。fuse-overlayfs がデフォルトの、または設定されたストレージドライバーである場合、Podman は利用可能な /dev/fuse デバイスで fuse-overlayfs を活用できます。

   1. サンプル Dockerfile を作成します。

      $ cat > Dockerfile <<EOF
      FROM registry.access.redhat.com/ubi9/ubi-minimal
      RUN microdnf install -y findutils && microdnf clean all
      RUN echo "This image was built inside a pod with /dev/fuse by user $(id -u)" > /app/build_info.txt
      COPY Dockerfile /app/Dockerfile_copied
      WORKDIR /app
      CMD ["sh", "-c", "cat /app/build_info.txt && echo '--- Copied Dockerfile ---' && cat /app/Dockerfile_copied"]
      EOF

      Copy to Clipboard

   2. podman を使用してイメージをビルドします。-t フラグはイメージにタグを付けます。

      $ podman build -t my-fuse-built-image:latest .

      Copy to Clipboard

      Podman がビルド手順を実行していることを確認できるはずです。

5. オプション: ビルドしたイメージをテストします。

   引き続き fuse-builder-pod 内で、先ほどビルドしたイメージからコンテナーを実行してテストできます。

   $ podman run --rm my-fuse-built-image:latest

   Copy to Clipboard

   これにより、/app/build_info.txt ファイルとコピーされた Dockerfile の内容が出力されます。

6. Pod を終了してクリーンアップします。

   • 完了したら、Pod のシェルセッションを終了します。

     $ exit

     Copy to Clipboard

   • 不要になった Pod は削除できます。

     $ oc delete pod fuse-builder-pod

     Copy to Clipboard

   • ローカル YAML ファイルを削除します。

     $ rm fuse-builder-pod.yaml

     Copy to Clipboard