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입니다.
절차
-
sudo권한을 사용하여 CLI에서 텍스트 편집기에서/etc/microshift/config.yaml을 엽니다. -
genericDevicePlugin섹션을 찾습니다. 존재하지 않는 경우 추가합니다. 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입니다.
-
config.yaml파일을 저장합니다. MicroShift 서비스를 다시 시작하여 변경 사항을 적용합니다.
$ sudo systemctl restart microshiftMicroShift가 다시 시작되고 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