Mulai cepat: Menyambungkan Azure Spring Apps ke database dan layanan dengan Konektor Layanan

Mulai menggunakan Konektor Layanan untuk menyambungkan Azure Spring 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 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.

Note

Paket Basic, Standard, dan Enterprise memasuki periode pensiun pada 17 Maret 2025. Untuk informasi selengkapnya, lihat pengumuman penghentian Azure Spring Apps.

Prerequisites

• Sebuah akun Azure dengan langganan aktif. Buat akun Azure secara gratis.
• Aplikasi yang disebarkan ke Azure Spring Apps di wilayah yang didukung oleh Konektor Layanan.
• Sumber daya target untuk menyambungkan Azure Spring Apps. Misalnya, Azure Key Vault.
• Izin yang diperlukan untuk membuat dan mengelola koneksi layanan.

• Sebuah akun Azure dengan langganan aktif. Buat akun Azure secara gratis.
• Aplikasi yang disebarkan ke Azure Spring Apps di wilayah yang didukung oleh Konektor Layanan.
• Sumber daya target untuk menyambungkan Azure Spring Apps. Misalnya, Azure Key Vault.
• 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.

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

Penyiapan awal

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 berikut untuk mendapatkan daftar layanan target yang didukung untuk Azure Spring Apps.

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

   Petunjuk / Saran

   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

Gunakan Konektor Layanan untuk membuat koneksi layanan yang aman antara Azure Spring 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 Microsoft Azure, ketik Azure Spring Apps di filter dan pilih Azure Spring Apps.

   

2. Pilih nama instans Azure Spring Apps yang ingin Anda sambungkan ke sumber daya target.

3. Di bawah Pengaturan, pilih Aplikasi dan pilih aplikasi dari daftar.

   

4. Pilih Konektor Layanan dari menu layanan dan pilih Buat.

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

   Setting	Example	Description
   Jenis layanan	Key Vault	Jenis layanan yang akan Anda sambungkan ke aplikasi Anda.
   Nama koneksi	keyvault_17d38	Nama koneksi yang mengidentifikasi koneksi antara aplikasi dan layanan target Anda. Gunakan nama koneksi yang disediakan oleh Konektor Layanan atau masukkan nama koneksi Anda sendiri.
   Subscription	my-subscription	Langganan yang berisi layanan target Anda (layanan yang ingin Anda sambungkan). Nilai default adalah langganan yang berisi aplikasi yang disebarkan ke Azure Spring Apps.
   Key Vault	my-keyvault-name	Key Vault target yang ingin Anda sambungkan. Jika Anda memilih jenis layanan yang berbeda, pilih instans layanan target yang sesuai.
   Jenis klien	SpringBoot	Tumpukan aplikasi yang bekerja dengan layanan target yang dipilih. Selain SpringBoot dan Java, tumpukan lain juga didukung.

6. Pilih Berikutnya: Autentikasi untuk memilih jenis autentikasi. Sebaiknya gunakan identitas terkelola yang ditetapkan sistem untuk menyambungkan ke Key Vault Anda.

   

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

   

8. Pilih Berikutnya: Tinjau + Buat untuk meninjau informasi yang disediakan. Tunggu beberapa detik hingga Konektor Layanan memvalidasi informasi dan pilih Buat untuk membuat koneksi layanan.

Identitas terkelola (disarankan)

Jalankan az spring connection create perintah untuk menyambungkan aplikasi yang disebarkan ke Azure Spring Apps ke sumber daya Blob Storage, dengan identitas terkelola yang ditetapkan sistem. Anda dapat menjalankan perintah ini dengan dua cara berbeda:

• Hasilkan koneksi baru langkah demi langkah.

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

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

     az spring connection create storage-blob \                         
     --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.AppPlatform/Spring/<azure-spring-apps-resource>/apps/<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 spring connection create storage-blob --new --system-identity untuk membuatnya dan sambungkan ke aplikasi Anda yang dihosting di Azure Spring Apps menggunakan identitas terkelola.

String koneksi

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 spring connection create perintah untuk menyambungkan aplikasi yang disebarkan ke Azure Spring Apps ke sumber daya Blob Storage, dengan string koneksi. Anda dapat menjalankan perintah ini dengan dua cara berbeda:

• Hasilkan koneksi baru langkah demi langkah.

  az spring connection create storage-blob --secret
  

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

  az spring connection create storage-blob \                         
     --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.AppPlatform/Spring/<azure-spring-apps-resource>/apps/<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 spring connection create storage-blob --new --secret untuk membuatnya dan sambungkan ke aplikasi Anda yang dihosting di Azure Spring Apps menggunakan string koneksi.

Melihat koneksi layanan

Koneksi Azure Spring Apps ditampilkan di bawah Pengaturan > Konektor Layanan.

1. Pilih > untuk memperluas daftar dan mengakses properti yang diperlukan oleh aplikasi Anda.

2. Pilih Validasi untuk memeriksa status koneksi Anda, dan pilih Pelajari selengkapnya untuk meninjau detail validasi 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-resource-name>, dan <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 spring connection list --resource-group <azure-spring-apps-resource-group> --service <azure-spring-resource-name> --app <app-name> --output table

Output juga menampilkan status provisi koneksi Anda.

Konten terkait

Periksa panduan di bawah ini untuk informasi selengkapnya tentang Konektor Layanan dan Azure Spring Apps:

• Tutorial: Azure Spring Apps + MySQL
• Tutorial: Azure Spring Apps + Apache Kafka di Confluent Cloud