9.3. 일반 장치 플러그인 구성


GDP(Generic Device Plugin)는 MicroShift에서 기본적으로 비활성화되어 있습니다. 직렬 포트 및 카메라와 같은 호스트 장치를 Pod에 공개하려면 GDP를 활성화하고 config.yaml 파일에서 장치를 정의하거나 /etc/microshift/config.d/10-gdp.yaml 과 같은 구성 스니펫 파일을 생성할 수 있습니다.

사전 요구 사항

  • MicroShift가 설치되어 있어야 합니다.
  • /etc/microshift 디렉터리에 사용자 지정 config.yaml 파일을 생성하셨습니다.
  • OpenShift CLI(oc)를 설치합니다.
  • MicroShift 호스트에 대한 sudo 권한이 있습니다.
  • MicroShift 노드에 노출하려는 특정 호스트 장치를 식별했습니다. 예를 들면 /dev/video0,/dev/ttyUSB* 또는 USB Vendor/Product ID입니다.

절차

  1. sudo 권한을 사용하여 CLI에서 텍스트 편집기에서 /etc/microshift/config.yaml 을 엽니다.
  2. genericDevicePlugin 섹션을 찾습니다. 존재하지 않는 경우 추가합니다.
  3. status 매개변수를 Enabled 로 설정하고 노출해야 하는 장치를 정의합니다. 각 장치 정의에는 이름과 하나 이상의 그룹이 필요합니다. 각 그룹은 벤더/제품 ID를 사용하는 USB 장치의 경우 glob 패턴 또는 usbs 를 포함한 파일 기반 장치에 대해 경로를 사용하여 장치를 지정할 수 있습니다. 동일한 장치 그룹 내에서 경로 와 usb를 혼합할 수 없습니다.

    기본값이 있는 GDP 필드

    apiServer:
    # ...
    genericDevicePlugin:
      devices:
      - groups:
        - paths:
          - path: /dev/ttyUSB*
          - path: /dev/ttyACM*
        name: serial
      - groups:
        - paths:
          - path: /dev/fuse
        name: fuse
      - groups:
        - usbs:
          - product: "0x7523"
            serial: ""
            vendor: "0x1a86"
        name: converter
      domain: device.microshift.io
      status: Enabled

    다음과 같습니다.

    /dev/ttyUSB*
    이 와일드카드와 일치하는 모든 USB 직렬 장치의 파일 경로를 지정합니다.
    /dev/ttyACM*
    이 와일드카드와 일치하는 모든 ACM 직렬 장치의 파일 경로를 지정합니다.
    /dev/fuse
    fuse 장치의 파일 경로를 지정합니다.
    fuse
    장치의 이름을 지정합니다.
    0x7523
    CH340 직렬 변환기의 제품 ID를 지정합니다.
    0x1a86
    CH340 직렬 변환기의 벤더 ID를 지정합니다.
    device.microshift.io
    GDP의 기본 도메인을 지정합니다.
    중요
    • microshift show-config 매개변수의 출력에는 config.yaml 에서 명시적으로 구성하지 않은 경우에도 직렬 장치에 대한 사전 구성된 기본 경로가 포함될 수 있습니다. 이러한 경로는 일반 장치 플러그인이 특정 사용자 구성 없이 활성화된 경우 기본 검색 설정을 나타냅니다.
    • 일관성 및 정확한 장치 대상, 특히 여러 유사한 장치를 처리할 때 /dev/tty USB* 와 같은 광범위한 글러 패턴 대신 /dev/serial/by-id/ 또는 특정 USB Vendor, Product 또는 Serial ID와 같은 안정적인 장치 경로를 사용하는 것이 좋습니다.
    • 장치 그룹의 count 매개변수를 사용하면 단일 장치 또는 glob와 일치하는 장치 세트를 다른 Pod에 동시에 여러 번 할당할 수 있습니다. 생략하면 count 의 기본값은 1 입니다.
  4. config.yaml 파일을 저장합니다.
  5. MicroShift 서비스를 다시 시작하여 변경 사항을 적용합니다.

    $ sudo systemctl restart microshift

    MicroShift가 다시 시작되고 GDP가 Kubelet에 장치를 등록할 수 있도록 일정 시간을 허용합니다.

검증

  • 다음 명령을 실행하여 노드에서 사용 가능한 장치를 확인할 수 있습니다.

    $ oc describe node <microshift_node_name> | grep "device.microshift.io"
  • 구성에 따라 장치가 이제 MicroShift 노드에서 검색 및 예약 가능함을 나타내는 출력이 표시됩니다.

    출력 예

    Capacity:
     cpu:                                2
     device.microshift.io/audio:         0
     device.microshift.io/capture:       0
     device.microshift.io/custom-device: 1
     device.microshift.io/dummy-video:   0
     device.microshift.io/fuse:          0
     device.microshift.io/serial:        5
     device.microshift.io/video:         0
    Allocatable:
     cpu:                                2
     device.microshift.io/audio:         0
     device.microshift.io/capture:       0
     device.microshift.io/custom-device: 1
     device.microshift.io/dummy-video:   0
     device.microshift.io/fuse:          0
     device.microshift.io/serial:        5
     device.microshift.io/video:         0
    Allocated resources:
     (Total limits may be over 100 percent, i.e., overcommitted.)
     Resource                           Requests     Limits
     --------                           --------     ------
     cpu                                450m (22%)   500m (25%)
     memory                             1550Mi (42%) 500Mi (13%)
     ephemeral-storage                  0 (0%)       0 (0%)
     hugepages-1Gi                      0 (0%)       0 (0%)
     hugepages-2Mi                      0 (0%)       0 (0%)
     device.microshift.io/audio         0            0
     device.microshift.io/capture       0            0
     device.microshift.io/custom-device 1            1
     device.microshift.io/dummy-video   1            1
     device.microshift.io/fuse          0            0
     device.microshift.io/serial        0            0
     device.microshift.io/video         0            0

Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 문서 정보

Legal Notice

Theme

© 2026 Red Hat
맨 위로 이동