Mulai cepat: Membuat koneksi layanan di Azure Container Apps dengan Azure CLI

Mulai cepat ini menunjukkan kepada Anda cara menyambungkan Azure Container Apps ke sumber daya Cloud lainnya menggunakan Azure CLI dan Service Koneksi or. Service Koneksi or memungkinkan Anda menghubungkan layanan komputasi dengan cepat ke layanan cloud, sambil mengelola pengaturan autentikasi dan jaringan koneksi Anda.

Penting

Service Koneksi or di Container Apps saat ini dalam pratinjau. Lihat Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure untuk persyaratan hukum yang berlaku pada fitur Azure dalam versi beta, pratinjau, atau belum dirilis secara umum.

Prasyarat

• Langganan Azure. Jika Anda tidak memiliki Langganan Azure, buat Akun gratis Azure sebelum memulai.

• Setidaknya satu aplikasi disebarkan ke Aplikasi Kontainer di wilayah yang didukung oleh service Koneksi or. Jika Anda tidak memilikinya, buat dan sebarkan kontainer ke Container Apps.

• 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.

• Azure CLI versi 2.37.0 atau yang lebih tinggi harus diinstal. Untuk meningkatkan ke versi terbaru, jalankan az upgrade. Jika menggunakan Azure Cloud Shell, versi terbaru sudah terinstal.

• Ekstensi Container Apps harus diinstal di Azure CLI atau Cloud Shell. Untuk menginstalnya, jalankan az extension add --name containerapp.

Penyetelan awal

1. Jika Anda menggunakan Service Koneksi or untuk pertama kalinya, mulailah dengan menjalankan perintah az provider register untuk mendaftarkan penyedia sumber service Koneksi or.

   az provider register -n Microsoft.ServiceLinker
   

   Tip

   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 Service Koneksi or telah terdaftar.

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

Buat koneksi menggunakan identitas terkelola atau kunci akses.

Identitas terkelola

Penting

Untuk menggunakan identitas terkelola, Anda harus memiliki izin untuk mengubah penetapan peran Microsoft Entra. Tanpa izin ini, pembuatan koneksi Anda akan gagal. Minta pemilik langganan Anda untuk memberi Anda izin ini, atau gunakan kunci akses sebagai gantinya untuk membuat koneksi.

1. Jalankan az containerapp connection create perintah untuk membuat koneksi layanan dari Container Apps ke Blob Storage dengan identitas terkelola yang ditetapkan sistem.

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

2. Berikan informasi berikut atas permintaan Azure CLI:

   Pengaturan	Deskripsi
   The resource group that contains the container app	Nama grup sumber daya dengan aplikasi kontainer.
   Name of the container app	Nama aplikasi kontainer.
   The container where the connection information will be saved	Nama kontainer aplikasi kontainer.
   The resource group which contains the storage account	Nama grup sumber daya dengan akun penyimpanan.
   Name of the storage account	Nama akun penyimpanan yang ingin Anda sambungkan. Dalam panduan ini, kita menggunakan Blob Storage.

Catatan

Jika Anda tidak memiliki Blob Storage, Anda dapat menjalankan az containerapp connection create storage-blob --new --system-identity untuk memprovisikan Blob Storage baru dan langsung menyambungkannya ke aplikasi kontainer Anda menggunakan identitas terkelola.

Kunci akses

1. Jalankan az containerapp connection create perintah untuk membuat koneksi layanan antara Container Apps dan Azure Blob Storage menggunakan kunci akses.

   az containerapp connection create storage-blob --secret
   

2. Berikan informasi berikut atas permintaan Azure CLI:

   Pengaturan	Deskripsi
   The resource group that contains the container app	Nama grup sumber daya dengan aplikasi kontainer.
   Name of the container app	Nama aplikasi kontainer.
   The container where the connection information will be saved	Nama kontainer aplikasi kontainer.
   The resource group which contains the storage account	Nama grup sumber daya dengan akun penyimpanan.
   Name of the storage account	Nama akun penyimpanan yang ingin Anda sambungkan. Dalam panduan ini, kita menggunakan Blob Storage.

Tip

Jika Anda tidak memiliki Blob Storage, Anda dapat menjalankan az containerapp connection create storage-blob --new --secret untuk memprovisikan Blob Storage baru dan langsung menyambungkannya ke aplikasi kontainer Anda menggunakan string koneksi.

Melihat koneksi

Gunakan perintah az containerapp connection list Azure CLI 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 grup sumber daya dan nama aplikasi kontainer Anda. Anda juga dapat menghapus --output table opsi untuk melihat informasi selengkapnya tentang koneksi Anda.

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

Output juga menampilkan status provisi koneksi Anda: gagal atau berhasil.

Langkah berikutnya

Internal Koneksi or layanan