Tutorial: Menyebarkan aplikasi web yang tersambung ke Azure Blob Storage dengan Konektor Layanan
Pelajari 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 Cepat untuk Bash di 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 Masuk dengan Azure CLI.
Saat Anda diminta, instal ekstensi Azure CLI pada penggunaan pertama. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan 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
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+).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
Klon sampel repositori:
git clone https://github.com/Azure-Samples/serviceconnector-webapp-storageblob-dotnet.git
Buka folder akar repositori:
cd serviceconnector-webapp-storageblob-dotnet
Buat aplikasi App Service
Di terminal, pastikan Anda berada di folder repositori WebAppStorageMISample yang berisi kode aplikasi.
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 Koneksi or Layanan.- Ganti
<app-name>
dengan nama unik di seluruh Azure. Titik akhir server adalahhttps://<app-name>.azurewebsites.net
. Karakter yang diizinkan untuk<app-name>
adalahA
-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 Service Koneksi or 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 berikutnya
Untuk mempelajari selengkapnya tentang Service Koneksi or, baca panduan di bawah ini.
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk