IoT Platform：Mendistribusikan Perangkat

Skenario

Berikut adalah skenario di mana Anda dapat mendistribusikan perangkat:

• Pembakaran perangkat sebelum koneksi: Sebelum mengirimkan perangkat dari pabrik, Anda tidak perlu menulis kode keras titik akhir yang berbeda berdasarkan instance IoT Platform atau wilayahnya. Titik akhir unik global yang tidak mengandung informasi wilayah dibakar ke setiap perangkat. Setelah perangkat meninggalkan pabrik, Anda dapat mendistribusikannya ke berbagai wilayah melalui konsol IoT Platform. Dengan cara ini, perangkat dapat terhubung ke IoT Platform dari berbagai wilayah di seluruh dunia.

• Migrasi bisnis: Jika Anda bermigrasi bisnis, Anda mungkin perlu mengubah wilayah atau instance tempat perangkat terhubung. Dalam hal ini, Anda dapat mendistribusikan perangkat lintas wilayah, instance, atau akun.

Kebijakan distribusi berikut berlaku untuk skenario yang berbeda:

• Wilayah tertentu: Perangkat didistribusikan ke wilayah dan instance yang ditentukan. Jika Anda mengetahui wilayah tujuan dan instance tempat perangkat perlu didistribusikan, kami sarankan menggunakan kebijakan ini agar distribusi lebih efisien.

• Akses terdekat: Perangkat mungkin digunakan di berbagai wilayah di seluruh dunia. Saat mendistribusikan perangkat, Anda dapat memilih satu atau lebih wilayah dan memilih instance dari setiap wilayah. Kemudian, perangkat terhubung ke wilayah terdekat berdasarkan alamat IP mereka. Dengan cara ini, perangkat dapat terhubung ke wilayah terdekat tanpa memandang lokasi fisiknya.

Catatan Penggunaan

Item yang dapat didistribusikan

Anda dapat mendistribusikan perangkat lintas instance, wilayah, atau akun.

Setelah perangkat didistribusikan, data perangkat dan data produk tertentu juga ikut didistribusikan. Tabel berikut menjelaskan item yang dapat didistribusikan.

Tindakan Pencegahan

Prosedur

1. Buat produk dan perangkat di produk lalu dapatkan sertifikat perangkat di konsol IoT Platform. Sertifikat mencakup ProductKey, DeviceName, dan DeviceSecret. Untuk informasi lebih lanjut, lihat Buat produk, Buat perangkat, dan Buat beberapa perangkat sekaligus.

2. Gunakan Link SDK for C V4.x untuk mengonfigurasi perangkat fisik, atau konfigurasikan perangkat berdasarkan protokol komunikasi untuk mengimplementasikan fitur berikut.

   null

   Untuk mengonfigurasi perangkat, kami sarankan menggunakan Link SDK for C. Untuk informasi lebih lanjut, lihat Ikhtisar distribusi perangkat.

   Setelah mendistribusikan perangkat di konsol IoT Platform, Anda dapat menghubungkan perangkat ke IoT Platform dengan melakukan operasi berikut:

   1. Gunakan salah satu metode berikut untuk memulai permintaan Bootstrap berdasarkan metode pengembangan perangkat:

      • Hubungkan perangkat menggunakan Link SDK for C

        Perangkat memanggil metode Bootstrap yang dienkapsulasi dalam SDK dan membawa parameter ProductKey dan DeviceName untuk mengirim permintaan ke titik akhir unik global https://iot-auth-global.aliyuncs.com.

        Untuk informasi tentang cara mengembangkan fitur Bootstrap, lihat Ikhtisar distribusi perangkat.

      • Hubungkan perangkat tanpa menggunakan SDK

        Kirim permintaan ke https://iot-auth-global.aliyuncs.com/auth/bootstrap berdasarkan protokol yang Anda gunakan. Tabel berikut menjelaskan parameter permintaan.

        Tabel 1 Parameter permintaan

        Parameter	Wajib	Deskripsi
        productKey	Wajib	ProductKey dari produk tempat perangkat dimiliki. Anda dapat melihat ProductKey di konsol IoT Platform. Untuk informasi tentang cara memperoleh ProductKey, lihat Buat perangkat.
        deviceName	Wajib	DeviceName dari perangkat. Anda dapat melihat DeviceName di konsol IoT Platform.
        clientId	Opsional	ID klien. ID harus memiliki panjang 1 hingga 64 karakter.
        version	Opsional	Nomor versi layanan verifikasi.
        timestamp	Opsional	Timestamp. Timestamp tidak diverifikasi menggunakan algoritma jendela geser.
        resources	Opsional	Nama sumber daya yang ingin Anda peroleh. Contoh: MQTT. Pisahkan beberapa nama sumber daya dengan koma (,).

        Tabel 2 Parameter respons

        Parameter	Tipe	Deskripsi
        resources	Struct	Informasi sumber daya, seperti titik akhir broker Message Queuing Telemetry Transport (MQTT).

        Contoh permintaan

        POST /auth/bootstrap HTTP/1.1
        Host: iot-auth-global.aliyuncs.com
        Content-Type: application/x-www-form-urlencoded
        Content-Length: 123
        productKey=123&timestamp=123&version=default&clientId=123&resources=mqtt&deviceName=test

        Contoh respons

        HTTP/1.1 200 OK
        Server: Tengine
        Date: Wed, 29 Mar 2017 13:08:36 GMT
        Content-Type: application/json;charset=utf-8
        Connection: close
        {
          "code" : 200,
          "data" : {
            "resources" : {
              "mqtt" : {
                "host" : "xxx.iot-as-mqtt.cn-shanghai.aliyuncs.com",
                "port" : 1883
              }
            }
          },
          "message" : "success"
        }

   2. IoT Platform mengembalikan titik akhir berdasarkan wilayah dan instance tujuan. Jika Anda mengatur parameter Kebijakan Distribusi ke Akses Terdekat, IoT Platform menentukan wilayah dan instance tujuan berdasarkan alamat IP perangkat.

   3. Perangkat terhubung ke IoT Platform melalui MQTT berdasarkan sertifikat perangkat dan informasi titik akhir instance tempat perangkat dapat terhubung. Sertifikat perangkat mencakup ProductKey, DeviceName, dan DeviceSecret. Informasi titik akhir dikembalikan oleh layanan distribusi.

      • Hubungkan perangkat menggunakan Link SDK for C

        Untuk menghubungkan perangkat, kami sarankan menggunakan SDK V4.x. Untuk informasi lebih lanjut tentang cara menghubungkan perangkat ke IoT Platform, lihat Ikhtisar koneksi perangkat melalui MQTT.

      • Hubungkan perangkat tanpa menggunakan SDK

        Gunakan proyek Paho MQTT open source untuk embedded C untuk menghubungkan perangkat ke IoT Platform. Untuk informasi lebih lanjut, lihat Gunakan library Paho MQTT untuk embedded C untuk menghubungkan perangkat ke IoT Platform.

   4. Opsional. Jika Anda mendistribusikan perangkat di konsol IoT Platform, perangkat menerima pesan MQTT yang menunjukkan bahwa operasi distribusi dilakukan. Lalu, perangkat dipaksa offline.

      Topik berikut digunakan saat IoT Platform mengirim permintaan MQTT downstream dan perangkat mengirim respons ke IoT Platform:

      Topik permintaan: /sys/${productKey}/${deviceName}/thing/bootstrap/notify

      Contoh permintaan dalam format JSON Alink:

      {
          "id": "****",
          "version": "1.0", 
          "method": "thing.bootstrap.notify", 
          "params": {
            "cmd": 0
          }
      }

      Topik respons: /sys/${productKey}/${deviceName}/thing/bootstrap/notify_reply

      Contoh respons dalam format JSON Alink:

      {
          "id": "****",
          "code":200,
          "data" : {}
      }

   null

   Setiap kali Anda menghubungkan perangkat ke IoT Platform, kami sarankan menyelesaikan tiga tahap pertama dari proses sebelumnya. Ini memastikan bahwa titik akhir yang disimpan di perangkat sama dengan titik akhir yang dikirim oleh IoT Platform. Jika tidak, perangkat mungkin gagal terhubung ke IoT Platform.

   Informasi titik akhir dapat disimpan di perangkat. Jika informasi koneksi hilang atau upaya koneksi gagal, perangkat dapat memulai permintaan Bootstrap untuk memperoleh informasi titik akhir lagi.

3. Setelah mengonfigurasi perangkat, lakukan salah satu operasi berikut berdasarkan kondisi aktual:

   • Sebelum mendistribusikan perangkat yang ada tempat fitur distribusi perangkat dinonaktifkan, Anda harus melakukan pembaruan OTA untuk memperbarui perangkat ke versi yang dikembangkan pada langkah sebelumnya. Untuk informasi tentang cara memperbarui perangkat, lihat Ikhtisar Pembaruan OTA.

     null

     Jika fitur distribusi perangkat perangkat yang ada dinonaktifkan, Anda harus melakukan pembaruan OTA untuk mengaktifkan fitur tersebut sebelum mendistribusikan perangkat. Jika tidak, perangkat tidak dapat terhubung ke IoT Platform setelah didistribusikan.

   • Setelah membuat perangkat, Anda harus membakar sertifikat perangkat ke perangkat. Untuk informasi tentang cara membakar sertifikat perangkat, lihat Ikhtisar memperoleh sertifikat perangkat.

4. Distribusikan perangkat ke wilayah, instance, dan akun tertentu di konsol IoT Platform berdasarkan kebutuhan bisnis Anda.

   1. Masuk ke konsol IoT Platform.

   2. Di bilah navigasi atas, pilih China (Shanghai) dari daftar drop-down.

      null

      Langkah ini dilakukan untuk menggunakan fitur distribusi perangkat. Ini tidak menentukan wilayah sumber atau tujuan untuk distribusi perangkat.

   3. Di halaman Overview, klik All environment. Di tab Semua Lingkungan, temukan instance yang ingin Anda kelola dan klik ID instance atau nama instance.

   4. Di panel navigasi sisi kiri, pilih Resource Allocation > Device Distribution.

   5. Di halaman Device Distribution, klik Device Distribution.

   6. Konfigurasikan parameter.

      Tabel berikut menjelaskan parameter.

      Parameter	Deskripsi
      Metode Distribusi	Metode yang digunakan untuk mendistribusikan perangkat. Nilai valid: This Account: Mendistribusikan perangkat ke instance atau wilayah lain dari akun saat ini. Cross-account: Mendistribusikan perangkat ke akun lain. null Jika Anda mengatur parameter Metode Distribusi ke Lintas Akun, Anda tidak dapat mengatur parameter Kebijakan Distribusi ke Akses Terdekat.
      Akun Tujuan	Akun tujuan tempat perangkat didistribusikan. Jika Anda mengatur parameter Metode Distribusi ke Cross-account, parameter ini diperlukan. Anda dapat menentukan akun tujuan dengan menggunakan nama akun atau ID akun. Destination Account Name: Masukkan nama akun Alibaba Cloud. Destination Account ID: Masukkan ID akun Alibaba Cloud. null Untuk melihat ID akun Alibaba Cloud, lakukan langkah-langkah berikut: Masuk ke konsol IoT Platform dan klik foto profil di sudut kanan atas untuk masuk ke halaman Security Settings.
      Kode Verifikasi	Setelah Anda menentukan akun tujuan, klik Send Verification Code. IoT Platform mengirim kode verifikasi ke nomor telepon yang terkait dengan akun. Kode verifikasi berlaku selama 5 menit. Hubungi pemilik akun tujuan untuk memperoleh kode verifikasi.
      Wilayah Sumber	Wilayah tempat perangkat didistribusikan.
      Instance Sumber	Instance tempat perangkat didistribusikan.
      Kebijakan Distribusi	Kebijakan yang digunakan untuk mendistribusikan perangkat. Nilai valid: Update Region: Mendistribusikan perangkat ke wilayah tertentu. Nearest Access: Mendistribusikan perangkat ke wilayah terdekat berdasarkan alamat IP perangkat. Anda dapat memilih satu atau lebih wilayah.
      Wilayah Tujuan	Jika Anda mengatur parameter Kebijakan Distribusi ke Update Region, parameter ini diperlukan. Pilih wilayah tempat Anda ingin mendistribusikan perangkat.
      Instance Tujuan	Jika Anda mengatur parameter Kebijakan Distribusi ke Update Region, parameter ini diperlukan. Instance tempat Anda ingin mendistribusikan perangkat. Jika Anda mengatur parameter Metode Distribusi ke This Account, Anda harus memilih instance tujuan. Jika Anda mengatur parameter Metode Distribusi ke Cross-account, Anda harus menentukan ID instance. Jika tidak, instance publik versi sebelumnya akan digunakan. null Jika instance tujuan adalah instance publik baru atau instance Enterprise Edition, Anda harus menentukan ID instance. Untuk informasi lebih lanjut, lihat Kelola titik akhir sebuah instance.
      Wilayah	Jika Anda mengatur parameter Kebijakan Distribusi ke Nearest Access, parameter ini diperlukan. Anda dapat memilih satu atau lebih wilayah. Jika Anda ingin mendistribusikan perangkat ke wilayah sumber, pilih wilayah sumber. Jika beberapa instance berada di wilayah tujuan, Anda dapat memilih instance dari daftar drop-down.
      Perangkat	Anda dapat memilih perangkat dengan menggunakan salah satu metode berikut: Select: Pilih produk dari daftar produk dan kemudian pilih satu atau lebih perangkat dari daftar perangkat. Perangkat tetap dipilih meskipun Anda mengubah halaman daftar perangkat. Jika Anda mengatur parameter Metode Distribusi ke Update Region dan tidak menentukan perangkat, IoT Platform hanya mendistribusikan produk. Choose File: Unggah file yang berisi daftar perangkat. File harus dalam format CSV dan dapat berisi hingga 1.000 entri. Anda dapat mengklik Download Template untuk memperoleh template file.

   7. Klik OK.

   IoT Platform segera menjalankan tugas distribusi.

   • Jika Anda mengatur parameter Kebijakan Distribusi ke Perbarui Wilayah, data produk dan data perangkat didistribusikan ke wilayah tertentu.

   • Jika Anda mengatur parameter Kebijakan Distribusi ke Akses Terdekat, data produk didistribusikan ke wilayah yang ditentukan. Saat perangkat terhubung ke IoT Platform, IoT Platform secara dinamis mendistribusikan data perangkat ke wilayah terdekat berdasarkan alamat IP perangkat.

   Tabel berikut menjelaskan status berbeda dari tugas distribusi. Status ditampilkan di tab Daftar Batch.

   Status	Deskripsi
   Menginisialisasi	Tugas distribusi sedang diinisialisasi.
   Mendistribusikan	Tugas distribusi sedang dieksekusi. Jika tugas distribusi berada dalam keadaan ini untuk waktu yang lama, Anda dapat mengklik Coba Lagi di kolom Tindakan.
   Didistribusikan	Tugas distribusi selesai. Status didistribusikan ini tidak menunjukkan bahwa semua perangkat telah didistribusikan. Untuk memeriksa apakah semua perangkat telah didistribusikan, klik Download Record di kolom Tindakan dan lihat hasilnya. Jika perangkat tertentu tidak ada, perangkat gagal didistribusikan.
   Gagal	Tugas distribusi gagal karena jitter jaringan. Anda dapat mengklik Coba Lagi di kolom Tindakan. Jika masalah berlanjut, hubungi layanan pelanggan atau ajukan tiket.

   Setelah tugas distribusi selesai dan perangkat terhubung ke IoT Platform, perangkat terhubung ke wilayah dan instance tujuan dengan melakukan operasi pada Langkah 2.