디바이스에 Amazon Kinesis Video Streams Edge Agent AWS IoT Greengrass 구성 요소 배포 - Amazon Kinesis Video Streams

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

디바이스에 Amazon Kinesis Video Streams Edge Agent AWS IoT Greengrass 구성 요소 배포

다음을 수행하여 디바이스에 Amazon Kinesis Video Streams Edge Agent AWS IoT Greengrass 구성 요소를 배포합니다.

구성 요소 배포

  1. 제공된 링크를 사용하여 tar 파일을 다운로드합니다.

    Amazon Kinesis Video Streams Edge Agent 관심 양식을 작성한 경우 이메일에서 다운로드 링크를 확인하세요. 양식을 작성하지 않은 경우 여기에서 작성하세요.

  2. 체크섬을 확인합니다.

  3. 디바이스에서 바이너리와 병을 추출합니다.

    유형: tar -xvf kvs-edge-agent.tar.gz.

    추출 후 폴더 구조는 다음과 같습니다.

    kvs-edge-agent/LICENSE
kvs-edge-agent/THIRD-PARTY-LICENSES
kvs-edge-agent/pom.xml
kvs-edge-agent/KvsEdgeComponent
kvs-edge-agent/KvsEdgeComponent/recipes
kvs-edge-agent/KvsEdgeComponent/recipes/recipe.yaml
kvs-edge-agent/KvsEdgeComponent/artifacts
kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent
kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion
kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/edge_log_config                   
kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/kvs-edge-agent.jar
kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/libgstkvssink.so
kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/libIngestorPipelineJNI.so
kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/lib
kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/lib/libcproducer.so
kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/lib/libKinesisVideoProducer.so
    참고

    릴리스 폴더 이름은 최신 바이너리 릴리스 번호를 반영하는 방식으로 설정해야 합니다. 예를 들어 1.0.0 릴리스의 폴더 이름은 1.0.0으로 설정됩니다.

  4. 종속성 jar을 빌드합니다.

    참고

    kvs-edge-agent.tar.gz에 포함된 jar에는 종속성이 없습니다. 다음 단계에 따라 해당 라이브러리를 빌드합니다.

    가 포함된 kvs-edge-agent 폴더로 이동합니다pom.xml.

    mvn clean package를 입력합니다.

    이렇게 하면 에서 Amazon Kinesis Video Streams Edge Agent에 필요한 종속 항목이 포함된 jar 파일이 생성됩니다kvs-edge-agent/target/libs.jar.

  5. libs.jar를 구성 요소의 아티팩트가 포함된 폴더에 넣습니다.

    mv ./target/libs.jar ./KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/를 입력합니다.

  6. 선택 사항. 속성을 구성합니다. Amazon Kinesis Video Streams Edge Agent는 모드에서 AWS IoT Greengrass 다음 환경 변수를 허용합니다.

    환경 변수 이름 필수 설명

    AWS_REGION

    예

    사용되는 리전입니다.

    예: us-west-2

    AWS IoT Greengrass 코어 소프트웨어는 자동으로 이 값을 설정합니다. 자세한 내용은 AWS IoT Greengrass Version 2 개발자 안내서의 구성 요소 환경 변수 참조 주제를 참조하세요.

    GST_PLUGIN_PATH

    예

    gstkvssink 및 IngestorPipelineJNI 플랫폼 종속 라이브러리가 포함된 폴더를 가리키는 파일 경로입니다. 이렇게 하면 이러한 플러그인을 GStreamer 로드할 수 있습니다. 자세한 내용은 GStreamer요소를 다운로드, 빌드, 구성합니다. 단원을 참조하십시오.

    예: /download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/

    LD_LIBRARY_PATH

    예

    cproducer 및 KinesisVideoProducer 플랫폼 종속 라이브러리가 포함된 디렉터리를 가리키는 파일 경로입니다.

    예: /download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/lib/

    AWS_KVS_EDGE_CLOUDWATCH_ENABLED

    아니요

    Amazon Kinesis Video Streams Edge Agent가 작업 상태 지표를 에 게시할지 여부를 결정합니다 Amazon CloudWatch.

    허용되는 값: TRUE/FALSE(대소문자를 구분하지 않음). 제공되지 않은 FALSE 경우 기본값은 입니다.

    예: FALSE

    AWS_KVS_EDGE_LOG_LEVEL

    아니요

    Amazon Kinesis Video Streams Edge Agent 출력 로깅 수준입니다.

    허용되는 값:

    • OFF

    • ALL

    • FATAL

    • ERROR

    • WARN

    • INFO, 기본값, 제공되지 않은 경우

    • DEBUG

    • TRACE

    예: INFO

    AWS_KVS_EDGE_LOG_MAX_FILE_SIZE

    아니요

    로그 파일이 이 크기에 도달하면 롤오버가 발생합니다.

    • 최소: 1

    • 최대: 100

    • 기본값: 20, 제공되지 않은 경우

    • 단위: 메가바이트(MB)

    예: 5

    AWS_KVS_EDGE_LOG_OUTPUT_DIRECTORY

    아니요

    Amazon Kinesis Video Streams Edge Agent 로그가 출력되는 디렉터리를 가리키는 파일 경로입니다. 제공되지 않은 ./log 경우 기본값은 입니다.

    예: /file/path/

    AWS_KVS_EDGE_LOG_ROLLOVER_COUNT

    아니요

    삭제하기 전에 유지할 롤오버 로그 수입니다.

    • 최소: 1

    • 최대: 100

    • 기본값: 10, 제공되지 않은 경우

    예: 20

    AWS_KVS_EDGE_RECORDING_DIRECTORY

    아니요

    디렉터리 기록 미디어를 가리키는 파일 경로가 기록됩니다. 제공되지 않은 경우 기본값은 현재 디렉터리입니다.

    예: /file/path/

    GREENGRASS_ROOT_DIRECTORY

    아니요

    AWS IoT Greengrass 루트 디렉터리의 파일 경로입니다.

    제공되지 않은 /greengrass/v2/ 경우 기본값은 입니다.

    예: /file/path/

    GST_DEBUG

    아니요

    출력할 GStreamer 로그 수준을 지정합니다. 자세한 내용은 GStreamer 설명서를 참조하세요.

    예: 0

    GST_DEBUG_FILE

    아니요

    GStreamer 디버그 로그의 출력 파일을 지정합니다. 설정되지 않으면 디버그 로그가 표준 오류로 출력됩니다. 자세한 내용은 GStreamer 설명서를 참조하세요.

    예: /tmp/gstreamer-logging.log

    실행 스크립트를 kvs-edge-agent/KvsEdgeComponent/recipes/recipe.yaml 열고 수정하여 이전 환경 변수 중 하나를 추가합니다.

    중요

    수정된 실행 스크립트에 탭 문자가 포함되어 있지 않은지 확인합니다. AWS IoT Greengrass 코어 소프트웨어는 레시피를 읽을 수 없습니다.

  7. Amazon Kinesis Video Streams Edge Agent AWS IoT Greengrass 구성 요소를 배포합니다.

    Type:

    sudo /greengrass/v2/bin/greengrass-cli deployment create \
  --recipeDir <download location>/kvs-edge-agent/KvsEdgeComponent/recipes/ \
  --artifactDir <download location>/kvs-edge-agent/KvsEdgeComponent/artifacts/ \
  --merge "aws.kinesisvideo.KvsEdgeComponent=EdgeAgentVersion"

    자세한 내용은 AWS IoT Greengrass Version 2 개발자 안내서의 다음 섹션을 참조하세요.

  8. 를 사용하여 애플리케이션에 구성을 전송합니다 AWS CLI.

    1. 새 파일 을 생성합니다example-edge-configuration.json.

      다음 코드를 파일에 붙여 넣습니다. 이는 매일 오전 9시부터 오후 4시 59분 59분까지( AWS IoT 장치의 시스템 시간에 따라) 기록하는 샘플 구성입니다. 또한 매일 오후 7시부터 오후 9시 59분 59초까지 기록된 미디어를 업로드합니다.

      자세한 내용은 StartEdgeConfigurationUpdate 단원을 참조하십시오.

      {
    "StreamARN": "arn:aws:kinesisvideo:your-region:your-account-id:stream/your-stream/0123456789012",
    "EdgeConfig": {
        "HubDeviceArn": "arn:aws:iot:your-region:your-account-id:thing/kvs-edge-agent-demo",
        "RecorderConfig": {
            "MediaSourceConfig": {
                "MediaUriSecretArn": "arn:aws:secretsmanager:your-region:your-account-id:secret:your-secret-dRbHJQ",
                "MediaUriType": "RTSP_URI"
            },
            "ScheduleConfig": {
                "ScheduleExpression": "0 0 9,10,11,12,13,14,15,16 ? * * *",
                "DurationInSeconds": 3599
            }
        },
        "UploaderConfig": {
            "ScheduleConfig": {
                "ScheduleExpression": "0 0 19,20,21 ? * * *",
                "DurationInSeconds": 3599
            }
        },
        "DeletionConfig": {
            "EdgeRetentionInHours": 15,
            "LocalSizeConfig": {
              "MaxLocalMediaSizeInMB": 2800,
              "StrategyOnFullSize": "DELETE_OLDEST_MEDIA"
            },
            "DeleteAfterUpload": true
        }
    }
}

    2. 에 다음을 입력하여 Amazon Kinesis Video Streams Edge Agent로 파일을 AWS CLI 전송합니다.

      aws kinesisvideo start-edge-configuration-update --cli-input-json "file://example-edge-configuration.json"

  9. Amazon Kinesis Video Streams Edge Agent의 각 스트림에 대해 이전 단계를 반복합니다.