Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Tutorial: Menginstal dan mengkonfigurasi AWS IoT Device Client Tutorial ini memandu Anda melalui instalasi dan konfigurasi AWS IoT Device Client dan pembuatan AWS IoT sumber daya yang akan Anda gunakan dalam demo ini dan lainnya. **Untuk memulai tutorial ini:** + Siapkan komputer host lokal Anda dan Raspberry Pi dari [tutorial sebelumnya](iot-dc-prepare-device.md). Tutorial ini bisa memakan waktu hingga 90 menit untuk menyelesaikannya. **Setelah Anda selesai dengan topik ini:** + Perangkat IoT Anda akan siap digunakan dalam demo Klien AWS IoT Perangkat lainnya. + Anda akan menyediakan perangkat IoT Anda di. AWS IoT Core + Anda akan mengunduh dan menginstal AWS IoT Device Client di perangkat Anda. + Anda akan menyimpan gambar kartu microSD perangkat Anda yang dapat digunakan dalam tutorial berikutnya. **Peralatan yang dibutuhkan:** + Lingkungan pengembangan dan pengujian lokal Anda [dari bagian sebelumnya](iot-dc-prepare-device-test.md) + Raspberry Pi yang Anda gunakan [di bagian sebelumnya](iot-dc-prepare-device-test.md) + Kartu memori microSD dari Raspberry Pi yang Anda gunakan di [bagian sebelumnya](iot-dc-prepare-device-test.md) **Topics** + [Unduh dan simpan AWS IoT Device Client](iot-dc-install-download.md) + [Menyediakan Raspberry Pi Anda di AWS IoT](iot-dc-install-provision.md) + [Konfigurasikan AWS IoT Device Client untuk menguji konektivitas](iot-dc-install-configure.md) # Unduh dan simpan AWS IoT Device Client Prosedur di bagian ini mengunduh AWS IoT Device Client, mengompilasinya, dan menginstalnya di Raspberry Pi Anda. Setelah Anda menguji instalasi, Anda dapat menyimpan gambar kartu microSD Raspberry Pi untuk digunakan nanti ketika Anda ingin mencoba tutorial lagi. **Topics** + [Unduh dan buat Klien AWS IoT Perangkat](#iot-dc-install-dc-download) + [Buat direktori yang digunakan oleh tutorial](#iot-dc-install-dc-files) + [(Opsional) Simpan gambar kartu microSD](#iot-dc-install-dc-save) ## Unduh dan buat Klien AWS IoT Perangkat Prosedur ini menginstal AWS IoT Device Client pada Raspberry Pi Anda. Lakukan perintah ini di jendela terminal di komputer host lokal Anda yang terhubung ke Raspberry Pi Anda. **Untuk menginstal AWS IoT Device Client pada Raspberry Pi Anda** 1. Masukkan perintah ini untuk mengunduh dan membangun AWS IoT Device Client di Raspberry Pi Anda. ``` cd ~ git clone https://github.com/awslabs/aws-iot-device-client aws-iot-device-client mkdir ~/aws-iot-device-client/build && cd ~/aws-iot-device-client/build cmake ../ ``` 1. Jalankan perintah ini untuk membangun AWS IoT Device Client. Perintah ini dapat memakan waktu hingga 15 menit untuk diselesaikan. ``` cmake --build . --target aws-iot-device-client ``` Pesan peringatan yang ditampilkan sebagai kompilasi AWS IoT Device Client dapat diabaikan. Tutorial ini telah diuji dengan AWS IoT Device Client bawaan**gcc**, versi (Raspbian 10.2.1-6\$1rpi1) 10.2.1 20210110 pada versi 30 Oktober 2021 dari Raspberry Pi OS (bullseye) aktif, versi (Raspbian 8.3.0-6\$1rpi1) 8.3.0 pada **gcc** versi 7 Mei 2021 dari Raspberry Pi OS (buster). 1. Setelah AWS IoT Device Client selesai membangun, uji dengan menjalankan perintah ini. ``` ./aws-iot-device-client --help ``` Jika Anda melihat bantuan baris perintah untuk Klien AWS IoT AWS IoT Perangkat, Klien Perangkat telah berhasil dibangun dan siap untuk Anda gunakan. ## Buat direktori yang digunakan oleh tutorial Prosedur ini membuat direktori pada Raspberry Pi yang akan digunakan untuk menyimpan file yang digunakan oleh tutorial di jalur pembelajaran ini. **Untuk membuat direktori yang digunakan oleh tutorial di jalur pembelajaran ini:** 1. Jalankan perintah ini untuk membuat direktori yang diperlukan. ``` mkdir ~/dc-configs mkdir ~/policies mkdir ~/messages mkdir ~/certs/testconn mkdir ~/certs/pubsub mkdir ~/certs/jobs ``` 1. Jalankan perintah ini untuk mengatur izin pada direktori baru. ``` chmod 745 ~ chmod 700 ~/certs/testconn chmod 700 ~/certs/pubsub chmod 700 ~/certs/jobs ``` Setelah Anda membuat direktori ini dan menetapkan izin mereka, lanjutkan ke[(Opsional) Simpan gambar kartu microSD](#iot-dc-install-dc-save). ## (Opsional) Simpan gambar kartu microSD Pada titik ini, kartu microSD Raspberry Pi Anda memiliki OS yang diperbarui, perangkat lunak aplikasi dasar, dan Klien AWS IoT Perangkat. Jika Anda ingin kembali untuk mencoba latihan dan tutorial ini lagi, Anda dapat melewati prosedur sebelumnya dengan menulis gambar kartu microSD yang Anda simpan dengan prosedur ini ke kartu microSD baru dan melanjutkan tutorial dari. [Menyediakan Raspberry Pi Anda di AWS IoT](iot-dc-install-provision.md) **Untuk menyimpan gambar kartu microSD ke file:** Di jendela terminal di komputer host lokal Anda yang terhubung ke Raspberry Pi Anda: 1. Konfirmasikan bahwa Akun AWS kredensional Anda belum disimpan. 1. Jalankan aplikasi AWS konfigurasi dengan perintah ini: ``` aws configure ``` 1. Jika kredensil Anda telah disimpan (jika ditampilkan dalam prompt), masukkan **XYXYXYXYX** string saat diminta seperti yang ditunjukkan di sini. Biarkan **nama wilayah Default** **dan format output default** kosong. ``` AWS Access Key ID [****************YXYX]: XYXYXYXYX AWS Secret Access Key [****************YXYX]: XYXYXYXYX Default region name: Default output format: ``` 1. Masukkan perintah ini untuk mematikan Raspberry Pi. ``` sudo shutdown -h 0 ``` 1. Setelah Raspberry Pi mati sepenuhnya, lepaskan konektor dayanya. 1. Lepaskan kartu microSD dari perangkat Anda. 1. Di komputer host lokal Anda: 1. Masukkan kartu microSD. 1. Menggunakan alat pencitraan kartu SD Anda, simpan gambar kartu microSD ke file. 1. Setelah gambar kartu microSD disimpan, keluarkan kartu dari komputer host lokal. Anda dapat melanjutkan dengan kartu microSD ini. [Menyediakan Raspberry Pi Anda di AWS IoT](iot-dc-install-provision.md) # Menyediakan Raspberry Pi Anda di AWS IoT Prosedur di bagian ini dimulai dengan gambar microSD tersimpan yang memiliki dan AWS IoT Device Client diinstal AWS CLI dan membuat AWS IoT sumber daya dan sertifikat perangkat yang menyediakan Raspberry Pi Anda. AWS IoT ## Pasang kartu microSD di Raspberry Pi Anda Prosedur ini menginstal kartu microSD dengan perangkat lunak yang diperlukan dimuat dan dikonfigurasi ke dalam Raspberry Pi dan mengonfigurasi kartu Akun AWS Anda sehingga Anda dapat melanjutkan tutorial di jalur pembelajaran ini. Gunakan kartu microSD dari [(Opsional) Simpan gambar kartu microSD](iot-dc-install-download.md#iot-dc-install-dc-save) yang memiliki perangkat lunak yang diperlukan untuk latihan dan tutorial di jalur pembelajaran ini. **Untuk memasang kartu microSD di Raspberry Pi Anda** 1. Dengan daya terputus dari Raspberry Pi, masukkan kartu microSD ke Raspberry Pi. 1. Terapkan daya ke Raspberry Pi. 1. Setelah sekitar satu menit, di komputer host lokal, restart sesi jendela terminal dan masuk ke Raspberry Pi. 1. Di komputer host lokal Anda, di jendela terminal, dan dengan **ID Kunci Akses Akses dan kredenal Kunci** **Akses Rahasia** untuk Raspberry Pi Anda: 1. Jalankan aplikasi AWS konfigurasi dengan perintah ini: ``` aws configure ``` 1. Masukkan Akun AWS kredensi dan informasi konfigurasi Anda saat diminta: ``` AWS Access Key ID [****************YXYX]: your Access Key ID AWS Secret Access Key [****************YXYX]: your Secret Access Key Default region name [us-west-2]: your Wilayah AWS code Default output format [json]: json ``` Setelah Anda memulihkan Akun AWS kredensialnya, Anda siap untuk melanjutkan. [Menyediakan perangkat Anda di AWS IoT Core](#iot-dc-install-dc-provision) ## Menyediakan perangkat Anda di AWS IoT Core Prosedur di bagian ini membuat AWS IoT sumber daya yang menyediakan Raspberry Pi Anda AWS IoT. Saat Anda membuat sumber daya ini, Anda akan diminta untuk merekam berbagai informasi. Informasi ini digunakan oleh konfigurasi AWS IoT Device Client dalam prosedur berikutnya. Agar Raspberry Pi Anda berfungsi AWS IoT, itu harus disediakan. Penyediaan adalah proses membuat dan mengonfigurasi AWS IoT sumber daya yang diperlukan untuk mendukung Raspberry Pi Anda sebagai perangkat IoT. Dengan Raspberry Pi Anda dinyalakan dan dimulai ulang, sambungkan jendela terminal di komputer host lokal Anda ke Raspberry Pi dan selesaikan prosedur ini. **Topics** + [Membuat dan mengunduh file sertifikat perangkat](#iot-dc-install-dc-provision-certs) + [Buat AWS IoT sumber daya](#iot-dc-install-dc-provision-resources) ### Membuat dan mengunduh file sertifikat perangkat Prosedur ini membuat file sertifikat perangkat untuk demo ini. **Untuk membuat dan mengunduh file sertifikat perangkat untuk Raspberry Pi Anda** 1. Di jendela terminal di komputer host lokal Anda, masukkan perintah ini untuk membuat file sertifikat perangkat untuk perangkat Anda. ``` mkdir ~/certs/testconn aws iot create-keys-and-certificate \ --set-as-active \ --certificate-pem-outfile "~/certs/testconn/device.pem.crt" \ --public-key-outfile "~/certs/testconn/public.pem.key" \ --private-key-outfile "~/certs/testconn/private.pem.key" ``` Perintah mengembalikan respon seperti berikut ini. Catat `certificateArn` nilai untuk digunakan nanti. ``` { "certificateArn": "arn:aws:iot:us-west-2:57EXAMPLE833:cert/76e7e4edb3e52f52334be2f387a06145b2aa4c7fcd810f3aea2d92abc227d269", "certificateId": "76e7e4edb3e52f5233EXAMPLE7a06145b2aa4c7fcd810f3aea2d92abc227d269", "certificatePem": "-----BEGIN CERTIFICATE-----\nMIIDWTCCAkGgAwIBAgI_SHORTENED_FOR_EXAMPLE_Lgn4jfgtS\n-----END CERTIFICATE-----\n", "keyPair": { "PublicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BA_SHORTENED_FOR_EXAMPLE_ImwIDAQAB\n-----END PUBLIC KEY-----\n", "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIBAAKCAQE_SHORTENED_FOR_EXAMPLE_T9RoDiukY\n-----END RSA PRIVATE KEY-----\n" } } ``` 1. Masukkan perintah berikut untuk mengatur izin pada direktori sertifikat dan file-file-nya. ``` chmod 745 ~ chmod 700 ~/certs/testconn chmod 644 ~/certs/testconn/* chmod 600 ~/certs/testconn/private.pem.key ``` 1. Jalankan perintah ini untuk meninjau izin pada direktori dan file sertifikat Anda. ``` ls -l ~/certs/testconn ``` Output dari perintah harus sama dengan apa yang Anda lihat di sini, kecuali tanggal dan waktu file akan berbeda. ``` -rw-r--r-- 1 pi pi 1220 Oct 28 13:02 device.pem.crt -rw------- 1 pi pi 1675 Oct 28 13:02 private.pem.key -rw-r--r-- 1 pi pi 451 Oct 28 13:02 public.pem.key ``` Pada titik ini, Anda memiliki file sertifikat perangkat yang diinstal pada Raspberry Pi Anda dan Anda dapat melanjutkan[Buat AWS IoT sumber daya](#iot-dc-install-dc-provision-resources). ### Buat AWS IoT sumber daya Prosedur ini menyediakan perangkat Anda AWS IoT dengan membuat sumber daya yang dibutuhkan perangkat Anda untuk mengakses AWS IoT fitur dan layanan. **Untuk menyediakan perangkat Anda di AWS IoT** 1. Di jendela terminal di komputer host lokal Anda, masukkan perintah berikut untuk mendapatkan alamat titik akhir data perangkat untuk Anda Akun AWS. ``` aws iot describe-endpoint --endpoint-type IoT:Data-ATS ``` Perintah dari langkah sebelumnya mengembalikan respons seperti berikut ini. Catat `endpointAddress` nilai untuk digunakan nanti. ``` { "endpointAddress": "a3qjEXAMPLEffp-ats.iot.us-west-2.amazonaws.com" } ``` 1. Masukkan perintah ini untuk membuat sumber daya AWS IoT untuk Raspberry Pi Anda. ``` aws iot create-thing --thing-name "DevCliTestThing" ``` Jika AWS IoT sumber daya Anda dibuat, perintah mengembalikan respons seperti ini. ``` { "thingName": "DevCliTestThing", "thingArn": "arn:aws:iot:us-west-2:57EXAMPLE833:thing/DevCliTestThing", "thingId": "8ea78707-32c3-4f8a-9232-14bEXAMPLEfd" } ``` 1. Di jendela terminal: 1. Buka editor teks, seperti`nano`. 1. Salin dokumen kebijakan JSON ini dan tempelkan ke editor teks terbuka Anda. **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:Publish", "iot:Subscribe", "iot:Receive", "iot:Connect" ], "Resource": [ "*" ] } ] } ``` **catatan** Dokumen kebijakan ini dengan murah hati memberikan izin kepada setiap sumber daya untuk terhubung, menerima, menerbitkan, dan berlangganan. Biasanya kebijakan hanya memberikan izin kepada sumber daya tertentu untuk melakukan tindakan tertentu. Namun, untuk uji konektivitas perangkat awal, kebijakan yang terlalu umum dan permisif ini digunakan untuk meminimalkan kemungkinan masalah akses selama pengujian ini. Dalam tutorial berikutnya, dokumen kebijakan yang lebih sempit akan digunakan untuk menunjukkan praktik yang lebih baik dalam desain kebijakan. 1. Simpan file di editor teks Anda sebagai**\$1/policies/dev\$1cli\$1test\$1thing\$1policy.json**. 1. Jalankan perintah ini untuk menggunakan dokumen kebijakan dari langkah sebelumnya untuk membuat AWS IoT kebijakan. ``` aws iot create-policy \ --policy-name "DevCliTestThingPolicy" \ --policy-document "file://~/policies/dev_cli_test_thing_policy.json" ``` Jika kebijakan dibuat, perintah akan menampilkan respons seperti ini. ``` { "policyName": "DevCliTestThingPolicy", "policyArn": "arn:aws:iot:us-west-2:57EXAMPLE833:policy/DevCliTestThingPolicy", "policyDocument": "{\n \"Version\": \"2012-10-17\", \n \"Statement\": [\n {\n \"Effect\": \"Allow\",\n \"Action\": [\n \"iot:Publish\",\n \"iot:Subscribe\",\n \"iot:Receive\",\n \"iot:Connect\"\n ],\n \"Resource\": [\n \"*\"\n ]\n }\n ]\n}\n", "policyVersionId": "1" } ``` 1. Jalankan perintah ini untuk melampirkan kebijakan ke sertifikat perangkat. Ganti `certificateArn` dengan `certificateArn` nilai yang Anda simpan sebelumnya. ``` aws iot attach-policy \ --policy-name "DevCliTestThingPolicy" \ --target "certificateArn" ``` Jika berhasil, perintah ini tidak mengembalikan apa pun. 1. Jalankan perintah ini untuk melampirkan sertifikat perangkat ke sumber daya AWS IoT benda. Ganti `certificateArn` dengan `certificateArn` nilai yang Anda simpan sebelumnya. ``` aws iot attach-thing-principal \ --thing-name "DevCliTestThing" \ --principal "certificateArn" ``` Jika berhasil, perintah ini tidak mengembalikan apa pun. Setelah berhasil menyediakan perangkat AWS IoT, Anda siap untuk melanjutkan. [Konfigurasikan AWS IoT Device Client untuk menguji konektivitas](iot-dc-install-configure.md) # Konfigurasikan AWS IoT Device Client untuk menguji konektivitas Prosedur di bagian ini mengkonfigurasi AWS IoT Device Client untuk mempublikasikan pesan MQTT dari Raspberry Pi Anda. **Topics** + [Buat file konfigurasi](#iot-dc-install-dc-configure-step1) + [Buka klien uji MQTT](#iot-dc-install-dc-configure-step2) + [Jalankan Klien AWS IoT Perangkat](#iot-dc-install-dc-configure-step3) ## Buat file konfigurasi Prosedur ini membuat file konfigurasi untuk menguji AWS IoT Device Client. **Untuk membuat file konfigurasi untuk menguji AWS IoT Device Client** + Di jendela terminal di komputer host lokal Anda yang terhubung ke Raspberry Pi Anda: 1. Masukkan perintah ini untuk membuat direktori untuk file konfigurasi dan mengatur izin pada direktori: ``` mkdir ~/dc-configs chmod 745 ~/dc-configs ``` 1. Buka editor teks, seperti`nano`. 1. Salin dokumen JSON ini dan tempelkan ke editor teks terbuka Anda. ``` { "endpoint": "a3qEXAMPLEaffp-ats.iot.us-west-2.amazonaws.com", "cert": "~/certs/testconn/device.pem.crt", "key": "~/certs/testconn/private.pem.key", "root-ca": "~/certs/AmazonRootCA1.pem", "thing-name": "DevCliTestThing", "logging": { "enable-sdk-logging": true, "level": "DEBUG", "type": "STDOUT", "file": "" }, "jobs": { "enabled": false, "handler-directory": "" }, "tunneling": { "enabled": false }, "device-defender": { "enabled": false, "interval": 300 }, "fleet-provisioning": { "enabled": false, "template-name": "", "template-parameters": "", "csr-file": "", "device-key": "" }, "samples": { "pub-sub": { "enabled": true, "publish-topic": "test/dc/pubtopic", "publish-file": "", "subscribe-topic": "test/dc/subtopic", "subscribe-file": "" } }, "config-shadow": { "enabled": false }, "sample-shadow": { "enabled": false, "shadow-name": "", "shadow-input-file": "", "shadow-output-file": "" } } ``` 1. Ganti *endpoint* nilai dengan titik akhir data perangkat untuk Akun AWS yang Anda temukan. [Menyediakan perangkat Anda di AWS IoT Core](iot-dc-install-provision.md#iot-dc-install-dc-provision) 1. Simpan file di editor teks Anda sebagai**\$1/dc-configs/dc-testconn-config.json**. 1. Jalankan perintah ini untuk mengatur izin pada file konfigurasi baru. ``` chmod 644 ~/dc-configs/dc-testconn-config.json ``` Setelah Anda menyimpan file, Anda siap untuk melanjutkan[Buka klien uji MQTT](#iot-dc-install-dc-configure-step2). ## Buka klien uji MQTT Prosedur ini mempersiapkan **klien pengujian MQTT** di AWS IoT konsol untuk berlangganan pesan MQTT yang diterbitkan Klien Perangkat saat AWS IoT dijalankan. **Untuk mempersiapkan **klien uji MQTT** untuk berlangganan semua pesan MQTT** 1. Di komputer host lokal Anda, di [AWS IoT konsol](https://console.aws.amazon.com//iot/home#/test), pilih klien pengujian **MQTT**. 1. Di tab **Berlangganan topik**, di **Filter topik**, masukkan **\$1** (satu tanda pound), dan pilih **Berlangganan untuk berlangganan** setiap topik MQTT. 1. Di bawah label **Langganan**, konfirmasikan bahwa Anda melihat **\$1** (satu tanda pound). Biarkan jendela dengan **klien pengujian MQTT** terbuka saat Anda melanjutkan. [Jalankan Klien AWS IoT Perangkat](#iot-dc-install-dc-configure-step3) ## Jalankan Klien AWS IoT Perangkat Prosedur ini menjalankan AWS IoT Device Client sehingga menerbitkan pesan MQTT tunggal yang diterima dan ditampilkan oleh klien pengujian **MQTT**. **Untuk mengirim pesan MQTT dari Device Client AWS IoT** 1. Pastikan bahwa kedua jendela terminal yang terhubung ke Raspberry Pi Anda dan jendela dengan **klien pengujian MQTT** terlihat saat Anda melakukan prosedur ini. 1. Di jendela terminal, masukkan perintah ini untuk menjalankan AWS IoT Device Client menggunakan file konfigurasi yang dibuat di[Buat file konfigurasi](#iot-dc-install-dc-configure-step1). ``` cd ~/aws-iot-device-client/build ./aws-iot-device-client --config-file ~/dc-configs/dc-testconn-config.json ``` Di jendela terminal, Klien AWS IoT Perangkat menampilkan pesan informasi dan kesalahan apa pun yang terjadi saat dijalankan. Jika tidak ada kesalahan yang ditampilkan di jendela terminal, tinjau klien **pengujian MQTT**. 1. *Di **klien pengujian MQTT**, di jendela Langganan, lihat Hello World\$1* pesan dikirim ke topik `test/dc/pubtopic` pesan. 1. Jika Klien AWS IoT Perangkat tidak menampilkan kesalahan dan Anda melihat *Hello World\$1* dikirim ke `test/dc/pubtopic` pesan di **klien pengujian MQTT**, Anda telah menunjukkan koneksi yang berhasil. 1. Di jendela terminal, masukkan **^C** (Ctrl-C) untuk menghentikan Device Client. AWS IoT Setelah Anda menunjukkan bahwa AWS IoT Device Client berjalan dengan benar pada Raspberry Pi Anda dan dapat berkomunikasi dengan AWS IoT, Anda dapat melanjutkan ke file[Tutorial: Menunjukkan komunikasi pesan MQTT dengan Device Client AWS IoT](iot-dc-testconn.md).