Tutorial: Mentransformasi data dengan Azure Stack Edge Pro untuk alur penyebaran lanjutan

Artikel
02/27/2024

Penting

Perangkat FPGA Azure Stack Edge Pro akan mencapai akhir masa aktif pada bulan Februari 2024. Jika Anda mempertimbangkan penyebaran baru, kami sarankan Anda menjelajahi perangkat Azure Stack Edge Pro 2 atau Azure Stack Edge Pro GPU untuk beban kerja Anda.

Tutorial ini menjelaskan cara mengonfigurasi peran komputasi untuk alur penyebaran lanjutan di perangkat Azure Stack Edge Pro FPGA Anda. Setelah mengonfigurasi peran komputasi, Azure Stack Edge Pro FPGA dapat mentransformasi data sebelum mengirimkannya ke Azure.

Komputasi dapat dikonfigurasi untuk aliran penyebaran sederhana atau tingkat lanjut di perangkat Anda.

Kriteria	Penyebaran sederhana	Penyebaran tingkat lanjut
Ditujukan untuk	Administrator IT	Pengembang
Jenis	Menggunakan layanan Azure Stack Edge untuk menyebarkan modul	Menggunakan layanan IoT Hub untuk menyebarkan modul
Modul yang disebarkan	Tunggal	Modul berantai atau beberapa modul

Diperlukan waktu sekitar 20 hingga 30 menit untuk menyelesaikan prosedur ini.

Dalam tutorial ini, Anda akan mempelajari cara:

Mengonfigurasi komputasi
Menambahkan pembagian
Menambahkan pemicu
Menambahkan modul komputasi
Memverifikasi transformasi dan transfer data

Prasyarat

Sebelum Anda menyiapkan peran komputasi di perangkat Azure Stack Edge Pro FPGA, pastikan bahwa:

Anda sudah mengaktifkan perangkat Azure Stack Edge Pro FPGA Anda seperti yang dijelaskan di Menyambungkan, menyiapkan, dan mengaktifkan Azure Stack Edge Pro FPGA.

Mengonfigurasi komputasi

Untuk mengonfigurasi komputasi di Azure Stack Edge Pro FPGA, Anda akan membuat sumber daya IoT Hub.

Di portal Microsoft Azure sumber daya Azure Stack Edge Anda, buka Gambaran Umum. Di panel kanan, pilih ubin IoT Edge.
Di ubin Aktifkan layanan IoT Edge, pilih Tambahkan. Tindakan ini mengaktifkan layanan IoT Edge yang memungkinkan Anda menyebarkan modul IoT Edge secara lokal di perangkat Anda.

Pada Buat layanan IoT Edge, masukkan yang berikut:

Bidang	Nilai
Langganan	Pilih langganan untuk sumber daya Azure IoT Hub Anda. Anda dapat memilih langganan yang sama seperti yang digunakan oleh sumber daya Azure Stack Edge.
Grup sumber daya	Masukkan nama untuk grup sumber daya untuk sumber daya Azure IoT Hub Anda. Anda dapat memilih grup sumber daya yang sama seperti yang digunakan oleh sumber daya Azure Stack Edge.
IoT Hub	Pilih dari Baru atau Yang Sudah Ada. Secara default, tingkat Standar (S1) digunakan untuk membuat sumber daya IoT. Untuk menggunakan sumber daya IoT tingkat gratis, buat sumber daya, lalu pilih sumber daya yang ada.
Nama	Terima default atau masukkan nama untuk sumber daya Azure IoT Hub Anda.

Get started with compute 3

Pilih Tinjau + Buat. Pembuatan sumber daya Azure IoT Hub membutuhkan waktu beberapa menit. Setelah sumber daya Azure IoT Hub dibuat, Gambaran umum diperbarui untuk memperlihatkan bahwa layanan IoT Edge sedang berjalan.

Ketika layanan IoT Edge dikonfigurasi di perangkat Edge, dua perangkat dibuat: perangkat IoT dan perangkat IoT Edge. Kedua perangkat dapat dilihat di sumber daya Azure IoT Hub. Runtime IoT Edge juga berjalan di perangkat IoT Edge ini. Pada titik ini, hanya platform Linux yang tersedia untuk perangkat IoT Edge Anda.

Untuk mengonfirmasi bahwa peran komputasi Edge telah dikonfigurasi, pilih Properti layanan > IoT Edge dan lihat perangkat IoT dan perangkat IoT Edge.

Menambahkan pembagian

Untuk penyebaran tingkat lanjut dalam tutorial ini, Anda akan memerlukan dua berbagi: satu berbagi Azure Stack Edge dan satu berbagi lokal Azure Stack Edge lainnya.

Tambahkan berbagi Azure Stack Edge di perangkat dengan melakukan langkah berikut:
1. Di sumber daya Azure Stack Edge Anda, buka IoT Edge > Shares.
2. Pada halaman Berbagi, dari bilah perintah, pilih + Tambahkan berbagi.
3. Di bilah Tambahkan berbagi, beri nama berbagi dan pilih jenis berbagi.
4. Untuk memasang pembagian Azure Stack Edge, pilih kotak centang untuk Menggunakan pembagian dengan komputasi Azure Stack Edge.
5. Pilih Akun penyimpanan, Layanan penyimpanan, pengguna yang sudah ada, lalu pilih Buat.
Setelah berbagi Azure Stack Edge dibuat, Anda akan menerima pemberitahuan pembuatan yang berhasil. Daftar berbagi diperbarui untuk mencerminkan berbagi baru.
Tambahkan berbagi lokal Azure Stack Edge di perangkat Azure Stack Edge dengan mengulangi semua langkah di langkah sebelumnya dan memilih kotak centang untuk Konfigurasikan sebagai berbagi lokal Azure Stack Edge. Data di pembagian lokal tetap ada di perangkat.
Pada bilah Berbagi, Anda akan melihat daftar berbagi yang diperbarui.
Untuk menampilkan properti berbagi lokal yang baru dibuat, pilih berbagi dari daftar. Di kotak Titik pemasangan lokal untuk modul komputasi Azure Stack Edge, salin nilai yang terkait dengan berbagi ini.

Anda akan menggunakan titik pemasangan lokal ini saat menyebarkan modul.
Untuk melihat properti berbagi Azure Stack Edge yang Anda buat, pilih berbagi dari daftar. Di kotak Titik pemasangan lokal untuk modul komputasi Azure Stack Edge, salin nilai yang terkait dengan berbagi ini.

Anda akan menggunakan titik pemasangan lokal ini saat menyebarkan modul.

Menambahkan pemicu

Buka sumber daya Azure Stack Edge Anda lalu buka Pemicu IoT Edge>. Pilih + Tambahkan pemicu.

Di bilah Tambahkan modul, masukkan nilai berikut.

Bidang	Nilai
Nama pemicu	Nama unik untuk pemicu Anda.
Jenis pemicu	Pilih Pemicu file. Pemicu file akan diterapkan tiap kali kejadian file terjadi seperti file ditulis ke berbagi input. Pemicu terjadwal aktif di sisi lain, diterapkan berdasarkan jadwal yang Anda tentukan. Untuk contoh ini, kita memerlukan pemicu file.
Pembagian input	Pilih pembagian input. Dalam hal ini, pembagian lokal Azure Stack Edge adalah pembagian input. Modul yang digunakan di sini memindahkan file dari berbagi lokal Azure Stack Edge ke berbagi Azure Stack Edge tempat file diunggah ke cloud.

Add trigger 2

Anda diberi tahu setelah pemicu dibuat. Daftar pemicu diperbarui untuk menampilkan pemicu yang baru dibuat. Pilih pemicu yang baru saja Anda buat.
Salin dan simpan rute sampel. Anda akan memodifikasi rute sampel ini dan menggunakannya nanti di Azure IoT Hub.

"sampleroute": "FROM /* WHERE topic = 'mydbesmbedgelocalshare1' INTO BrokeredEndpoint(\"/modules/modulename/inputs/input1\")"

Menambahkan modul

Tidak ada modul kustom pada perangkat Edge ini. Anda dapat menambahkan modul kustom atau bawaan. Untuk mempelajari cara membuat modul kustom, lihat Mengembangkan modul C# untuk perangkat Azure Stack Edge Pro FPGA Anda.

Di bagian ini, Anda akan menambahkan modul kustom ke perangkat IoT Edge yang telah Anda buat di Mengembangkan modul C# untuk Azure Stack Edge Pro FPGA. Modul kustom ini mengambil file dari pembagian lokal Azure Stack Edge di perangkat Azure Stack Edge dan memindahkannya ke pembagian (cloud) Azure Stack Edge di perangkat. Pembagian cloud lalu memindahkan file tersebut ke akun penyimpanan Azure yang terhubung dengan pembagian cloud.

Buka sumber daya Azure Stack Edge Anda lalu buka Gambaran Umum IoT Edge>. Pada ubin Modul, pilih Buka Azure IoT Hub.

Di sumber daya IoT Hub Anda, buka perangkat IoT Edge, lalu pilih perangkat IoT Edge Anda.
Pada Detail perangkat, pilih Atur Modul.

Di bawah Tambahkan Modul, lakukan hal berikut:

Masukkan nama, alamat, nama pengguna, dan kata sandi untuk pengaturan registri kontainer untuk modul kustom. Nama, alamat, dan kredensial yang terdaftar digunakan untuk mengambil modul dengan URL yang cocok. Untuk menyebarkan modul ini, di bawah Modul penyebaran, pilih Modul IoT Edge. Modul IoT Edge ini adalah kontainer docker yang dapat disebarkan ke perangkat IoT Edge yang terhubung dengan perangkat Azure Stack Edge Pro FPGA Anda.

Tentukan pengaturan untuk modul kustom IoT Edge. Masukkan nilai berikut.

Bidang	Nilai
Nama	Nama unik untuk modul tersebut. Modul ini adalah kontainer docker yang dapat disebarkan ke perangkat IoT Edge yang terhubung dengan Azure Stack Edge Pro FPGA Anda.
URI gambar	URI gambar untuk gambar kontainer yang sesuai untuk modul tersebut.
Info masuk diperlukan	Jika dicentang, nama pengguna dan kata sandi akan digunakan untuk mengambil modul dengan URL yang cocok.

Dalam kotak Opsi Pembuatan Kontainer, masukkan titik pemasangan lokal untuk modul Edge yang Anda salin di langkah-langkah sebelumnya untuk berbagi Azure Stack Edge dan berbagi lokal Edge.

Penting

Jalur yang digunakan di sini dipasang ke dalam kontainer Anda, sehingga harus sesuai dengan apa yang diharapkan fungsionalitas dalam kontainer Anda. Jika Anda mengikuti modul Buat kustom, kode yang ditentukan dalam modul tersebut mengharapkan jalur yang disalin. Jangan ubah jalur ini.

Dalam kotak Opsi Pembuatan Kontainer, Anda bisa menempelkan sampel berikut ini:

{
  "HostConfig": 
  {
   "Binds": 
    [
     "/home/hcsshares/mydbesmbedgelocalshare1:/home/input",
     "/home/hcsshares/mydbesmbedgeshare1:/home/output"
    ]
   }
}

Berikan variabel lingkungan apa pun yang digunakan untuk modul Anda. Variabel lingkungan menyediakan informasi opsional yang membantu menentukan lingkungan tempat modul Anda berjalan.

The Container Create Options box

Jika perlu, konfigurasikan pengaturan runtime Azure Stack Edge tingkat lanjut, lalu klik Berikutnya.

Di bawah Tentukan Rute, atur rute di antara modul.

Anda dapat mengganti rute dengan string rute berikut yang Anda salin sebelumnya. Dalam contoh ini, masukkan nama berbagi lokal yang akan mendorong data ke berbagi awan. Ganti modulename dengan nama modul. Pilih Selanjutnya.
```
"route": "FROM /* WHERE topic = 'mydbesmbedgelocalshare1' INTO BrokeredEndpoint(\"/modules/filemove/inputs/input1\")"
```
Di bawah Tinjau penyebaran, tinjau semua pengaturan, lalu pilih Kirim untuk mengirimkan modul untuk penyebaran.

Tindakan ini memulai penyebaran modul. Setelah penyebaran selesai, status Runtime modul berjalan.

Memverifikasi transformasi, transfer data

Langkah terakhir adalah memastikan bahwa modul terhubung dan berjalan seperti yang diharapkan. Status run-time dari modul akan berjalan untuk perangkat IoT Edge Anda di sumber daya IoT Hub.

Ikuti langkah-langkah berikut untuk memverifikasi transformasi dan transfer data ke Azure.

Di File Explorer, sambungkan ke lokal Azure Stack Edge dan berbagi Azure Stack Edge yang Anda buat sebelumnya.
Tambahkan data ke pembagian lokal.

Data akan dipindahkan ke berbagi cloud.

Selanjutnya, data akan dipindahkan dari pembagian cloud ke akun penyimpanan. Untuk melihat data, buka akun penyimpanan Anda, lalu pilih Penjelajah Penyimpanan. Anda dapat melihat data yang diunggah di akun penyimpanan Anda.