4.12. fuse-overlayfs 구성

절차

1. OpenShift 클러스터 유형(단일 노드 클러스터 또는 별도의 컨트롤 플레인 및 작업자 노드가 있는 다중 노드 클러스터)에 따라 환경 변수를 설정합니다.

   • 단일 노드 클러스터의 경우 다음을 설정합니다.

     $ NODE_ROLE=master

   • 다중 노드 클러스터의 경우 다음을 설정합니다.

     $ NODE_ROLE=worker

2. OpenShift Butane 구성 버전의 환경 변수를 설정합니다. 이 변수는 OpenShift 클러스터의 메이저 및 마이너 버전입니다. 예를 들면 4.12.0,4.13.0 또는 4.14.0 입니다.

   $ VERSION=4.12.0

3. NODE_ROLE 노드에 99-podman-fuse 라는 드롭인 CRI-O 구성 파일을 생성하는 MachineConfig 리소스를 생성합니다. 이 구성 파일을 사용하면 특정 Pod에 대해 가능한 /dev/fuse 장치에 액세스할 수 있습니다.

   cat << EOF | butane | oc apply -f -
   variant: openshift
   version: ${VERSION}
   metadata:
     labels:
       machineconfiguration.openshift.io/role: ${NODE_ROLE}
     name: 99-podman-dev-fuse-${NODE_ROLE}
   storage:
     files:
     - path: /etc/crio/crio.conf.d/99-podman-fuse 

   1

   
       mode: 0644
       overwrite: true
       contents: 

   2

   
         inline: |
           [crio.runtime.workloads.podman-fuse] 

   3

   
           activation_annotation = "io.openshift.podman-fuse" 

   4

   
           allowed_annotations = [
             "io.kubernetes.cri-o.Devices" 

   5

   
           ]
           [crio.runtime]
           allowed_devices = ["/dev/fuse"] 

   6

   
   EOF

   1

   CRI-O에 대한 새로운 드롭인 구성 파일의 절대 파일 경로입니다.

   2

   새 드롭인 구성 파일의 내용입니다.

   3

   podman-fuse 워크로드를 정의합니다.

   4

   podman-fuse 워크로드 설정을 활성화하는 pod 주석입니다.

   5

   podman-fuse 워크로드에서 처리할 수 있는 주석 목록입니다.

   6

   사용자가 io.kubernetes.cri-o.Devices 주석으로 지정할 수 있는 호스트의 장치 목록입니다.

4. MachineConfig 리소스를 적용하면 변경 사항이 적용되면 작업자 역할이 있는 각 노드에 대해 예약이 일시적으로 비활성화됩니다. 노드 상태를 확인합니다.

   $ oc get nodes

   출력 예:

   NAME                           STATUS                     ROLES    AGE   VERSION
   ip-10-0-136-161.ec2.internal   Ready                      worker   28m   v1.27.9
   ip-10-0-136-243.ec2.internal   Ready                      master   34m   v1.27.9
   ip-10-0-141-105.ec2.internal   Ready,SchedulingDisabled   worker   28m   v1.27.9
   ip-10-0-142-249.ec2.internal   Ready                      master   34m   v1.27.9
   ip-10-0-153-11.ec2.internal    Ready                      worker   28m   v1.27.9
   ip-10-0-153-150.ec2.internal   Ready                      master   34m   v1.27.9

5. 작업자 역할의 모든 노드의 상태가 Ready 이면 다음 주석이 있는 모든 Pod에서/dev/fuse 를 사용할 수 있습니다.

   io.openshift.podman-fuse: ''
   io.kubernetes.cri-o.Devices: /dev/fuse

검증 단계

1. 작업자 역할이 있는 노드의 이름을 가져옵니다.

   $ oc get nodes

2. 작업자 노드에 대한 oc 디버그 세션을 엽니다.

   $ oc debug node/<nodename>

3. 99-podman-fuse 라는 새 CRI-O 구성 파일이 있는지 확인합니다.

   sh-4.4# stat /host/etc/crio/crio.conf.d/99-podman-fuse

절차

1. CheCluster 사용자 정의 리소스의 spec.devEnvironments.workspacesPodAnnotations 필드에 필요한 주석을 설정합니다.

   kind: CheCluster
   apiVersion: org.eclipse.che/v2
   spec:
     devEnvironments:
       workspacesPodAnnotations:
         io.kubernetes.cri-o.Devices: /dev/fuse

   참고

   OpenShift 버전 4.14 이하의 경우 io.openshift.podman-fuse: "" 주석도 필요합니다.

2. 선택 사항: 작업 공간 컨테이너에 사용자 지정 이미지를 사용하는 경우 /home/user/.config 폴더를 생성하고 진입점을 통해 런타임에서 storage.conf 파일을 구성합니다. 이렇게 하려면 이미지를 빌드하기 전에 작업 공간 컨테이너 이미지의 진입점 스크립트에 다음을 추가합니다. 진입점에 /home/user/.config 폴더를 생성하면 이미지 빌드 시 알 수 없는 현재 사용자가 폴더를 소유하게 됩니다.

   # Configure container builds to use vfs or fuse-overlayfs
   if [ ! -d "${HOME}/.config/containers" ]; then
     mkdir -p ${HOME}/.config/containers
     if [ -c "/dev/fuse" ] && [ -f "/usr/bin/fuse-overlayfs" ]; then
       (echo '[storage]';echo 'driver = "overlay"';echo '[storage.options.overlay]';echo 'mount_program = "/usr/bin/fuse-overlayfs"') > ${HOME}/.config/containers/storage.conf
     else
       (echo '[storage]';echo 'driver = "vfs"') > "${HOME}"/.config/containers/storage.conf
     fi
   fi

   이렇게 하면 /home/user/.config 가 아직 존재하지 않는 경우 폴더가 생성되어 사용자가 소유합니다. 예를 들어 /home/user/.config 가 영구 볼륨에 저장된 경우 이미 존재할 수 있습니다.

3. 작업 영역을 시작하고 /home/user/.config 의 소유자가 user 인지 확인합니다.

   $ ls -la /home/user

   출력 예:

   ...
   drwxrwsr-x.  3 user 1000660000   24 Dec 24 15:40 .config

4. 스토리지 드라이버가 오버레이 인지 확인합니다.

   $ podman info | grep overlay

   출력 예:

   graphDriverName: overlay
     overlay.mount_program:
       Executable: /usr/bin/fuse-overlayfs
       Package: fuse-overlayfs-1.14-1.el9.x86_64
         fuse-overlayfs: version 1.13-dev
     Backing Filesystem: overlayfs

   참고

   기존 작업 공간에 대해 다음 오류가 발생할 수 있습니다.

   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

   이 경우 오류 메시지에 언급된 libpod 로컬 파일을 삭제합니다.