Memasang Azure Storage sebagai berbagi lokal di App Service

  • Artikel
  • 11 menit untuk membaca

Catatan

Pemasangan Azure Storage sebagai berbagi lokal untuk App Service pada kode Windows (non-kontainer) saat ini dalam pratinjau.

Panduan ini menampilkan cara memasang File Azure Storage sebagai berbagi jaringan dalam kode Windows (non-kontainer) di App Service. Hanya Azure Files Shares dan Premium Files Share yang didukung. Manfaat penyimpanan yang dipasang kustom meliputi:

  • Konfigurasikan penyimpanan persisten untuk aplikasi App Service Anda dan kelola penyimpanan secara terpisah.
  • Jadikan konten statis seperti video dan gambar tersedia untuk aplikasi App Service Anda.
  • Tulis file log aplikasi atau arsipkan log aplikasi lama ke berbagi File Azure.
  • Bagikan konten di beberapa aplikasi atau dengan layanan Azure lainnya.

Fitur berikut didukung untuk kode Windows:

Panduan ini menampilkan cara memasang File Azure Storage sebagai berbagi jaringan dalam kontainer Windows di App Service. Hanya Azure Files Shares dan Premium Files Share yang didukung. Manfaat penyimpanan yang dipasang kustom meliputi:

  • Konfigurasikan penyimpanan persisten untuk aplikasi App Service Anda dan kelola penyimpanan secara terpisah.
  • Jadikan konten statis seperti video dan gambar tersedia untuk aplikasi App Service Anda.
  • Tulis file log aplikasi atau arsipkan log aplikasi lama ke berbagi File Azure.
  • Bagikan konten di beberapa aplikasi atau dengan layanan Azure lainnya.
  • Pasang Azure Storage pada kontainer Windows dalam tingkat Standar atau paket yang lebih tinggi, termasuk Terisolasi (lingkungan App Service v3).

Fitur berikut didukung untuk kontainer Windows:

Panduan ini menampilkan cara memasang Azure Storage sebagai berbagi jaringan dalam kontainer Linux bawaan atau kontainer Linux kustom di App Service. Tonton video cara memasang Azure Storage sebagai berbagi lokal. Manfaat penyimpanan yang dipasang kustom meliputi:

  • Konfigurasikan penyimpanan persisten untuk aplikasi App Service Anda dan kelola penyimpanan secara terpisah.
  • Jadikan konten statis seperti video dan gambar tersedia untuk aplikasi App Service Anda.
  • Tulis file log aplikasi atau arsipkan log aplikasi lama ke berbagi File Azure.
  • Bagikan konten di beberapa aplikasi atau dengan layanan Azure lainnya.

Fitur berikut didukung untuk kontainer Linux:

Prasyarat

Catatan

Azure Storage adalah penyimpanan non-default untuk App Service dan ditagih secara terpisah, tidak disertakan dengan App Service.

Batasan

  • Firewall penyimpanan hanya didukung melalui titik akhir privat dan titik akhir layanan (saat integrasi VNET digunakan).
  • Blob Azure tidak didukung saat mengonfigurasi pemasangan penyimpanan Azure untuk aplikasi kode Windows yang disebarkan ke App Service.
  • Akses FTP/FTPS ke penyimpanan terpasang tidak didukung (gunakan Penjelajah Azure Storage).
  • Pemetaan /mounts, mounts/foo/bar, /, dan /mounts/foo.bar/ ke penyimpanan yang dipasang khusus tidak didukung (Anda hanya dapat menggunakan /mounts/pathname untuk memasang penyimpanan kustom ke aplikasi web Anda.)
  • Pemasangan penyimpanan tidak dapat digunakan bersama dengan opsi pengaturan kloning selama pembuatan slot penyebaran.
  • Pemasangan penyimpanan tidak dicadangkan saat Anda mencadangkan aplikasi Anda. Pastikan untuk mengikuti praktik terbaik untuk mencadangkan akun Azure Storage.
  • Pemasangan penyimpanan tidak didukung untuk aplikasi Windows asli (non-kontainer).
  • Blob Azure tidak didukung.
  • Firewall penyimpanan hanya didukung melalui titik akhir privat dan titik akhir layanan (saat integrasi VNET digunakan).
  • Akses FTP/FTPS ke penyimpanan terpasang tidak didukung (gunakan Penjelajah Azure Storage).
  • Memetakan [C-Z]:\, [C-Z]:\home, /, dan /home ke penyimpanan terpasang kustom tidak didukung.
  • Pemasangan penyimpanan tidak dapat digunakan bersama dengan opsi pengaturan kloning selama pembuatan slot penyebaran.
  • Pemasangan penyimpanan tidak dicadangkan saat Anda mencadangkan aplikasi Anda. Pastikan untuk mengikuti praktik terbaik untuk mencadangkan akun Azure Storage.

Catatan

Pastikan port 80 dan 445 terbuka saat menggunakan Azure Files dengan integrasi VNET.

  • Firewall penyimpanan hanya didukung melalui titik akhir layanan dan titik akhir privat (saat integrasi VNET digunakan). Dukungan DNS kustom saat ini tidak tersedia saat akun Azure Storage yang dipasang menggunakan titik akhir privat.
  • Akses FTP/FTPS ke penyimpanan yang dipasang kustom tidak didukung (gunakan Penjelajah Azure Storage).
  • Azure CLI, Azure PowerShell, dan dukungan Azure SDK sedang dalam pratinjau.
  • Pemetaan / atau /home ke penyimpanan yang dipasang kustom tidak didukung.
  • Jangan memetakan pemasangan penyimpanan khusus ke /tmp atau subdirektorinya karena ini dapat menyebabkan batas waktu selama startup aplikasi.
  • Pemasangan penyimpanan tidak dapat digunakan bersama dengan opsi pengaturan kloning selama pembuatan slot penyebaran.
  • Pemasangan penyimpanan tidak dicadangkan saat Anda mencadangkan aplikasi Anda. Pastikan untuk mengikuti praktik terbaik untuk mencadangkan akun Azure Storage.

Catatan

Saat integrasi VNET digunakan, pastikan port berikut terbuka:

  • Azure Files: 80 dan 445.
  • Azure Blobs: 80 dan 443.

Memasang penyimpanan ke kode Windows

Memasang penyimpanan ke kontainer Windows

Memasang penyimpanan ke kontainer Linux

  1. Di portal Azure, navigasikan ke aplikasi.

  2. Dari navigasi kiri, klik Konfigurasi>Pemetaan Jalur>Pemasangan Azure Storage Baru.

  3. Konfigurasikan pemasangan penyimpanan sesuai dengan tabel berikut. Setelah selesai, klik OK.

    Pengaturan Deskripsi
    Nama Nama konfigurasi pemasangan. Spasi tidak diperbolehkan.
    Opsi konfigurasi Pilih Dasar jika akun penyimpanan tidak menggunakan titik akhir privat. Jika tidak, pilih Lanjutan.
    Akun Penyimpanan Akun Azure Storage. Ini harus berisi berbagi Azure Files.
    Nama berbagi Berbagi ke pemasangan.
    Kunci akses (Hanya tingkat lanjut) Kunci akses untuk akun penyimpanan Anda.
    Jalur pemasangan Direktori dalam layanan aplikasi yang ingin Anda pasang. Hanya /mounts/pathname didukung.
    Pengaturan Deskripsi
    Nama Nama konfigurasi pemasangan. Spasi tidak diperbolehkan.
    Opsi konfigurasi Pilih Dasar jika akun penyimpanan tidak menggunakan titik akhir privat. Jika tidak, pilih Lanjutan.
    Akun Penyimpanan Akun Azure Storage. Ini harus berisi berbagi Azure Files.
    Nama berbagi Berbagi ke pemasangan.
    Kunci akses (Hanya tingkat lanjut) Kunci akses untuk akun penyimpanan Anda.
    Jalur pemasangan Direktori dalam kontainer Windows yang ingin Anda pasang. Jangan gunakan direktori ([C-Z]:\ atau /) atau direktori home ([C-Z]:\home, atau /home).
    Pengaturan Deskripsi
    Nama Nama konfigurasi pemasangan. Spasi tidak diperbolehkan.
    Opsi konfigurasi Pilih Dasar jika akun penyimpanan tidak menggunakan titik akhir layanan atau titik akhir privat. Jika tidak, pilih Lanjutan.
    Akun Penyimpanan Akun Azure Storage.
    Jenis penyimpanan Pilih jenis berdasarkan penyimpanan yang ingin Anda pasang. Azure Blobs hanya mendukung akses baca-saja.
    Kontainer penyimpanan atau Berbagi nama Berbagi file atau kontainer Blob untuk dipasang.
    Kunci akses (Hanya tingkat lanjut) Kunci akses untuk akun penyimpanan Anda.
    Jalur pemasangan Direktori di dalam kontainer Linux untuk dipasang ke Azure Storage. Jangan gunakan / atau /home.

Catatan

Menambahkan, mengedit, atau menghapus pemasangan penyimpanan menyebabkan aplikasi dimulai ulang.

Uji penyimpanan yang terpasang

Untuk memvalidasi bahwa Azure Storage berhasil dipasang untuk aplikasi:

  1. Buka sesi SSH ke dalam kontainer.

  2. Di terminal SSH, jalankan perintah berikut:

    df –h

  3. Periksa apakah berbagi penyimpanan terpasang. Jika tidak ada, ada masalah dengan pemasangan berbagi penyimpanan.

  4. Periksa latensi atau keterjangkauan umum pemasangan penyimpanan dengan perintah berikut:

    tcpping Storageaccount.file.core.windows.net

Praktik terbaik

  • Untuk menghindari potensi masalah yang terkait dengan latensi, tempatkan aplikasi dan akun Azure Storage di wilayah Azure yang sama. Namun, perhatikan, jika aplikasi dan akun Azure Storage berada di wilayah Azure yang sama, dan jika Anda memberikan akses dari alamat IP App Service di konfigurasi firewall Azure Storage, maka pembatasan IP ini tidak berlaku.

  • Di akun Azure Storage, hindari membuat ulang kunci akses yang digunakan untuk memasang penyimpanan di aplikasi. Akun penyimpanan berisi dua kunci yang berbeda. Gunakan pendekatan bertahap untuk memastikan bahwa pemasangan penyimpanan tetap tersedia untuk aplikasi selama regenerasi kunci. Misalnya, dengan asumsi Anda menggunakan key1 untuk mengonfigurasi pemasangan penyimpanan di aplikasi Anda:

    1. Membuat ulang key2.
    2. Dalam konfigurasi pemasangan penyimpanan, perbarui kunci akses untuk menggunakan key2 yang dibuat ulang.
    3. Membuat ulang key1.

  • Jika Anda menghapus akun Azure Storage, kontainer, atau berbagi, hapus konfigurasi pemasangan penyimpanan yang sesuai di aplikasi untuk menghindari kemungkinan skenario kesalahan.

  • Akun Azure Storage yang dipasang dapat berupa tingkat performa Standar atau Premium. Berdasarkan persyaratan throughput dan kapasitas aplikasi, pilih tingkat performa yang sesuai untuk akun penyimpanan. Lihat target skalabilitas dan performa untuk Files.

  • Jika aplikasi Anda menskalakan ke beberapa instans, semua instans tersambung ke akun terpasang Azure Storage yang sama. Untuk menghindari penyempitan performa dan masalah throughput, pilih tingkat performa yang sesuai untuk akun penyimpanan.

  • Tidak disarankan untuk menggunakan pemasangan penyimpanan untuk database lokal (seperti SQLite) atau untuk aplikasi dan komponen lain yang bergantung pada pegangan dan kunci file.

  • Jika Anda memulai failover penyimpanan dan akun penyimpanan dipasang ke aplikasi, pemasangan akan gagal tersambung hingga Anda menghidupkan ulang aplikasi atau menghapus dan menambahkan pemasangan Azure Storage.

  • Saat menggunakan titik akhir privat Azure Storage dengan aplikasi, Anda perlu mengaktifkan pengaturan Rutekan Semua.

  • Saat integrasi VNET digunakan, pastikan pengaturan aplikasi, WEBSITE_CONTENTOVERVNET diatur ke 1 dan port berikut terbuka:

    • Azure Files: 80 dan 445

  • Akun Azure Storage yang dipasang dapat berupa tingkat performa Standar atau Premium. Berdasarkan persyaratan throughput dan kapasitas aplikasi, pilih tingkat performa yang sesuai untuk akun penyimpanan. Lihat target skalabilitas dan performa untuk Files

  • Untuk menghindari potensi masalah yang terkait dengan latensi, tempatkan aplikasi dan akun Azure Storage di wilayah Azure yang sama. Namun, perhatikan, jika aplikasi dan akun Azure Storage berada di wilayah Azure yang sama, dan jika Anda memberikan akses dari alamat IP App Service di konfigurasi firewall Azure Storage, maka pembatasan IP ini tidak berlaku.

  • Di akun Azure Storage, hindari membuat ulang kunci akses yang digunakan untuk memasang penyimpanan di aplikasi. Akun penyimpanan berisi dua kunci yang berbeda. Gunakan pendekatan bertahap untuk memastikan bahwa pemasangan penyimpanan tetap tersedia untuk aplikasi selama regenerasi kunci. Misalnya, dengan asumsi Anda menggunakan key1 untuk mengonfigurasi pemasangan penyimpanan di aplikasi Anda:

    1. Membuat ulang key2.
    2. Dalam konfigurasi pemasangan penyimpanan, perbarui kunci akses untuk menggunakan key2 yang dibuat ulang.
    3. Membuat ulang key1.

  • Jika Anda menghapus akun Azure Storage, kontainer, atau berbagi, hapus konfigurasi pemasangan penyimpanan yang sesuai di aplikasi untuk menghindari kemungkinan skenario kesalahan.

  • Akun Azure Storage yang dipasang dapat berupa tingkat performa Standar atau Premium. Berdasarkan persyaratan throughput dan kapasitas aplikasi, pilih tingkat performa yang sesuai untuk akun penyimpanan. Lihat target skalabilitas dan performa untuk Files.

  • Jika aplikasi Anda menskalakan ke beberapa instans, semua instans tersambung ke akun terpasang Azure Storage yang sama. Untuk menghindari penyempitan performa dan masalah throughput, pilih tingkat performa yang sesuai untuk akun penyimpanan.

  • Tidak disarankan untuk menggunakan pemasangan penyimpanan untuk database lokal (seperti SQLite) atau untuk aplikasi dan komponen lain yang bergantung pada pegangan dan kunci file.

  • Jika Anda memulai failover penyimpanan dan akun penyimpanan dipasang ke aplikasi, pemasangan akan gagal tersambung hingga Anda menghidupkan ulang aplikasi atau menghapus dan menambahkan pemasangan Azure Storage.

  • Saat menggunakan titik akhir privat Azure Storage dengan aplikasi, Anda perlu mengaktifkan pengaturan Rutekan Semua.

    Catatan

    Di lingkungan App Service V3, pengaturan Rutekan Semua dinonaktifkan secara default dan harus diaktifkan secara eksplisit.

  • Untuk menghindari potensi masalah yang terkait dengan latensi, tempatkan aplikasi dan akun Azure Storage di wilayah Azure yang sama. Namun, perhatikan, jika aplikasi dan akun Azure Storage berada di wilayah Azure yang sama, dan jika Anda memberikan akses dari alamat IP App Service di konfigurasi firewall Azure Storage, maka pembatasan IP ini tidak berlaku.

  • Direktori pemasangan dalam kontainer kustom harus kosong. Konten apa pun yang disimpan di jalur ini akan dihapus saat Azure Storage dipasang (jika Anda menentukan direktori di bawah /home, misalnya). Jika Anda memigrasikan file untuk aplikasi yang sudah ada, buat cadangan aplikasi dan kontennya sebelum Anda mulai.

  • Memasang penyimpanan ke /home tidak disarankan karena dapat mengakibatkan penyempitan performa aplikasi.

  • Di akun Azure Storage, hindari membuat ulang kunci akses yang digunakan untuk memasang penyimpanan di aplikasi. Akun penyimpanan berisi dua kunci yang berbeda. Gunakan pendekatan bertahap untuk memastikan bahwa pemasangan penyimpanan tetap tersedia untuk aplikasi selama regenerasi kunci. Misalnya, dengan asumsi Anda menggunakan key1 untuk mengonfigurasi pemasangan penyimpanan di aplikasi Anda:

    1. Membuat ulang key2.
    2. Dalam konfigurasi pemasangan penyimpanan, perbarui kunci akses untuk menggunakan key2 yang dibuat ulang.
    3. Membuat ulang key1.

  • Jika Anda menghapus akun Azure Storage, kontainer, atau berbagi, hapus konfigurasi pemasangan penyimpanan yang sesuai di aplikasi untuk menghindari kemungkinan skenario kesalahan.

  • Akun Azure Storage yang dipasang dapat berupa tingkat performa Standar atau Premium. Berdasarkan persyaratan throughput dan kapasitas aplikasi, pilih tingkat performa yang sesuai untuk akun penyimpanan. Lihat skalabilitas dan target performa yang sesuai dengan jenis penyimpanan:

  • Jika aplikasi Anda menskalakan ke beberapa instans, semua instans tersambung ke akun terpasang Azure Storage yang sama. Untuk menghindari penyempitan performa dan masalah throughput, pilih tingkat performa yang sesuai untuk akun penyimpanan.

  • Tidak disarankan untuk menggunakan pemasangan penyimpanan untuk database lokal (seperti SQLite) atau untuk aplikasi dan komponen lain yang bergantung pada pegangan dan kunci file.

  • Saat menggunakan titik akhir privat Azure Storage dengan aplikasi, Anda perlu mengaktifkan pengaturan Rutekan Semua.

  • Jika Anda memulai failover penyimpanan dan akun penyimpanan dipasang ke aplikasi, pemasangan akan gagal tersambung hingga Anda menghidupkan ulang aplikasi atau menghapus dan menambahkan pemasangan Azure Storage.

Langkah berikutnya