6.2. 장치 보기
인벤토리의 장치에 대한 자세한 내용을 보려면 Red Hat Edge Manager CLI를 사용하면 됩니다.
6.2.1. 웹 UI에서 장치 인벤토리 및 장치 세부 정보 보기 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat Edge Manager 웹 UI에서 상태 및 상태를 포함한 등록된 장치에 대한 세부 정보를 볼 수 있습니다.
사전 요구 사항
- Red Hat Edge Manager CLI를 설치해야 합니다. Red Hat Edge Manager CLI 설치를 참조하십시오.
- 하나 이상의 장치를 등록해야 합니다.
프로세스
-
탐색 패널에서
를 선택합니다. 그러면 외부 Edge Manager 인스턴스가 열립니다. - 탐색 패널에서 장치 인벤토리, 세부 정보 및 해제 장치를 볼 수 있는 장치를 선택합니다.
6.2.2. CLI에서 장치 인벤토리 및 장치 세부 정보 보기 링크 복사링크가 클립보드에 복사되었습니다!
다음 단계를 완료합니다.
프로세스
다음 명령을 실행하여 장치 인벤토리의 장치를 확인합니다.
flightctl get devices
flightctl get devicesCopy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 예제 출력을 참조하십시오.
NAME ALIAS OWNER SYSTEM UPDATED APPLICATIONS LAST SEEN <device_name> <none> <none> Online Up-to-date <none> 3 seconds ago
NAME ALIAS OWNER SYSTEM UPDATED APPLICATIONS LAST SEEN <device_name> <none> <none> Online Up-to-date <none> 3 seconds agoCopy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 이 장치의 세부 정보를 YAML 형식으로 확인합니다.
flightctl get device/<device_name> -o yaml
flightctl get device/<device_name> -o yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 예제 출력을 참조하십시오.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
6.2.3. 라벨 및 라벨 선택기 링크 복사링크가 클립보드에 복사되었습니다!
예를 들어 해당 위치, 하드웨어 유형 또는 목적을 기록하도록 레이블을 할당하여 리소스를 구성할 수 있습니다. Red Hat Edge Manager 레이블은 Kubernetes 라벨 및 라벨 선택기와 동일한 구문, 원칙 및 연산자를 따릅니다. 장치 인벤토리를 보거나 장치에 작업을 적용할 때 라벨이 있는 장치를 선택할 수 있습니다.
레이블은 key=value 형식을 따릅니다. 키를 사용하여 장치를 그룹화할 수 있습니다. 예를 들어 레이블이 site=<location > 이름 지정 규칙을 따르는 경우 사이트별로 장치를 그룹화할 수 있습니다. 키로만 구성된 레이블을 사용할 수도 있습니다.
레이블은 다음 규칙을 준수하여 유효해야 합니다.
- 키와 값은 각각 63자 이상이어야 합니다.
-
키와 값은 영숫자(
a-z,A-Z,0-9)로 구성될 수 있습니다. -
키와 값은 대시(
-), 밑줄(_), 점(.)을 포함할 수도 있지만 첫 번째 또는 마지막 문자로는 포함할 수 없습니다. - 값은 생략할 수 있습니다.
다음과 같은 방법으로 장치에 레이블을 적용할 수 있습니다.
- 배포 중에 모든 장치에 자동으로 적용되는 이미지 빌드 중에 기본 레이블 세트를 정의합니다.
- 등록하는 동안 초기 레이블을 할당합니다.
- 레이블 post-enrollment를 할당합니다.
리소스에 레이블이 지정되면 라벨 선택기를 생성하여 장치 하위 집합을 선택할 수 있습니다. 레이블 선택기는 동일한 레이블 세트가 있는 장치를 선택하기 위한 쉼표로 구분된 레이블 목록입니다.
다음 예제를 참조하십시오.
| 라벨 선택기의 예 | 선택한 장치 |
|---|---|
|
|
|
|
|
|
|
|
|
라벨 및 선택기에 대한 자세한 내용은 Kubernetes 문서 의 라벨 및 선택기 를 참조하십시오.
6.2.3.1. 웹 UI에서 장치 및 해당 라벨 보기 링크 복사링크가 클립보드에 복사되었습니다!
웹 UI에서 장치 및 관련 레이블을 확인합니다. 레이블을 사용하여 장치 및 장치 플릿을 구성할 수 있습니다.
다음 단계를 완료합니다.
-
탐색 패널에서
를 선택합니다. 그러면 외부 Edge Manager 인스턴스가 열립니다. - 탐색 패널에서 장치를 선택합니다.
- 관리할 장치를 선택합니다. 세부 정보 탭에서 라벨 아래의 관련 라벨을 볼 수 있습니다.
6.2.3.2. CLI에서 장치 및 해당 라벨 보기 링크 복사링크가 클립보드에 복사되었습니다!
장치 및 관련 레이블을 확인합니다. 레이블을 사용하여 장치 및 장치 플릿을 구성할 수 있습니다.
다음 단계를 완료합니다.
프로세스
-o wide옵션을 사용하여 레이블로 인벤토리의 장치를 확인합니다.flightctl get devices -o wide
flightctl get devices -o wideCopy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 예제 출력을 참조하십시오.
NAME ALIAS OWNER SYSTEM UPDATED APPLICATIONS LAST SEEN LABELS <device1_name> <none> <none> Online Up-to-date <none> 3 seconds ago region=eu-west-1,site=factory-berlin <device2_name> <none> <none> Online Up-to-date <none> 1 minute ago region=eu-west-1,site=factory-madrid
NAME ALIAS OWNER SYSTEM UPDATED APPLICATIONS LAST SEEN LABELS <device1_name> <none> <none> Online Up-to-date <none> 3 seconds ago region=eu-west-1,site=factory-berlin <device2_name> <none> <none> Online Up-to-date <none> 1 minute ago region=eu-west-1,site=factory-madridCopy to Clipboard Copied! Toggle word wrap Toggle overflow -l <key=value> 옵션을 사용하여 특정 라벨 또는 레이블 세트가 있는 인벤토리의 장치를 확인합니다.flightctl get devices -l site=factory-berlin -o wide
flightctl get devices -l site=factory-berlin -o wideCopy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 예제 출력을 참조하십시오.
NAME ALIAS OWNER SYSTEM UPDATED APPLICATIONS LAST SEEN LABELS <device1_name> <none> <none> Online Up-to-date <none> 3 seconds ago region=eu-west-1,site=factory-berlin
NAME ALIAS OWNER SYSTEM UPDATED APPLICATIONS LAST SEEN LABELS <device1_name> <none> <none> Online Up-to-date <none> 3 seconds ago region=eu-west-1,site=factory-berlinCopy to Clipboard Copied! Toggle word wrap Toggle overflow
6.2.3.3. CLI에서 레이블 업데이트 링크 복사링크가 클립보드에 복사되었습니다!
CLI를 사용하여 장치에서 레이블을 업데이트합니다.
다음 단계를 완료합니다.
프로세스
다음 명령을 실행하여 장치의 현재 정의를 파일로 내보냅니다.
flightctl get device/<device1_name> -o yaml > my_device.yaml
flightctl get device/<device1_name> -o yaml > my_device.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow 선호하는 편집기를 사용하여
my_device.yaml파일을 편집합니다. 다음 예제를 참조하십시오.Copy to Clipboard Copied! Toggle word wrap Toggle overflow 파일을 저장하고 다음 명령을 실행하여 업데이트된 장치 정의를 적용합니다.
flightctl apply -f my_device.yaml
flightctl apply -f my_device.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 예제 출력을 실행하여 변경 사항을 확인합니다.
NAME ALIAS OWNER SYSTEM UPDATED APPLICATIONS LAST SEEN LABELS <device1_name> <none> <none> Online Up-to-date <none> 3 minutes ago some_key=some_value,some_other_key=some_other_value <device2_name> <none> <none> Online Up-to-date <none> 4 minutes ago region=eu-west-1,site=factory-madrid
NAME ALIAS OWNER SYSTEM UPDATED APPLICATIONS LAST SEEN LABELS <device1_name> <none> <none> Online Up-to-date <none> 3 minutes ago some_key=some_value,some_other_key=some_other_value <device2_name> <none> <none> Online Up-to-date <none> 4 minutes ago region=eu-west-1,site=factory-madridCopy to Clipboard Copied! Toggle word wrap Toggle overflow
6.2.4. 필드 선택기 링크 복사링크가 클립보드에 복사되었습니다!
필드 선택기는 특정 리소스 필드 값에 따라 Red Hat Edge Manager 리소스 목록을 필터링합니다. Kubernetes Field 및 Label 선택기와 동일한 구문, 원칙 및 Operator를 따르며 고급 검색 사용 사례에 추가 Operator를 사용할 수 있습니다.
6.2.4.1. 지원되는 필드 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat Edge Manager 리소스는 선택할 수 있는 메타데이터 필드 세트를 제공합니다.
각 리소스는 다음 메타데이터 필드를 지원합니다.
-
metadata.name -
metadata.owner -
metadata.creationTimestamp
라벨을 쿼리하려면 고급 및 유연한 라벨 필터링에 대해 라벨 선택기를 사용합니다.
자세한 내용은 라벨 및 라벨 선택기를 참조하십시오.
6.2.4.2. 지원되는 추가 필드 목록 링크 복사링크가 클립보드에 복사되었습니다!
메타데이터 필드 외에도 각 리소스에는 선택할 수 있는 고유한 필드 세트가 있어 리소스별 특성을 기반으로 필터링 및 선택의 유연성을 추가로 제공합니다.
다음 표에는 각 리소스 종류 필터링에 지원되는 필드가 나열되어 있습니다.
| 유형 | 필드 |
|---|---|
| 인증서 서명 요청 |
|
| 장치 |
|
| 등록 요청 |
|
| Fleet |
|
| 리포지토리 |
|
| 리소스 동기화 |
|
6.2.4.3. 필드 검색 링크 복사링크가 클립보드에 복사되었습니다!
일부 Red Hat Edge Manager 리소스는 추가 지원되는 필드를 노출할 수 있습니다. --field-selector 옵션과 함께 planectl 을 사용하여 지원되는 필드를 확인할 수 있습니다. 지원되지 않는 필드를 사용하려는 경우 오류 메시지에 사용 가능한 필드가 나열됩니다.
다음 예제를 참조하십시오.
flightctl get device --field-selector='text'
flightctl get device --field-selector='text'
Error: listing devices: 400, message: unknown or unsupported selector: unable to resolve selector name "text". Supported selectors are: [metadata.alias metadata.creationTimestamp metadata.name metadata.nameoralias metadata.owner status.applicationsSummary.status status.lastSeen status.summary.status status.updated.status]
Error: listing devices: 400, message: unknown or unsupported selector: unable to resolve selector name "text". Supported selectors are: [metadata.alias metadata.creationTimestamp metadata.name metadata.nameoralias metadata.owner status.applicationsSummary.status status.lastSeen status.summary.status status.updated.status]
필드 텍스트 는 필터링에 유효한 필드가 아닙니다. 오류 메시지에는 Device 리소스에 대해 --field-selector 와 함께 사용할 수 있는 지원되는 필드 목록이 있습니다.
그런 다음 지원되는 필드 중 하나를 사용할 수 있습니다.
flightctl get devices --field-selector 'metadata.alias contains cluster'
flightctl get devices --field-selector 'metadata.alias contains cluster'
containment Operator에서 metadata.alias 필드를 확인하여 값 클러스터 가 있는지 확인합니다.
예
예 1: 이름으로 특정 장치 제외
다음 명령은 특정 장치를 이름으로 필터링합니다.
flightctl get devices --field-selector 'metadata.name!=c3tkb18x9fw32fzx5l556n0p0dracwbl4uiojxu19g2'
flightctl get devices --field-selector 'metadata.name!=c3tkb18x9fw32fzx5l556n0p0dracwbl4uiojxu19g2'
예 2: 소유자, 라벨 및 생성 타임스탬프별로 필터링
이 명령은 us 지역에 있고 2024년에 생성된 Fleet/pos-fleet 이 소유한 장치를 검색합니다.
flightctl get devices --field-selector 'metadata.owner=Fleet/pos-fleet, metadata.creationTimestamp >= 2024-01-01T00:00:00Z, metadata.creationTimestamp < //2025-01-01T00:00:00Z' -l 'region=us'
flightctl get devices --field-selector 'metadata.owner=Fleet/pos-fleet, metadata.creationTimestamp >= 2024-01-01T00:00:00Z, metadata.creationTimestamp < //2025-01-01T00:00:00Z' -l 'region=us'
예 3: 소유자, 라벨 및 장치 상태별로 필터링
이 명령은 Fleet/pos-fleet 이 소유한 장치를 us 리전에 있고 Unknown 또는 OutOfDate: status.updated.status 로 검색합니다.
flightctl get devices --field-selector 'metadata.owner=Fleet/pos-fleet, status.updated.status in (Unknown, OutOfDate)' -l 'region=us'
flightctl get devices --field-selector 'metadata.owner=Fleet/pos-fleet, status.updated.status in (Unknown, OutOfDate)' -l 'region=us'
6.2.4.4. 지원되는 Operator 링크 복사링크가 클립보드에 복사되었습니다!
| Operator | 기호 | 설명 |
|---|---|---|
| Exists |
| 필드가 있는지 확인 |
| DoesNotExist |
| 필드가 없는지 확인 |
| 동일 |
| 필드가 값과 같은지 확인 |
| controlPlaneEquals |
| 동일한지 확인의 또 다른 방법 |
| NotEquals |
| 필드가 값과 같지 않은지 확인 |
| greaterthan |
| 필드가 값보다 큰지 확인 |
| GreaterThanOrEquals |
| 필드가 값보다 크거나 같은지 확인합니다.Check whether a field is greater than or equal to a value. |
| LessThan |
| 필드가 값보다 작은지 확인 |
| LessThanOrEquals |
| 필드가 값보다 작거나 같은지 확인합니다.Check whether a field is less than or equal to a value. |
| In |
| 필드가 값 목록에 있는지 확인 |
| NotIn |
| 필드가 값 목록에 없는 경우 확인 |
| 포함 |
| 필드에 값이 있는지 확인 |
| 포함되지 않음 |
| 필드에 값이 포함되어 있지 않은지 확인 |
6.2.4.4.1. 필드 유형별 Operator 사용 링크 복사링크가 클립보드에 복사되었습니다!
각 필드 유형은 Operator의 특정 하위 집합을 지원합니다.
| 필드 유형 | 지원되는 Operator | 현재의 |
|---|---|---|
| string |
필드 값이 목록의 하나 이상의 문자열과 일치하는 경우와 일치합니다.
| 텍스트 문자열 |
| Timestamp |
| RFC 3339 형식 |
| 숫자 |
필드 값이 지정된 숫자
| 숫자 형식 |
| 부울 |
참고
목록에는
|
부울 형식( |
| array |
참고
| array 요소 |