Azure Blob Storage

Objektif​

Sediakan sanitasi fail automatik dalam Azure Blob Storage menggunakan Glasswall Halo API melalui fungsi event grid dan baris gilir service bus.

Panduan Integrasi Azure Blob Storage​

• Prasyarat
• Langkah 1 - Cipta ruang nama service bus
• Langkah 2 - Cipta baris gilir service bus
• Langkah 3 - Sediakan peristiwa akaun storan blob sumber
• Langkah 4 - Cipta function app
• Langkah 5 - Cipta function

Prasyarat​

• Akaun Azure Portal
• Akaun Azure Blob Storage sumber
• Akaun Azure Blob Storage destinasi
• Kod contoh Glasswall

Nota:

• Pastikan semua parameter konfigurasi dinamakan dengan betul dan ditambahkan pada Azure Function App. Sebarang ketidakpadanan akan menyebabkan kegagalan.
• Kami hanya menyediakan kod contoh untuk menunjukkan kes penggunaan ini. Ia hanya mengendalikan fail rata dan tidak mempunyai mekanisme pengelogan yang canggih.

Langkah 1 - Cipta ruang nama Service Bus​

Pertama, anda perlu mencipta ruang nama Service Bus dan satu baris gilir supaya anda boleh menerima mesej event grid.

Nota: tier dan tetapan adalah berkaitan dengan beban anda atau IT.

1. Daftar masuk ke Azure Portal.

2. Navigasi ke All services > Integration > Service Bus.

3. Dalam tab Basics pada halaman Create namespace, cipta satu Namespace.

Nota: kod contoh yang disediakan akan berfungsi dengan semua tier, jadi pilih tetapan yang sesuai untuk penggunaan anda, dan masukkan semua konfigurasi wajib.

Untuk maklumat yang lebih terperinci tentang mencipta ruang nama dan baris gilir Service Bus, sila rujuk dokumentasi Azure.

Langkah 2 - Cipta baris gilir Service Bus​

Setelah ruang nama dicipta, kita perlu mencipta satu baris gilir untuk menghantar peristiwa kepadanya.

1. Pada halaman Service Bus namespace, pilih Queues dalam menu navigasi di sebelah kiri.

2. Pada halaman Queues, pilih + queue pada bar alat.

Nota: seperti namespace, tetapan bergantung pada keutamaan – untuk sampel ini kami hanya menggunakan nilai lalai.

3. Masukkan nama untuk queue, dan biarkan nilai lain pada tetapan lalainya.

Nama yang anda pilih tidak penting kerana kod sampel membenarkan ia dikonfigurasikan kepada apa sahaja yang ditetapkan.

4. Pilih Create.

Untuk maklumat yang lebih terperinci tentang mencipta ruang nama dan baris gilir Service Bus, sila rujuk dokumentasi Azure.

Langkah 3 - Sediakan peristiwa akaun Blob Storage sumber​

Selepas mencipta namespace dan queue Service Bus, konfigurasikan akaun Blob Storage sumber untuk mengeluarkan peristiwa sebagai mesej ke queue.

Walaupun peristiwa ini boleh dikonfigurasikan untuk mencetuskan Azure Function secara langsung, setiap peristiwa mesti diakui dalam masa 30 saat. Walaupun kebanyakan fail diproses dengan cepat, fail yang lebih besar atau tempoh beban tinggi boleh melebihi tempoh ini.

Untuk mengelakkan had ini, kami mengesyorkan mengkonfigurasikan Event Grid untuk menghantar peristiwa ke queue Service Bus dan membenarkan Azure Function menggunakan mesej daripada queue. Pendekatan ini memberikan daya tahan dan fleksibiliti yang lebih tinggi dengan mengasingkan pengambilan peristiwa daripada pemprosesan.

1. Untuk menyediakan peristiwa, pergi ke akaun storan sumber dan pilih Events > More options > Service Bus queue.

2. Masukkan Name di bawah butiran langganan peristiwa.

3. Masukkan System topic name di bawah butiran topik.

4. Daripada menu lungsur Filter to event type, pilih Blob created.

Ini bermakna akan ada mesej bagi setiap fail baharu dalam Blob Storage merentas akaun storan tersebut.

5. Akhir sekali, pilih queue yang anda cipta dalam langkah sebelumnya di bawah butiran endpoint.

Mesej Service Bus baharu kini diletakkan dalam queue bagi setiap fail yang dimuat naik ke akaun storan tersebut, yang akan digunakan melalui function yang akan kami cipta seterusnya.

Langkah 4 - Cipta Function App​

Anda mesti mempunyai Function App untuk mengehos pelaksanaan fungsi anda. Fungsi Azure yang menggunakan mesej Service Bus yang baru anda cipta akan dapat menggunakan butiran event grid untuk mengenal pasti fail baharu.

Glasswall mempunyai contoh yang berfungsi dalam C# yang melaksanakan perkara berikut:

• Mengenal pasti fail baharu.
• Mengakses fail.
• Menghantarnya dalam permintaan kepada Synchronous API Glasswall Halo.
• Mencipta (jika ia belum wujud) container dengan nama yang sama dalam akaun storan destinasi.
• Menulis sama ada fail yang dijana semula (dengan nama yang sama seperti asal) atau fail teks jika ia tidak dapat dijana semula.

1. Untuk mencipta Function App, pergi ke halaman Create a resource.

2. Dalam halaman New, pilih Compute > Function app.

3. Tetapan di bawah akan berfungsi untuk fungsi contoh Glasswall. Anda harus melaraskan tetapan ini agar sesuai dengan kod fungsi dan pilihan pengehosan yang anda inginkan:

Untuk maklumat yang lebih terperinci tentang mencipta Function App, sila rujuk dokumentasi Azure.

Langkah 5 - Cipta function​

Setelah Function App dicipta, anda boleh mencipta function tersebut.

1. Dalam gambaran keseluruhan Function App, panduan disediakan untuk pelbagai kaedah bagi melaksanakan kod anda.

Pilih kaedah yang paling sesuai untuk codebase yang anda pilih.

2. Jika anda menggunakan kod sampel Glasswall, maka konfigurasi berikut perlu ditambahkan pada Function App melalui Settings > Configuration.

Semua nilai boleh diperoleh daripada sumber yang berkaitan dalam Azure Portal. Untuk akses kepada Glasswall Halo sama ada gunakan instance dan pengesahan anda, atau untuk tujuan percubaan hubungi pasukan jualan kami untuk mendapatkan kelayakan pengesahan asas bagi menggunakan endpoint awam kami.

Konfigurasi​

Tahniah! Setelah semua langkah selesai, sebarang fail yang diletakkan dalam akaun sumber Azure Blob Storage kini diproses oleh teknologi CDR lanjutan Glasswall dan menghasilkan sama ada dokumen bersih yang dijana semula atau fail teks tidak berbahaya yang mengandungi mesej ralat.