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

# 디바이스에 Amazon Kinesis Video Streams Edge Agent AWS IoT Greengrass 구성 요소 배포
<a name="gs-deploy-edge"></a>

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

**구성 요소 배포**

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

   Amazon Kinesis Video Streams Edge 에이전트 관심 양식을 작성한 경우 이메일에서 다운로드 링크를 확인하세요. 양식을 작성하지 않은 경우 [여기에서](https://pages.awscloud.com/GLOBAL-launch-DL-KVS-Edge-2023-learn.html) 작성하세요.

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

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

   유형: `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으로 설정됩니다.

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

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

   유형 `mvn clean package`

   그러면에서 Amazon Kinesis Video Streams Edge 에이전트에 필요한 종속성이 포함된 jar 파일이 생성됩니다`kvs-edge-agent/target/libs.jar`.

1. 구성 요소의 아티팩트가 포함된 폴더에 libs.jar를 배치합니다.

   유형 `mv ./target/libs.jar ./KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/`

1. **선택 사항**. 속성을 구성합니다. Amazon Kinesis Video Streams Edge 에이전트는 모드에서 다음 환경 변수를 허용합니다. AWS IoT Greengrass     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/kinesisvideostreams/latest/dg/gs-deploy-edge.html)

   실행 스크립트를 `kvs-edge-agent/KvsEdgeComponent/recipes/recipe.yaml` 열고 수정하여 위의 환경 변수 중 하나를 추가합니다.
**중요**  
수정된 실행 스크립트에 **탭** 문자가 포함되어 있지 않은지 확인합니다. AWS IoT Greengrass 코어 소프트웨어는 레시피를 읽을 수 없습니다.

1. Amazon Kinesis Video Streams Edge 에이전트 AWS IoT Greengrass 구성 요소를 배포합니다.

   유형: 

   ```
   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 개발자 안내서*의 다음 섹션을 참조하세요.
   + [AWS IoT Greengrass CLI 명령](https://docs.aws.amazon.com//greengrass/v2/developerguide/gg-cli-reference.html)
   + [디바이스에 AWS IoT Greengrass 구성 요소 배포](https://docs.aws.amazon.com//greengrass/v2/developerguide/manage-deployments.html)

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

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

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

      자세한 내용은 [StartEdgeConfigurationUpdate](API_StartEdgeConfigurationUpdate.md) 단원을 참조하십시오.

      ```
      {
          "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
              }
          }
      }
      ```

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

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

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