Tutorial: Menyebarkan aplikasi web yang tersambung ke Azure Blob Storage dengan Konektor Layanan

Dalam tutorial ini, Anda mempelajari cara mengakses Azure Blob Storage untuk aplikasi web (bukan pengguna yang masuk) yang berjalan di Azure App Service dengan menggunakan identitas terkelola. Dalam tutorial ini, Anda akan menggunakan Azure CLI untuk menyelesaikan tugas berikut:

• Mengatur lingkungan awal Anda dengan Azure CLI
• Buat akun penyimpanan dan wadah Azure Blob Storage.
• Menerapkan kode ke Azure App Service dan terhubung ke penyimpanan dengan identitas terkelola menggunakan Konektor Layanan

Prasyarat

• Akun Azure dengan langganan aktif. Buat akun secara gratis.

• Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai menggunakan Azure Cloud Shell.

  

• Jika Anda lebih suka menjalankan perintah referensi CLI secara lokal, instal Azure CLI. Jika Anda menjalankan Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi lebih lanjut, lihat Cara menjalankan Azure CLI di kontainer Docker.

  • Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah login az. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Mengautentikasi ke Azure menggunakan Azure CLI.

  • Saat Anda diminta, instal ekstensi Azure CLI pada penggunaan pertama. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan dan mengelola ekstensi dengan Azure CLI.

  • Jalankan versi az untuk menemukan versi dan pustaka dependen yang diinstal. Untuk meningkatkan ke versi terbaru, jalankan peningkatan az.

Menyiapkan lingkungan awal Anda

1. Pastikan versi Azure CLI Anda adalah 2.30.0 atau versi yang lebih tinggi:

   az --version
   

   Jika Anda perlu meningkatkan, jalankan az upgrade perintah (memerlukan versi 2.11+).

2. Masuk ke Azure menggunakan CLI:

   az login
   

   Perintah ini membuka browser untuk mengumpulkan info masuk Anda. Setelah perintah selesai, perintah akan menampilkan output JSON yang berisi informasi tentang langganan Anda.

   Setelah masuk, Anda dapat menjalankan perintah Azure dengan Azure CLI untuk bekerja dengan sumber daya di langganan Anda.

Klon atau unduh aplikasi sampel

1. Klon sampel repositori:

   git clone https://github.com/Azure-Samples/serviceconnector-webapp-storageblob-dotnet.git
   

2. Buka folder akar repositori:

   cd serviceconnector-webapp-storageblob-dotnet
   

Buat aplikasi App Service

1. Di terminal, pastikan Anda berada di folder repositori WebAppStorageMISample yang berisi kode aplikasi.

2. Buat aplikasi App Service (proses host) dengan perintah di az webapp up bawah ini dan ganti tempat penampung dengan data Anda sendiri:

   • --location Untuk argumen , gunakan wilayah yang didukung oleh Konektor Layanan.
   • Ganti <app-name> dengan nama unik di seluruh Azure. Titik akhir server adalah https://<app-name>.azurewebsites.net. Karakter yang diizinkan untuk <app-name> adalah A-Z, 0-9, dan -. Pola yang baik adalah menggunakan kombinasi nama perusahaan dan pengidentifikasi aplikasi Anda.

    az webapp up --name <app-name> --sku B1 --location eastus --resource-group ServiceConnector-tutorial-rg
   

Membuat akun penyimpanan dan kontainer Blob Storage

Di terminal, jalankan perintah berikut untuk membuat akun penyimpanan v2 tujuan umum dan kontainer Blob Storage.

az storage account create --name <storage-name> --resource-group ServiceConnector-tutorial-rg --sku Standard_RAGRS --https-only

Ganti <storage-name> dengan nama yang unik. Nama kontainer harus dalam huruf kecil, dimulai dengan huruf atau angka, dan hanya boleh menyertakan huruf, angka, dan karakter tanda hubung (-).

Menyambungkan aplikasi App Service ke kontainer Blob Storage dengan identitas terkelola

Di terminal, jalankan perintah berikut untuk menyambungkan aplikasi web Anda ke penyimpanan blob menggunakan identitas terkelola.

az webapp connection create storage-blob -g ServiceConnector-tutorial-rg -n <app-name> --tg ServiceConnector-tutorial-rg --account <storage-name> --system-identity

Ganti tempat penampung berikut dengan data Anda sendiri:

• Ganti <app-name> dengan nama aplikasi web yang Anda gunakan di langkah 3.
• Ganti <storage-name> dengan nama aplikasi penyimpanan yang Anda gunakan di langkah 4.

Catatan

Jika Anda melihat pesan kesalahan "Langganan tidak terdaftar untuk menggunakan Microsoft.ServiceLinker", jalankan az provider register -n Microsoft.ServiceLinker untuk mendaftarkan penyedia sumber daya Konektor Layanan dan jalankan perintah koneksi lagi.

Menjalankan kode sampel

Di terminal, jalankan perintah berikut untuk membuka aplikasi sampel di browser Anda. Ganti <app-name> dengan nama aplikasi web yang Anda gunakan sebelumnya.

az webapp browse --name <app-name> 

Kode sampel adalah aplikasi web. Setiap kali Anda me-refresh halaman indeks, aplikasi membuat atau memperbarui blob dengan teks Hello Service Connector! Current is {UTC Time Now} ke kontainer penyimpanan dan membaca kembali untuk menampilkannya di halaman indeks.

Langkah selanjutnya

Untuk mempelajari lebih lanjut tentang Konektor Layanan, baca panduan di bawah ini.

Konsep Konektor Layanan