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

Service Koneksi or memungkinkan Anda menghubungkan layanan komputasi dengan cepat 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 Service Koneksi or. 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

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 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 menjalankan az extension add --name spring.

Membuat koneksi layanan

Buat koneksi dari Azure Spring Apps menggunakan kunci akses atau identitas terkelola.

Kunci akses

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

   az spring connection create storage-blob --secret
   

2. Berikan informasi berikut atas permintaan CLI atau Cloud Shell:

   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 --secret untuk memprovisikan Blob Storage baru dan langsung menyambungkannya ke aplikasi anda yang dihosting oleh Azure Spring Apps menggunakan string koneksi.

Identitas terkelola

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.

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

2. Berikan 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 Service Koneksi or dan Azure Spring Apps.

Tutorial: Azure Spring Apps + MySQL

Tutorial: Azure Spring Apps + Apache Kafka di Confluent Cloud