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

手順

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

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

      apiVersion: v1
      kind: Pod
      metadata:
        name: fuse-builder-pod
        annotations:
          io.kubernetes.cri-o.Devices: "/dev/fuse"
      spec:
        containers:
        - name: build-container
          image: quay.io/podman/stable
          command: ["/bin/sh", "-c"]
          args: ["echo 'Container is running. Use oc exec to get a shell.'; sleep infinity"]
          securityContext:
            runAsUser: 1000

      ここでは、以下のようになります。

      io.kubernetes.cri-o.Devices

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

      image

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

      args

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

      securityContext

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

      注記

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

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

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

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

   $ oc get pods fuse-builder-pod

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

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

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

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

   $ cd /tmp

   $ pwd

   /tmp

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

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

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

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

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

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

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

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

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

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

      $ exit

   2. 不要になった Pod を削除します。

      $ oc delete pod fuse-builder-pod

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

      $ rm fuse-builder-pod.yaml