기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Kinesis Video Streams용 에지 커넥터
Kinesis Video Streams 구성 요소 aws.iot.EdgeConnectorForKVS
() 용 에지 커넥터는 로컬 카메라에서 비디오 피드를 읽고 Kinesis Video Streams에 스트림을 게시합니다. 실시간 스트리밍 프로토콜 (RTSP) 을 사용하여 인터넷 프로토콜 (IP) 카메라에서 비디오 피드를 읽도록 이 구성 요소를 구성할 수 있습니다. 그런 다음 Amazon Managed Grafana 또는 로컬 Grafana 서버에 대시보드를 설정하여 비디오 스트림을 모니터링하고 상호 작용할 수 있습니다.
이 구성 요소를 통합하여 AWS IoT TwinMaker Grafana 대시보드에서 비디오 스트림을 표시하고 제어할 수 있습니다. AWS IoT TwinMaker 물리적 시스템의 운영 디지털 트윈을 구축할 수 있게 해주는 AWS 서비스입니다. AWS IoT TwinMaker 이를 사용하여 센서, 카메라 및 엔터프라이즈 애플리케이션의 데이터를 시각화하여 실제 공장, 건물 또는 산업 플랜트를 추적할 수 있습니다. 또한 이 데이터를 사용하여 작업을 모니터링하고, 오류를 진단하고, 오류를 수정할 수 있습니다. 자세한 내용은 What is AWS IoT TwinMaker? 를 참조하십시오. AWS IoT TwinMaker 사용 설명서에서.
이 구성 요소는 산업 데이터를 모델링하고 저장하는 AWS IoT SiteWise AWS 서비스인 에 구성을 저장합니다. 에서 AWS IoT SiteWise자산은 장치, 장비 또는 기타 개체 그룹과 같은 개체를 나타냅니다. 이 구성 요소를 구성하고 사용하려면 각 Greengrass 코어 장치 및 각 코어 장치에 연결된 각 IP 카메라에 대한 AWS IoT SiteWise 자산을 생성합니다. 각 자산에는 라이브 스트리밍, 온디맨드 업로드, 로컬 캐싱과 같은 기능을 제어하도록 구성하는 속성이 있습니다. 각 카메라의 URL을 지정하려면 카메라의 URL이 AWS Secrets Manager 포함된 시크릿을 생성해야 합니다. 카메라에 인증이 필요한 경우 URL에 사용자 이름과 암호도 지정합니다. 그런 다음 IP 카메라의 자산 속성에 해당 암호를 지정합니다.
이 구성 요소는 각 카메라의 비디오 스트림을 Kinesis 비디오 스트림에 업로드합니다. 각 카메라의 AWS IoT SiteWise 에셋 구성에서 대상 Kinesis 비디오 스트림의 이름을 지정합니다. Kinesis 비디오 스트림이 없는 경우 이 구성 요소가 자동으로 생성합니다.
AWS IoT TwinMaker 는 이러한 AWS IoT SiteWise 자산과 Secrets Manager 암호를 만들기 위해 실행할 수 있는 스크립트를 제공합니다. 이러한 리소스를 만드는 방법과 이 구성 요소를 설치, 구성 및 사용하는 방법에 대한 자세한 내용은 사용 AWS IoT TwinMaker 설명서의 AWS IoT TwinMaker 비디오 통합을 참조하십시오.
참고
Kinesis Video Streams 구성 요소용 에지 커넥터는 다음 AWS 리전제품에서만 사용할 수 있습니다.
-
미국 동부(버지니아 북부)
-
미국 서부(오리건)
-
유럽(프랑크푸르트)
-
유럽(아일랜드)
-
아시아 태평양(싱가포르)
버전
이 구성 요소의 버전은 다음과 같습니다.
-
1.0.x
유형
이 구성 요소는 일반 구성 요소 () aws.greengrass.generic
입니다. Greengrass 핵은 구성 요소의 라이프사이클 스크립트를 실행합니다.
자세한 정보는 구성 요소 유형을 참조하세요.
운영 체제
이 구성 요소는 Linux 코어 디바이스에만 설치할 수 있습니다.
요구 사항
이 구성 요소의 요구 사항은 다음과 같습니다.
-
구성 요소 구성이 각 코어 장치마다 고유해야 하므로 이 구성 요소는 단일 코어 장치에만 배포할 수 있습니다. 핵심 장치 그룹에는 이 구성 요소를 배포할 수 없습니다.
-
GStreamer
1.18.4 이상이 코어 기기에 설치되었습니다. 자세한 내용은 GStreamer 설치를 참조하십시오. 가 설치된
apt
기기에서 다음 명령을 실행하여 GStreamer를 설치할 수 있습니다.sudo apt install -y libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gstreamer1.0-plugins-base-apps sudo apt install -y gstreamer1.0-libav sudo apt install -y gstreamer1.0-plugins-bad gstreamer1.0-plugins-good gstreamer1.0-plugins-ugly gstreamer1.0-tools
-
각 코어 AWS IoT SiteWise 디바이스의 에셋. 이 AWS IoT SiteWise 자산은 코어 디바이스를 나타냅니다. 이 자산을 만드는 방법에 대한 자세한 내용은 AWS IoT TwinMaker 사용 설명서의 AWS IoT TwinMaker 비디오 통합을 참조하십시오.
-
각 코어 장치에 연결하는 각 IP 카메라의 AWS IoT SiteWise 자산. 이러한 AWS IoT SiteWise 자산은 비디오를 각 코어 장치로 스트리밍하는 카메라를 나타냅니다. 각 카메라의 자산은 카메라에 연결되는 핵심 장치의 자산과 연결되어야 합니다. 카메라 자산에는 Kinesis 비디오 스트림, 인증 암호 및 비디오 스트리밍 매개변수를 지정하도록 구성할 수 있는 속성이 있습니다. 카메라 자산을 생성하고 구성하는 방법에 대한 자세한 내용은 AWS IoT TwinMaker 사용 설명서의AWS IoT TwinMaker 비디오 통합을 참조하십시오.
-
각 IP 카메라의 AWS Secrets Manager 비밀. 이 비밀번호는 키-값 쌍을 정의해야 합니다. 여기서 키는 있고 값은 카메라의 URL입니다.
RTSPStreamUrl
카메라 인증이 필요한 경우 이 URL에 사용자 이름과 암호를 포함하십시오. 이 컴포넌트에 필요한 리소스를 생성할 때 스크립트를 사용하여 시크릿을 생성할 수 있습니다. 자세한 내용은 AWS IoT TwinMaker 사용 설명서의 AWS IoT TwinMaker 비디오 통합을 참조하십시오.Secrets Manager 콘솔 및 API를 사용하여 추가 시크릿을 생성할 수도 있습니다. 자세한 내용은 AWS Secrets Manager 사용 설명서의 암호 만들기를 참조하십시오.
-
Greengrass 토큰 교환 역할은 다음 예시 IAM 정책에 표시된 것처럼 다음 AWS Secrets Manager및 Kinesis Video Streams 작업을 허용해야 합니다. AWS IoT SiteWise
참고
이 예제 정책은 디바이스가 및 라는 이름의 비밀 값을 가져오도록 허용합니다.
IPCamera1Url
IPCamera2Url
각 IP 카메라를 구성할 때 해당 카메라의 URL이 포함된 암호를 지정합니다. 카메라에 인증이 필요한 경우 URL에 사용자 이름과 암호도 지정합니다. 코어 디바이스의 토큰 교환 역할은 연결할 각 IP 카메라의 비밀에 대한 액세스를 허용해야 합니다.{ "Version": "2012-10-17", "Statement": [ { "Action": [ "secretsmanager:GetSecretValue" ], "Effect": "Allow", "Resource": [ "arn:aws:secretsmanager:
region
:account-id
:secret:IPCamera1Url
", "arn:aws:secretsmanager:region
:account-id
:secret:IPCamera2Url
" ] }, { "Action": [ "iotsitewise:BatchPutAssetPropertyValue", "iotsitewise:DescribeAsset", "iotsitewise:DescribeAssetModel", "iotsitewise:DescribeAssetProperty", "iotsitewise:GetAssetPropertyValue", "iotsitewise:ListAssetRelationships", "iotsitewise:ListAssets", "iotsitewise:ListAssociatedAssets", "kinesisvideo:CreateStream", "kinesisvideo:DescribeStream", "kinesisvideo:GetDataEndpoint", "kinesisvideo:PutMedia", "kinesisvideo:TagStream" ], "Effect": "Allow", "Resource": [ "*" ] } ] }참고
고객 관리 AWS Key Management Service 키를 사용하여 비밀을 암호화하는 경우 장치 역할도 해당
kms:Decrypt
작업을 허용해야 합니다.
엔드포인트 및 포트
이 구성 요소는 기본 작업에 필요한 엔드포인트 및 포트 외에도 다음 엔드포인트 및 포트에 대한 아웃바운드 요청을 수행할 수 있어야 합니다. 자세한 정보는 프록시 또는 방화벽을 통한 장치 트래픽 허용을 참조하세요.
엔드포인트 | 포트 | 필수 | 설명 |
---|---|---|---|
|
443 | 예 |
Kinesis Video Streams에 데이터를 업로드합니다. |
|
443 | 예 |
비디오 스트림 메타데이터를 에 AWS IoT SiteWise게시하십시오. |
|
443 | 예 |
카메라 URL 시크릿을 코어 디바이스에 다운로드합니다. |
의존성
구성 요소를 배포하면 호환되는 버전의 종속 AWS IoT Greengrass 항목도 배포됩니다. 즉, 구성 요소를 성공적으로 배포하려면 구성 요소 및 해당 종속성에 대한 요구 사항을 모두 충족해야 합니다. 이 섹션에는 이 구성 요소의 릴리스된 버전에 대한 종속성과 각 종속성에 대한 구성 요소 버전을 정의하는 시맨틱 버전 제약 조건이 나열되어 있습니다. 콘솔에서 구성 요소의 각 버전에 대한 종속성을 볼 수도 있습니다.AWS IoT Greengrass
다음 표에는 이 구성 요소의 버전 1.0.0~1.0.5에 대한 종속성이 나와 있습니다.
구성 요소 종속성에 대한 자세한 내용은 구성 요소 레시피 참조를 참조하십시오.
구성
이 구성 요소는 구성 요소를 배포할 때 사용자 지정할 수 있는 다음과 같은 구성 매개 변수를 제공합니다.
SiteWiseAssetIdForHub
-
이 코어 디바이스를 나타내는 AWS IoT SiteWise 자산의 ID. 이 자산을 만들고 이를 사용하여 이 구성 요소와 상호 작용하는 방법에 대한 자세한 내용은 사용 AWS IoT TwinMaker 설명서의 AWS IoT TwinMaker 비디오 통합을 참조하십시오.
예: 구성 병합 업데이트
{ "SiteWiseAssetIdForHub": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }
라이선스
이 구성 요소에는 다음과 같은 타사 소프트웨어/라이선스가 포함됩니다.
-
쿼츠 잡 스케줄러/아파치
라이선스 2.0 -
GStreamer 1.x용 자바 바인딩/GNU
레서 제너럴 퍼블릭 라이선스 v3.0용
사용량
이 구성 요소를 구성하고 상호 작용하기 위해 코어 장치를 나타내는 AWS IoT SiteWise 자산과 해당 장치가 연결되는 IP 카메라에 속성을 설정할 수 있습니다. Grafana 대시보드에서 비디오 스트림을 시각화하고 상호 작용할 수도 있습니다. AWS IoT TwinMaker 자세한 내용은 사용 설명서의 AWS IoT TwinMaker 비디오 통합을 참조하십시오.AWS IoT TwinMaker
로컬 로그 파일
이 구성 요소는 다음 로그 파일을 사용합니다.
/logs/aws.iot.EdgeConnectorForKVS.log
/greengrass/v2
이 구성 요소의 로그를 보려면
-
코어 기기에서 다음 명령을 실행하여 이 구성 요소의 로그 파일을 실시간으로 확인합니다. AWS IoT Greengrass 루트 폴더
경로로 바꾸십시오./greengrass/v2
sudo tail -f
/logs/aws.iot.EdgeConnectorForKVS.log/greengrass/v2
Changelog
다음 표에는 각 구성 요소 버전의 변경 사항이 설명되어 있습니다.
버전 |
변경 |
---|---|
1.0.5 |
일반적인 버그 수정 및 개선입니다. |
1.0.4 |
|
1.0.3 |
일반적인 버그 수정 및 개선입니다. |
1.0.1 |
일반적인 버그 수정 및 개선입니다. |
1.0.0 |
초기 버전 |
다음 사항도 참조하십시오.
-
이게 AWS IoT TwinMaker 뭐야? AWS IoT TwinMaker 사용 설명서에서
-
AWS IoT TwinMaker AWS IoT TwinMaker 사용 설명서의 비디오 통합
-
무엇입니까 AWS IoT SiteWise? AWS IoT SiteWise 사용 설명서에서
-
AWS IoT SiteWise 사용 설명서의 속성 값 업데이트
-
AWS Secrets Manager 사용 설명서의 AWS Secrets Manager란 무엇입니까?
-
AWS Secrets Manager 사용 설명서에서 시크릿 생성 및 관리