

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

# Terapkan Agen Edge Streams Video Amazon Kinesis ke AWS IoT Greengrass
<a name="gs-edge-gg"></a>

 

Bagian ini memberikan panduan komprehensif untuk menggunakan Amazon Kinesis Video AWS IoT Greengrass Streams dengan. Dengan menggabungkan layanan ini, Anda dapat melakukan streaming video secara efisien dari perangkat edge ke cloud, memungkinkan berbagai aplikasi di IoT, pengawasan, dan banyak lagi.

Anda akan menemukan informasi rinci tentang:
+ Menyiapkan lingkungan pengembangan Anda
+ Membuat aliran video Kinesis
+ Membuat dan mengemas fungsi Lambda
+ Mengonfigurasi perangkat inti Kinesis Video Streams
+ Menyebarkan ke perangkat inti
+ Memverifikasi streaming Anda

Ikuti langkah-langkah berikut untuk menyebarkan Agen Edge Amazon Kinesis Video Streams AWS IoT Greengrass untuk merekam dan mengunggah media dari kamera IP.

**Topics**
+ [Buat instans Ubuntu Amazon EC2](gs-ubuntu.md)
+ [Siapkan perangkat AWS IoT Greengrass V2 inti pada perangkat](gs-setup-gg.md)
+ [Buat Amazon Kinesis Video AWS Secrets Manager Streams dan sumber daya untuk RTSP kamera IP Anda URLs](gs-create-resources.md)
+ [Tambahkan izin ke peran layanan pertukaran token (TES)](gs-add-permissions.md)
+ [Instal komponen AWS IoT Greengrass Secret Manager di perangkat](gs-install-secrets-manager.md)
+ [Menerapkan komponen Agen Tepi Amazon Kinesis Video Streams di perangkat AWS IoT Greengrass](gs-deploy-edge.md)
+ [Instal komponen pengelola AWS IoT Greengrass log di perangkat](gs-publish-edge.md)

# Buat instans Ubuntu Amazon EC2
<a name="gs-ubuntu"></a>

Lakukan hal berikut untuk membuat instance Ubuntu Amazon EC2.

**Buat instans Ubuntu Amazon EC2**

1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon EC2 di. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)

   Verifikasi bahwa Wilayah yang sesuai dipilih.

1. Pilih **Luncurkan Instans**.

   Lengkapi bidang-bidang berikut:
   + **Nama** - Ketik nama untuk contoh.
   + **Aplikasi dan Gambar OS (Amazon Machine Image)** - Pilih **Ubuntu**.
   + **Jenis instans** - Pilih **t2.large**.
   + **Login pasangan kunci** - Buat key pair Anda sendiri.
   + **Pengaturan jaringan** - Pertahankan default.
   + **Konfigurasikan penyimpanan** - Tingkatkan volume menjadi 256 GiB.
   + **Pengaturan lanjutan** - Pertahankan default.

1. Luncurkan instance dan SSH ke dalamnya.

   Lakukan hal-hal berikut:

   1. Pilih **Instans** di navigasi kiri, lalu pilih ID instans.

   1. Pilih **Connect** di kanan atas.

   1. Pilih **klien SSH** dan ikuti instruksi di layar.

   1. Buka terminal dan arahkan ke `.pem` file yang diunduh (kemungkinan masuk`~/Downloads`).

   1. Pertama kali Anda mengikuti prosedur ini, Anda akan menerima pesan “Keaslian tuan rumah (...) tidak dapat ditetapkan.” Ketik **ya**.

1. Instal pustaka sistem untuk membangun Agen Edge Amazon Kinesis Video Streams ke instance.

   ```
   wget -O- https://apt.corretto.aws/corretto.key | sudo apt-key add - 
   sudo add-apt-repository 'deb https://apt.corretto.aws stable main'
   
   sudo apt-get update
   
   sudo apt-get install -y gcc libssl-dev libcurl4-openssl-dev liblog4cplus-dev \
   libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev \
   gstreamer1.0-plugins-base-apps gstreamer1.0-plugins-bad \
   gstreamer1.0-plugins-good gstreamer1.0-tools \
   unzip java-11-amazon-corretto-jdk maven
   ```
**penting**  
**Jika Anda melihat layar yang memberi tahu Anda bahwa beberapa layanan perlu dimulai ulang, tekan Enter untuk memilih Ok.**

   Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com//corretto/latest/corretto-11-ug/generic-linux-install.html](https://docs.aws.amazon.com//corretto/latest/corretto-11-ug/generic-linux-install.html).

# Siapkan perangkat AWS IoT Greengrass V2 inti pada perangkat
<a name="gs-setup-gg"></a>

Ikuti prosedur ini untuk menginstal perangkat lunak AWS IoT Greengrass inti inti pada instans Amazon EC2.

**Siapkan perangkat AWS IoT Greengrass inti**

1. Masuk ke Konsol Manajemen AWS, [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/).

   Verifikasi bahwa Wilayah yang sesuai dipilih.

1. **Di navigasi kiri, pilih Perangkat **Greengrass**, Perangkat inti.**

1. Pilih **Siapkan satu perangkat inti**.

1. Selesaikan langkah-langkah di layar.
   + **Langkah 1: Daftarkan perangkat inti Greengrass**. Ketik nama untuk perangkat.
   + **Langkah 2: Tambahkan ke grup hal untuk menerapkan penerapan berkelanjutan**. Pilih **Tidak ada grup**.
   + **Langkah 3: Instal perangkat lunak Greengrass Core**. Pilih **Linux**.
     + **Langkah 3.1: Instal Java di perangkat**

       Java diinstal sebagai bagian dari [Buat instans Ubuntu Amazon EC2](gs-ubuntu.md) Kembali ke langkah itu jika Anda belum menginstal Java.
     + **Langkah 3.2: Salin AWS kredensional ke perangkat**

       Buka `bash/zsh` opsi dan tempel perintah ekspor di instans Amazon EC2.
     + **Langkah 3.3: Jalankan installer**

       1. Salin dan jalankan perintah **Unduh penginstal** dan **Jalankan penginstal** di instance Ubuntu Amazon EC2.
**catatan**  
Perintah **Run the installer** akan secara otomatis diperbarui berdasarkan nama yang Anda pilih pada langkah sebelumnya.

       1. Catat peran layanan pertukaran token (TES) yang dibuat. Anda membutuhkannya nanti.
**catatan**  
Secara default, peran yang dibuat disebut **GreenGrassV2 TokenExchangeRole**.

# Buat Amazon Kinesis Video AWS Secrets Manager Streams dan sumber daya untuk RTSP kamera IP Anda URLs
<a name="gs-create-resources"></a>

Ikuti prosedur ini untuk membuat aliran dan rahasia yang dibutuhkan. AWS Secrets Manager Lakukan langkah ini terlebih dahulu, karena Anda memerlukan sumber daya yang dibuat dalam kebijakan. ARNs 

## Buat Streaming Video Amazon Kinesis
<a name="gs-create-kvs"></a>

Buat Amazon Kinesis Video Streams Konsol Manajemen AWS menggunakan,, atau AWS CLI API.

Di Konsol Manajemen AWS, buka konsol [Amazon Kinesis Video Streams](https://console.aws.amazon.com/kinesisvideo/home/). Pilih **Streaming video** di navigasi kiri.

Untuk informasi selengkapnya, lihat [Buat aliran video Amazon Kinesis](gs-createstream.md).

## Buat rahasia di AWS Secrets Manager
<a name="gs-create-secrets"></a>

Di Konsol Manajemen AWS, buka [AWS Secrets Manager konsol](https://console.aws.amazon.com/secretsmanager/landing). Pilih **Rahasia** di navigasi kiri.

Verifikasi bahwa Wilayah yang sesuai dipilih.

1. Pilih **Simpan rahasia baru**.

   1. **Langkah 1: Pilih tipe rahasia**
      + Pilih **Jenis rahasia lainnya**.
      + Di bagian **Pasangan Kunci/Nilai, tambahkan pasangan** kunci-nilai. 

        **Kunci**: `MediaURI`
**catatan**  
Kuncinya harus`MediaURI`. Ini peka huruf besar/kecil. Jika Anda salah memasukkannya, aplikasi tidak berfungsi.

        **Nilai**:`Your MediaURI`.  
**Example**  

        **Contoh:**`rtsp://<YourCameraIPAddress>:<YourCameraRTSPPort>/YourCameraMediaURI`.

   1. **Langkah 2: Konfigurasikan rahasia**. Beri nama rahasia ini. Beri nama apa pun yang Anda inginkan.

   1. **Langkah 3: Konfigurasikan rotasi - opsional**. Pilih **Berikutnya**.

   1. **Langkah 4: Tinjau**. Pilih **Toko**.

1. Jika rahasia Anda tidak segera ditampilkan, pilih tombol refresh.

   Pilih nama rahasia Anda. Catat **ARN Rahasia**.

1. Ulangi proses ini untuk setiap MediAuri yang ingin Anda streaming.

**catatan**  
 AWS Jaringan memblokir beberapa sumber RTSP publik. Anda tidak dapat mengakses ini dari dalam instans Amazon EC2 atau jika Anda menjalankan unmanaged saat terhubung ke VPN.  
URL RTSP kamera Anda harus melakukan streaming video dalam format h.264. Durasi fragmen tidak boleh melebihi batas yang disebutkan dalam[Kuota SDK produsen](limits.md#producer-sdk-limits).  
Amazon Kinesis Video Streams Edge Agent hanya mendukung video.
Jalankan `gst-discoverer-1.0 Your RtspUrl` untuk memastikan bahwa kamera Anda dapat dijangkau dari perangkat Anda.

Simpan ARNs untuk semua aliran dan rahasia yang Anda buat. Anda membutuhkan ini untuk langkah selanjutnya.

# Tambahkan izin ke peran layanan pertukaran token (TES)
<a name="gs-add-permissions"></a>

Berikan peran layanan pertukaran token (TES) ke perangkat yang mengasumsikan izin untuk melihat rahasia. Ini diperlukan agar AWS Secrets Manager AWS IoT Greengrass komponen berfungsi dengan benar.

**Menambahkan izin ke peran TES**

1. Masuk ke Konsol Manajemen AWS dan buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. Pilih **Peran** di navigasi kiri dan cari peran TES yang Anda buat sebelumnya dalam proses.

1. **Di menu tarik-turun **Tambahkan izin**, pilih Lampirkan kebijakan.**

1. Pilih **Buat kebijakan**.

1. Gulir ke bawah dan pilih **Edit**.

1. Di editor kebijakan, pilih **JSON** dan edit kebijakan.

   Ganti kebijakan dengan yang berikut:
**catatan**  
Ganti `arn:aws:kinesisvideo:*:*:stream/streamName1/*` dan `arn:aws:kinesisvideo:*:*:stream/streamName2/*` dengan ARNs untuk aliran yang Anda buat pada langkah sebelumnya.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "kinesisvideo:ListStreams"
               ],
               "Resource": "*"
           },
           {
               "Effect": "Allow",
               "Action": [
                   "kinesisvideo:DescribeStream",
                   "kinesisvideo:PutMedia",
                   "kinesisvideo:TagStream",
                   "kinesisvideo:GetDataEndpoint"
               ],
               "Resource": [
                   "arn:aws:kinesisvideo:*:*:stream/streamName1/*",
                   "arn:aws:kinesisvideo:*:*:stream/streamName2/*"
               ]
           }
       ]
   }
   ```

------

1. Pada halaman **Tambahkan tanda**, pilih **Berikutnya:**

1. Beri nama kebijakan Anda, lalu pilih **Buat kebijakan**.

   Contoh nama kebijakan adalah **KvsEdgeAccessPolicy**.

1. Tutup tab dan kembali ke tab tempat Anda melampirkan kebijakan ke peran TES.

   Pilih tombol refresh, lalu cari kebijakan yang baru dibuat.

   Pilih kotak centang dan pilih **Lampirkan kebijakan**.

   Di layar berikutnya, Anda melihat catatan yang mengatakan **Kebijakan berhasil dilampirkan ke peran.**

1. Buat dan lampirkan kebijakan lain, kali ini untuk rahasia Anda.

   Ganti kebijakan dengan yang berikut:
**catatan**  
Ganti `arn:aws:secretsmanager:*:*:secret:*` dengan yang ARNs berisi rahasia MediAuri yang Anda buat. [Buat Amazon Kinesis Video AWS Secrets Manager Streams dan sumber daya untuk RTSP kamera IP Anda URLs](gs-create-resources.md)

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": "secretsmanager:GetSecretValue",
               "Resource": [
                   "arn:aws:secretsmanager:*:*:secret:*",
                   "arn:aws:secretsmanager:*:*:secret:*"
               ]
           }
       ]
   }
   ```

------

1. Buat dan lampirkan kebijakan lain, kali ini untuk Amazon CloudWatch metrik. Ganti kebijakan dengan yang berikut:

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "cloudwatch:PutMetricData"
               ],
               "Resource": [
                   "*"
               ]
           }
       ]
   }
   ```

------

# Instal komponen AWS IoT Greengrass Secret Manager di perangkat
<a name="gs-install-secrets-manager"></a>

Agen Edge Streams Video Amazon Kinesis AWS IoT Greengrass memerlukan komponen Secret Manager untuk diinstal pada perangkat terlebih dahulu.

**Instal komponen Secret Manager**

1. Masuk ke Konsol Manajemen AWS dan buka AWS IoT Core konsol di [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/). Verifikasi bahwa Wilayah yang sesuai dipilih.

1. **Di navigasi kiri, pilih Perangkat **Greengrass**, Deployment.**

   Pilih penerapan dengan target yang sama dengan hal yang kita buat. [Siapkan perangkat AWS IoT Greengrass V2 inti pada perangkat](gs-setup-gg.md)

1. **Di menu tarik-turun **Tindakan** di pojok kanan atas, pilih Revisi.**

   Di pop-up yang muncul, pilih **Revise** deployment.

1. Lengkapi bagian berikut:
   + **Langkah 1: Tentukan target**. Pilih **Berikutnya**.
   + **Langkah 2: Pilih komponen**.
     + Verifikasi bahwa komponen **AWS.greengrass.cli dipilih**. Jangan hapus instalan komponen ini.
     + **Alihkan sakelar **Tampilkan hanya komponen yang dipilih** dan cari aws.greengrass. SecretManager**.
     + Centang kotak di sebelah **aws.greengrass. SecretManager**, lalu pilih **Berikutnya**.
   + **Langkah 3: Konfigurasikan komponen**. Konfigurasikan komponen AWS IoT Greengrass Secret Manager untuk mengunduh rahasia dari dalam AWS IoT Greengrass lingkungan.

     Pilih **aws.greengrass. SecretManager**komponen, lalu pilih **Configure component**.

     Di layar yang muncul, perbarui AWS Secrets Manager ARNs di kotak **Konfigurasi untuk digabungkan**.
**catatan**  
Ganti `arn:aws:secretsmanager:*:*:secret:*` dengan rahasia yang Anda buat[Buat Amazon Kinesis Video AWS Secrets Manager Streams dan sumber daya untuk RTSP kamera IP Anda URLs](gs-create-resources.md). ARNs 

     ```
     {
      "cloudSecrets": [
           {
             "arn": "arn:aws:secretsmanager:*:*:secret:*"
           },
           {
             "arn": "arn:aws:secretsmanager:*:*:secret:*"
           }
         ]
     }
     ```
**catatan**  
`cloudSecrets`adalah daftar objek dengan kuncinya`arn`. Untuk informasi selengkapnya, lihat bagian [Konfigurasi manajer rahasia](https://docs.aws.amazon.com//greengrass/v2/developerguide/secret-manager-component.html#secret-manager-component-configuration) di Panduan AWS IoT Greengrass Version 2 Pengembang. 

     Setelah selesai, pilih **Konfirmasi**, lalu pilih **Berikutnya**.
   + **Langkah 4: Konfigurasikan pengaturan lanjutan**. Pilih **Selanjutnya**.
   + **Langkah 5: Tinjau**. Pilih **Terapkan**.

1. Konfirmasikan bahwa AWS Secrets Manager komponen dan izin telah diinstal dengan benar.

   Pada instance Ubuntu Amazon EC2, ketik `sudo /greengrass/v2/bin/greengrass-cli component details --name aws.greengrass.SecretManager` untuk memverifikasi bahwa komponen menerima konfigurasi yang diperbarui.

1. Periksa log AWS IoT Greengrass inti.

   Ketik `sudo less /greengrass/v2/logs/greengrass.log`.

   Tinjau kesalahan penerapan. 

   Jika ada kesalahan, revisi penerapan untuk menghapus komponen. `aws.greengrass.SecretManager`

   Ketik `sudo service greengrass restart` untuk memulai ulang layanan AWS IoT Greengrass inti.

   Jika kesalahan penerapan terkait dengan izin yang hilang, tinjau [Tambahkan izin ke peran layanan pertukaran token (TES)](gs-add-permissions.md) bagian tersebut untuk memastikan bahwa peran TES memiliki izin yang tepat. Kemudian, ulangi bagian ini.

1. **Perbarui rahasia pada komponen AWS IoT Greengrass Secret Manager**
**penting**  
Komponen AWS IoT Greengrass Secret Manager mengambil dan menyimpan rahasia hanya ketika penerapan diperbarui.

   Untuk memperbarui rahasia pada komponen AWS IoT Greengrass Secret Manager, ikuti langkah sebelumnya 1—6, dengan perubahan berikut.

   **Langkah 3: Konfigurasikan komponen**. Konfigurasikan komponen AWS IoT Greengrass Secret Manager untuk mengunduh rahasia dari dalam AWS IoT Greengrass lingkungan.

   Pilih **aws.greengrass. SecretManager**komponen, lalu pilih **Configure component**.

   Di layar yang muncul, tempel `[""]` di kotak **Atur ulang jalur**, dan perbarui AWS Secrets Manager ARNs di kotak **Konfigurasi untuk digabungkan**.

   Untuk informasi selengkapnya, lihat [Mengatur ulang pembaruan](https://docs.aws.amazon.com//greengrass/v2/developerguide/update-component-configurations.html#reset-configuration-update).

# 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.

# Instal komponen pengelola AWS IoT Greengrass log di perangkat
<a name="gs-publish-edge"></a>

**catatan**  
Waspadai [CloudWatchkuota](https://docs.aws.amazon.com//AmazonCloudWatch/latest/logs/cloudwatch_limits_cwl.html).

Ikuti prosedur ini untuk mengonfigurasi log Agen Tepi Amazon Kinesis Video Streams untuk CloudWatch mengunggah secara otomatis AWS IoT Greengrass menggunakan komponen pengelola log. Ini adalah langkah opsional.

**Instal komponen pengelola AWS IoT Greengrass log**

1. Konfirmasikan bahwa peran AWS IoT Greengrass perangkat memiliki [izin yang sesuai](https://docs.aws.amazon.com//greengrass/v2/developerguide/log-manager-component.html#log-manager-component-requirements).

   1. Masuk ke Konsol Manajemen AWS dan buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

   1. Klik **Peran** di navigasi kiri.

   1. Pilih nama peran TES yang dibuat di[Siapkan perangkat AWS IoT Greengrass V2 inti pada perangkat](gs-setup-gg.md). Gunakan bilah pencarian jika perlu.

   1. Pilih `GreengrassV2TokenExchangeRoleAccess` kebijakan.

   1. Pilih tab JSON dan verifikasi bahwa kebijakan terlihat seperti berikut:

------
#### [ JSON ]

****  

      ```
      {
          "Version":"2012-10-17",		 	 	 
          "Statement": [
              {
                  "Effect": "Allow",
                  "Action": [
                      "logs:CreateLogGroup",
                      "logs:CreateLogStream",
                      "logs:PutLogEvents",
                      "logs:DescribeLogStreams",
                      "s3:GetBucketLocation"
                  ],
                  "Resource": "*"
              }
          ]
      }
      ```

------

   1. Jika `GreengrassV2TokenExchangeRoleAccess` kebijakan tidak ada, atau jika beberapa izin yang diperlukan tidak ada, buat kebijakan IAM baru dengan izin ini dan lampirkan ke peran TES yang dibuat. [Siapkan perangkat AWS IoT Greengrass V2 inti pada perangkat](gs-setup-gg.md)

1. Masuk ke Konsol Manajemen AWS dan buka AWS IoT Core konsol di [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/). Verifikasi bahwa Wilayah yang sesuai dipilih.

1. **Di navigasi kiri, pilih Perangkat **Greengrass**, Deployment.**

   Pilih penerapan dengan target yang sama dengan hal yang Anda buat. [Siapkan perangkat AWS IoT Greengrass V2 inti pada perangkat](gs-setup-gg.md)

1. Di pojok kanan atas, pilih **Tindakan**, lalu pilih **Revisi**.

   Di pop-up yang muncul, pilih **Revise** deployment.

1. Lengkapi bagian berikut:

   1. **Langkah 1: Tentukan target.** Pilih **Berikutnya**.

   1. **Langkah 2: Pilih komponen.**

      1. **Verifikasi bahwa komponen **AWS.greengrass.cli dan aws.greengrass**. SecretManager**komponen masih dipilih.
**penting**  
Jangan hapus instalan komponen ini.

      1. **Alihkan sakelar **Tampilkan hanya komponen yang dipilih** dan cari aws.greengrass. LogManager**.

      1. Pilih kotak di sebelah **aws.greengrass. LogManager**, lalu pilih **Berikutnya**.

   1. **Langkah 3: Konfigurasikan komponen.** Konfigurasikan komponen pengelola AWS IoT Greengrass log untuk mengunggah log yang dihasilkan oleh Agen Tepi Amazon Kinesis Video Streams.

      Pilih **aws.greengrass. LogManager**komponen, lalu pilih **Configure component**.

      Di layar yang muncul, tempel konfigurasi pengelola log berikut di kotak **Konfigurasi untuk digabungkan**.

      ```
      {
          "logsUploaderConfiguration": {
              "componentLogsConfigurationMap": {
                  "aws.kinesisvideo.KvsEdgeComponent/java_kvs.log": {
                      "diskSpaceLimit": "100",
                      "diskSpaceLimitUnit": "MB",
                      "logFileDirectoryPath": "/greengrass/v2/work/aws.kinesisvideo.KvsEdgeComponent/log",
                      "logFileRegex": "java_kvs.log\\w*"
                  },
                  "aws.kinesisvideo.KvsEdgeComponent/cpp_kvs_edge.log": {
                      "diskSpaceLimit": "100",
                      "diskSpaceLimitUnit": "MB",
                      "logFileDirectoryPath": "/greengrass/v2/work/aws.kinesisvideo.KvsEdgeComponent/log",
                      "logFileRegex": "cpp_kvs_edge.log\\w*"
                  },
                  "aws.kinesisvideo.KvsEdgeComponent/cpp_kvssink.log": {
                      "diskSpaceLimit": "100",
                      "diskSpaceLimitUnit": "MB",
                      "logFileDirectoryPath": "/greengrass/v2/work/aws.kinesisvideo.KvsEdgeComponent/log",
                      "logFileRegex": "cpp_kvssink.log\\w*"
                  },
                  "aws.kinesisvideo.KvsEdgeComponent/cpp_kvs_streams.log": {
                      "diskSpaceLimit": "100",
                      "diskSpaceLimitUnit": "MB",
                      "logFileDirectoryPath": "/greengrass/v2/work/aws.kinesisvideo.KvsEdgeComponent/log",
                      "logFileRegex": "cpp_kvs_streams.log\\w*"
                  }
              }
          },
          "periodicUploadIntervalSec": "1"
      }
      ```
**penting**  
`logFileDirectoryPath`Dalam konfigurasi sebelumnya mengasumsikan bahwa lokasi output logging default digunakan.
**catatan**  
Untuk informasi selengkapnya tentang masing-masing parameter untuk konfigurasi pengelola log, lihat bagian [Manajer log](https://docs.aws.amazon.com//greengrass/v2/developerguide/log-manager-component.html#log-manager-component-configuration) dari Panduan AWS IoT Greengrass Version 2 Pengembang.

      Setelah selesai, pilih **Konfirmasi**, lalu pilih **Berikutnya**.

   1. **Langkah 4: Konfigurasikan pengaturan lanjutan.** Pilih **Selanjutnya**.

   1. **Langkah 5: Tinjau.** Pilih **Terapkan**.

1. Konfirmasikan bahwa komponen pengelola AWS log dan izin telah diinstal dengan benar.

1. Pada instance Ubuntu Amazon EC2, ketik `sudo /greengrass/v2/bin/greengrass-cli component details --name aws.greengrass.LogManager` untuk memverifikasi komponen menerima konfigurasi yang diperbarui.

1. Periksa log AWS IoT Greengrass inti.

   Ketik `sudo less /greengrass/v2/logs/greengrass.log`.

   Tinjau kesalahan penerapan.

   Jika ada kesalahan, revisi penerapan untuk menghapus komponen. `aws.greengrass.LogManager`

   Ketik `sudo service greengrass restart` untuk memulai ulang layanan AWS IoT Greengrass inti.

   Jika kesalahan penerapan terkait dengan izin yang hilang, tinjau [Tambahkan izin ke peran layanan pertukaran token (TES)](gs-add-permissions.md) untuk memastikan bahwa peran TES memiliki izin yang tepat. Kemudian, ulangi bagian ini.