Mulai cepat: Menyambungkan Azure Container Apps ke database dan layanan dengan Konektor Layanan (pratinjau)

Mulai menggunakan Konektor Layanan untuk menyambungkan Azure Container Apps Anda ke database, akun penyimpanan, dan layanan Azure lainnya. Konektor Layanan menyederhanakan autentikasi dan konfigurasi, memungkinkan Anda untuk terhubung ke sumber daya menggunakan identitas terkelola atau metode autentikasi lainnya.

Artikel ini menyediakan instruksi langkah demi langkah untuk portal Microsoft Azure dan Azure CLI. Pilih metode pilihan Anda menggunakan tab di atas.

Penting

Dukungan untuk Konektor Layanan (pratinjau) di Azure Container Apps berakhir pada 30 Maret 2026. Setelah tanggal tersebut, sambungan layanan baru menggunakan Konektor Layanan (pratinjau) tidak dapat diakses melalui antarmuka mana pun. Untuk informasi selengkapnya, lihat Pensiun: Konektor Layanan (Pratinjau) di Azure Container Apps.

Prasyarat

• Akun Azure dengan langganan aktif. Buat akun secara gratis.
• Aplikasi yang disebarkan ke Aplikasi Kontainer di wilayah yang didukung oleh Konektor Layanan.
• Sumber daya target untuk menyambungkan Aplikasi Kontainer Anda, seperti akun Blob Storage.
• Izin yang diperlukan untuk membuat dan mengelola koneksi layanan.

• Akun Azure dengan langganan aktif. Buat akun secara gratis.
• Aplikasi yang disebarkan ke Aplikasi Kontainer di wilayah yang didukung oleh Konektor Layanan.
• Sumber daya target untuk menyambungkan Aplikasi Kontainer Anda, seperti akun Blob Storage.
• Izin yang diperlukan untuk membuat dan mengelola koneksi layanan.

• 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 az login. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Mengautentikasi ke Azure menggunakan Azure CLI.

  • Saat diminta, instal ekstensi Azure CLI saat pertama kali digunakan. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan dan mengelola ekstensi dengan Azure CLI.

  • Jalankan az version untuk menemukan versi dan pustaka dependen yang terinstal. Untuk meng-upgrade ke versi terbaru, jalankan az upgrade.

• Mulai cepat ini memerlukan Azure CLI versi 2.30.0 atau yang lebih tinggi. Untuk meningkatkan ke versi terbaru, jalankan az upgrade. Jika menggunakan Azure Cloud Shell, versi terbaru sudah terinstal.

Atur lingkungan Anda

1. Jika Anda menggunakan Konektor Layanan untuk pertama kalinya, mulailah dengan menjalankan perintah az provider register untuk mendaftarkan penyedia sumber daya Konektor Layanan.

   az provider register -n Microsoft.ServiceLinker
   

   Petunjuk / Saran

   Anda dapat memeriksa apakah penyedia sumber daya telah terdaftar dengan menjalankan perintah az provider show -n "Microsoft.ServiceLinker" --query registrationState. Jika outputnya adalah Registered, maka Konektor Layanan telah didaftarkan.

2. Secara opsional, jalankan perintah az containerapp connection list-support-type untuk mendapatkan daftar layanan target yang didukung untuk Container Apps.

   az containerapp connection list-support-types --output table
   

Membuat koneksi layanan (pratinjau)

Gunakan Konektor Layanan untuk membuat koneksi layanan antara Azure Container Apps dan Azure Blob Storage Anda. Contoh ini menunjukkan menyambungkan ke Blob Storage, tetapi Anda dapat menggunakan proses yang sama untuk layanan Azure lain yang didukung.

1. Pilih bilah pencarian Cari sumber daya, layanan, dan dokumen (G +/) di bagian atas portal Azure, ketik Container Apps di filter dan pilih Aplikasi Kontainer.

   

2. Pilih nama sumber daya Container Apps yang ingin Anda sambungkan ke sumber daya target.

3. Pilih Konektor Layanan (pratinjau) dari daftar isi sebelah kiri. Lalu pilih Buat.

   

4. Pada tab Dasar , pilih atau masukkan pengaturan berikut ini.

   Pengaturan	Contoh	Deskripsi
   Kontainer	my-container-app	Kontainer di aplikasi kontainer Anda.
   Jenis layanan	Penyimpanan - Blob	Jenis layanan yang ingin Anda sambungkan ke aplikasi kontainer Anda.
   Langganan	my-subscription	Langganan yang berisi layanan yang ingin Anda sambungkan. Nilai default adalah langganan yang berisi aplikasi kontainer ini.
   Nama koneksi	storageblob_700ae	Nama koneksi yang mengidentifikasi koneksi antara aplikasi kontainer dan layanan target Anda. Gunakan nama koneksi yang disediakan oleh Konektor Layanan atau pilih nama koneksi Anda sendiri.
   Akun penyimpanan	my-storage-account	Akun penyimpanan target yang ingin Anda sambungkan. Jika Anda memilih jenis layanan yang berbeda, pilih instans layanan target yang sesuai.
   Jenis klien	.NET	Tumpukan aplikasi yang berfungsi dengan layanan target yang Anda pilih. Nilai defaultnya adalah None, yang menghasilkan daftar konfigurasi. Jika Anda mengetahui tumpukan aplikasi atau SDK klien di pilihan Anda, pilih tumpukan aplikasi yang sama untuk jenis klien.

5. Pilih Berikutnya: Autentikasi untuk memilih metode autentikasi: identitas terkelola (SMI) yang ditetapkan sistem, identitas terkelola yang ditetapkan pengguna (UMI), string koneksi, atau perwakilan layanan.

   Identitas terkelola yang ditetapkan sistem (disarankan)

   Pilih Identitas terkelola yang dikelola sistem untuk menyambungkan melalui identitas yang dibuat secara otomatis di Microsoft Entra ID dan terikat dengan siklus hidup instans layanan. Ini adalah opsi autentikasi yang direkomendasikan.

   Identitas terkelola yang ditetapkan pengguna

   Pilih Identitas terkelola yang ditetapkan pengguna untuk mengautentikasi melalui identitas mandiri yang ditetapkan ke satu atau beberapa instans layanan Azure. Pilih langganan yang berisi identitas terkelola yang ditetapkan pengguna, lalu pilih identitas.

   Jika Anda belum memiliki identitas terkelola yang ditetapkan pengguna, buat identitas terkelola:

   1. Buka platform Azure di tab baru dan cari Identitas terkelola.
   2. Pilih Identitas terkelola dan pilih Buat.
   3. Masukkan langganan, grup sumber daya, wilayah, dan nama instans.
   4. Pilih Tinjau + buat lalu Buat
   5. Setelah identitas terkelola Anda disebarkan, kembali ke tab Konektor Layanan Anda, pilih Sebelumnya lalu Berikutnya untuk merefresh data formulir. Di bawah Identitas terkelola yang ditetapkan pengguna, pilih identitas yang Anda buat.

   Untuk informasi selengkapnya, lihat membuat identitas terkelola yang ditetapkan pengguna.

   Prinsipal layanan

   1. Pilih Prinsipal Layanan untuk menggunakan prinsipal layanan yang menentukan kebijakan akses dan izin untuk pengguna/aplikasi di Microsoft Entra ID.
   2. Pilih perwakilan layanan dari daftar dan masukkan rahasia

   Koneksi string

   Peringatan

   Microsoft menyarankan agar Anda menggunakan alur autentikasi paling aman yang tersedia. Alur autentikasi yang dijelaskan dalam prosedur ini membutuhkan tingkat kepercayaan yang sangat tinggi pada aplikasi, dan membawa risiko yang tidak ada dalam alur lain. Anda hanya boleh menggunakan alur ini ketika alur lain yang lebih aman, seperti identitas terkelola, tidak layak.

   Pilih String koneksi untuk menghasilkan atau mengonfigurasi satu atau beberapa pasangan kunci-nilai dengan rahasia atau token murni.

6. Pilih Berikutnya: Jaringan untuk memilih konfigurasi jaringan dan pilih Konfigurasikan aturan firewall untuk mengaktifkan akses ke layanan target sehingga aplikasi kontainer Anda dapat mengakses Blob Storage.

   

7. Pilih Berikutnya: Tinjau + Buat untuk meninjau informasi yang disediakan. Menjalankan validasi akhir membutuhkan waktu beberapa detik.

   

8. Pilih Buat untuk membuat koneksi layanan. Operasi ini dapat memakan waktu hingga satu menit untuk diselesaikan.

Identitas terkelola (disarankan)

Jalankan az containerapp connection create perintah untuk membuat koneksi layanan dari Container Apps ke Blob Storage dengan identitas terkelola yang ditetapkan sistem. Anda dapat menjalankan perintah ini dengan dua cara berbeda:

• Hasilkan koneksi baru langkah demi langkah.

  az containerapp connection create storage-blob --system-identity
  

• Buat koneksi baru sekaligus. Ganti tempat penampung dengan informasi Anda sendiri: <source-subscription>, , <source_resource_group>, <app><target-subscription>, <target_resource_group>, dan <account>.

  az containerapp connection create storage-blob \                         
     --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.App/containerApps/<app> \
     --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
     --system-identity
  

Petunjuk / Saran

Jika Anda tidak memiliki akun Blob Storage, jalankan az containerapp connection create storage-blob --new --system-identity untuk membuatnya dan sambungkan ke aplikasi kontainer Anda menggunakan identitas terkelola.

Koneksi string

Peringatan

Microsoft menyarankan agar Anda menggunakan alur autentikasi paling aman yang tersedia. Alur autentikasi yang dijelaskan dalam prosedur ini membutuhkan tingkat kepercayaan yang sangat tinggi pada aplikasi, dan membawa risiko yang tidak ada dalam alur lain. Anda hanya boleh menggunakan alur ini ketika alur lain yang lebih aman, seperti identitas terkelola, tidak layak.

Jalankan az containerapp connection create perintah untuk membuat koneksi layanan dari Container Apps ke Blob Storage dengan string koneksi. Anda dapat menjalankan perintah ini dengan dua cara berbeda:

• Hasilkan koneksi baru langkah demi langkah.

  az containerapp connection create storage-blob --secret
  

• Buat koneksi baru sekaligus. Ganti tempat penampung dengan informasi Anda sendiri: <source-subscription>, , <source_resource_group>, <app>, <target-subscription><target_resource_group>, <account>, <secret-name>, dan <secret>.

  az containerapp connection create storage-blob \                         
     --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.App/containerApps/<app> \
     --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
     --secret name=<secret-name> secret=<secret>
  

Petunjuk / Saran

Jika Anda tidak memiliki akun Blob Storage, jalankan az containerapp connection create storage-blob --new --secret untuk membuatnya dan sambungkan ke aplikasi kontainer Anda menggunakan identitas terkelola.

Melihat koneksi layanan

1. Koneksi Aplikasi Kontainer ditampilkan di bawah > Pengaturan Konektor Layanan (pratinjau). Pilih > untuk memperluas daftar dan melihat properti yang diperlukan oleh aplikasi Anda.

2. Pilih koneksi Anda lalu Validasi untuk meminta Konektor Layanan untuk memeriksa koneksi Anda.

3. Pilih Pelajari selengkapnya untuk meninjau detail validasi koneksi.

   

Jalankan perintah daftar koneksi az containerapp untuk mencantumkan semua koneksi yang disediakan aplikasi kontainer Anda. Ganti tempat penampung <container-app-resource-group> dan <container-app-name> dari perintah di bawah ini dengan informasi Anda sendiri. Anda juga dapat menghapus --output table opsi untuk melihat informasi selengkapnya tentang koneksi Anda.

az containerapp connection list --resource-group "<container-app-resource-group>" --name "<container-app-name>" --output table

Output juga menampilkan status provisi koneksi Anda.

Konten terkait

Periksa panduan berikut untuk informasi selengkapnya tentang Konektor Layanan:

• Internal Konektor Layanan
• Aplikasi Kontainer: Menyambungkan aplikasi Java Quarkus ke PostgreSQL
• Aplikasi Kontainer: Menyambungkan aplikasi ASP.NET Core ke App Configuration