

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Menerapkan komponen Agen Tepi Amazon Kinesis Video Streams di perangkat AWS IoT Greengrass
<a name="gs-deploy-edge"></a>

Lakukan hal berikut untuk menerapkan komponen Amazon Kinesis Video Streams Edge AWS IoT Greengrass Agent di perangkat:

**Menyebarkan komponen**

1. Unduh `tar` file menggunakan tautan yang disediakan.

   Jika Anda mengisi formulir minat Agen Edge Amazon Kinesis Video Streams, periksa email Anda untuk tautan unduhan. Jika Anda belum mengisi formulir, lengkapi [di sini](https://pages.awscloud.com/GLOBAL-launch-DL-KVS-Edge-2023-learn.html).

1. Verifikasi checksum.

1. Ekstrak binari dan toples di perangkat Anda.

   Jenis:`tar -xvf kvs-edge-agent.tar.gz`.

   Setelah ekstraksi, struktur folder Anda akan terlihat seperti berikut:

   ```
   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
   ```
**catatan**  
Nama folder rilis harus diatur dengan cara yang mencerminkan nomor rilis biner terbaru. Misalnya, rilis 1.0.0 akan memiliki nama folder ditetapkan sebagai 1.0.0. 

1. Bangun jar dependensi. 
**catatan**  
Guci yang disertakan kvs-edge-agent dengan.tar.gz tidak memiliki dependensi. Gunakan langkah-langkah berikut untuk membangun pustaka tersebut.

   Arahkan ke `kvs-edge-agent` folder yang berisi`pom.xml`. 

   Ketik `mvn clean package`.

   Ini akan menghasilkan file jar yang berisi dependensi yang dibutuhkan Agen Tepi Amazon Kinesis Video Streams. `kvs-edge-agent/target/libs.jar`

1. Tempatkan libs.jar ke dalam folder yang berisi artefak komponen.

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

1. **Opsional.** Konfigurasikan properti. Agen Edge Streams Video Amazon Kinesis menerima variabel lingkungan berikut dalam mode: AWS IoT Greengrass     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kinesisvideostreams/latest/dg/gs-deploy-edge.html)

   Buka `kvs-edge-agent/KvsEdgeComponent/recipes/recipe.yaml` dan modifikasi skrip run untuk menambahkan salah satu variabel lingkungan sebelumnya.
**penting**  
Pastikan bahwa skrip run yang dimodifikasi tidak berisi karakter **tab** apa pun. Perangkat lunak AWS IoT Greengrass inti tidak akan dapat membaca resepnya.

1. Menerapkan komponen Agen Tepi Amazon Kinesis Video Streams. AWS IoT Greengrass 

   Jenis:

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

   Untuk informasi tambahan, lihat bagian berikut di *Panduan AWS IoT Greengrass Version 2 Pengembang*:
   + [AWS IoT Greengrass Perintah CLI](https://docs.aws.amazon.com//greengrass/v2/developerguide/gg-cli-reference.html)
   + [Menyebarkan AWS IoT Greengrass komponen ke perangkat](https://docs.aws.amazon.com//greengrass/v2/developerguide/manage-deployments.html)

1. Kirim konfigurasi ke aplikasi menggunakan file. AWS CLI

   1. Buat file baru,`example-edge-configuration.json`. 

      Tempel kode berikut ke file. Ini adalah konfigurasi sampel yang mencatat setiap hari mulai pukul 9:00:00 hingga 16:59:59 (sesuai dengan waktu sistem di perangkat Anda). AWS IoT Ini juga mengunggah media yang direkam setiap hari dari pukul 19:00:00 hingga 9:59:59 PM.

      Untuk informasi selengkapnya, lihat [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. Ketik berikut ini AWS CLI untuk mengirim file ke Agen Edge Amazon Kinesis Video Streams:

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

1. Ulangi langkah sebelumnya untuk setiap streaming untuk Agen Tepi Amazon Kinesis Video Streams.