Mulai cepat: Membuat koneksi layanan di Azure Spring Apps dengan Azure CLI
Mulai cepat ini menunjukkan kepada Anda cara menyambungkan Azure Spring Apps ke sumber daya Cloud lainnya menggunakan Azure CLI dan Konektor Layanan.
Konektor Layanan memungkinkan Anda dengan cepat menghubungkan layanan komputasi ke layanan cloud, sambil mengelola pengaturan autentikasi dan jaringan koneksi Anda.
Prasyarat
Langganan Azure. Jika Anda tidak memiliki Langganan Azure, buat Akun gratis Azure sebelum memulai.
Setidaknya satu aplikasi yang dihosting oleh Azure Spring Apps di wilayah yang didukung oleh Konektor Layanan. Jika Anda tidak memilikinya, sebarkan aplikasi pertama Anda ke Azure Spring 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. Untuk meningkatkan ke versi terbaru, jalankan
az upgrade
. Jika menggunakan Azure Cloud Shell, versi terbaru sudah terinstal.Ekstensi Azure Spring Apps harus diinstal di Azure CLI atau Cloud Shell. Untuk menginstalnya, jalankan
az extension add --name spring
.
Penyetelan awal
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
Tip
Anda dapat memeriksa apakah penyedia sumber daya telah terdaftar dengan menjalankan perintah
az provider show -n "Microsoft.ServiceLinker" --query registrationState
. Jika outputnya adalahRegistered
, maka Konektor Layanan telah didaftarkan.Secara opsional, jalankan perintah az spring connection list-support-type untuk mendapatkan daftar layanan target yang didukung untuk Azure Spring Apps.
az spring connection list-support-types --output table
Tip
az spring
Jika perintah tidak dikenali oleh sistem, periksa apakah Anda telah menginstal ekstensi yang diperlukan dengan menjalankanaz extension add --name spring
.
Membuat koneksi layanan
Buat koneksi dari Azure Spring Apps menggunakan identitas terkelola atau kunci akses.
Penting
Untuk menggunakan identitas terkelola, Anda harus memiliki izin untuk mengubah penetapan peran di ID Microsoft Entra. Tanpa izin ini, pembuatan koneksi Anda akan gagal. Minta pemilik langganan Anda untuk memberi Anda izin penetapan peran atau gunakan kunci akses untuk membuat koneksi.
Jalankan
az spring connection create
perintah untuk membuat koneksi layanan ke Blob Storage dengan identitas terkelola yang ditetapkan sistemBerikan informasi berikut atas permintaan CLI atau Cloud Shell:
az spring connection create storage-blob --system-identity
Pengaturan Deskripsi The resource group which contains the spring-cloud
Nama grup sumber daya yang berisi aplikasi yang dihosting oleh Azure Spring Apps. Name of the spring-cloud service
Nama sumber daya Azure Spring Apps. Name of the spring-cloud app
Nama aplikasi yang dihosting oleh Azure Spring Apps yang terhubung ke layanan target. 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 spring connection create storage-blob --new --system-identity
untuk memprovisikan Blob Storage baru dan langsung menyambungkannya ke aplikasi Anda yang dihosting oleh Azure Spring Apps menggunakan identitas terkelola.
Melihat koneksi
Jalankan az spring connection list
perintah untuk mencantumkan semua koneksi yang disediakan Azure Spring Apps Anda.
Ganti tempat penampung <azure-spring-apps-resource-group>
, <azure-spring-apps-name>
, dan <app-name>
dari perintah di bawah ini dengan nama grup sumber daya Azure Spring Apps Anda, nama sumber daya Azure Spring Apps Anda, dan nama aplikasi Anda. Anda juga dapat menghapus --output table
opsi untuk melihat informasi selengkapnya tentang koneksi Anda.
az spring connection list --resource-group <azure-spring-apps-resource-group> --service <azure-spring-apps-name> --app <app-name>--output table
Output juga menampilkan status provisi koneksi Anda: gagal atau berhasil.
Langkah berikutnya
Periksa panduan di bawah ini untuk informasi selengkapnya tentang Konektor Layanan dan Azure Spring Apps.