Hızlı Başlangıç: Service Connector ile Azure Spring Apps'i veritabanlarına ve hizmetlere bağlama

Azure Spring Apps'i veritabanlarına, depolama hesaplarına ve diğer Azure hizmetlerine bağlamak için Service Connector'ı kullanmaya başlayın. Hizmet Bağlayıcısı, kimlik doğrulamasını ve yapılandırmayı basitleştirerek yönetilen kimlikleri veya diğer kimlik doğrulama yöntemlerini kullanarak kaynaklara bağlanmanızı sağlar.

Bu makalede hem Azure portalı hem de Azure CLI için adım adım yönergeler sağlanır. Yukarıdaki sekmeleri kullanarak tercih ettiğiniz yöntemi seçin.

Not

Temel, Standart ve Kurumsal planları 17 Mart 2025'te kullanımdan kaldırılma dönemine girdi. Daha fazla bilgi için bkz. Azure Spring Apps kullanımdan kaldırma duyurusu.

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz bir Azure hesabı oluşturun.
• Azure Spring Apps'e, Service Connector tarafından desteklenen bir bölgede dağıtılan bir uygulama.
• Azure Spring Apps'i bağlamak için hedef kaynak. Örneğin, bir Azure Key Vault.
• Hizmet bağlantılarını oluşturmak ve yönetmek için gerekli izinler .

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz bir Azure hesabı oluşturun.
• Service Connector tarafından desteklenen bir bölgedeAzure Spring Apps’e dağıtılmış bir uygulama.
• Azure Spring Apps'i bağlamak için hedef kaynak. Örneğin, bir Azure Key Vault.
• Hizmet bağlantılarını oluşturmak ve yönetmek için gerekli izinler .

• Azure Cloud Shell'de Bash ortamını kullanın. Daha fazla bilgi için bkz. Azure Cloud Shell'i kullanmaya başlama.

  

• CLI referans komutlarını yerel olarak çalıştırmayı tercih ediyorsanız, Azure CLI'yi yükleyin. Windows veya macOS üzerinde çalışıyorsanız, Azure CLI'yi bir Docker konteynerinde çalıştırmayı düşünün. Daha fazla bilgi için Azure CLI'nin bir Docker konteynerında nasıl çalıştırılacağını inceleyin.

  • Yerel bir kurulum kullanıyorsanız, az login komutunu kullanarak Azure CLI'ye giriş yapın. Kimlik doğrulama işlemini tamamlamak için, terminalinizde görüntülenen adımları takip edin. Diğer oturum açma seçenekleri için bkz. Azure CLI kullanarak Azure'da kimlik doğrulaması.

  • İstendiğinde, ilk kullanımda Azure CLI uzantısını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma ve yönetme.

  • Yüklü olan sürümü ve bağımlı kütüphaneleri bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.

• Azure CLI'nın 2.37.0 veya üzeri sürümü. En son sürüme yükseltmek için komutunu çalıştırın az upgrade. Azure Cloud Shell kullanılıyorsa en son sürüm zaten yüklüdür.
• Azure Spring Apps uzantısıNın Azure CLI veya Cloud Shell'de yüklü olması gerekir. Yüklemek için komutunu çalıştırın az extension add --name spring.

İlk kurulum

1. Service Connector'ı ilk kez kullanıyorsanız, Hizmet Bağlayıcısı kaynak sağlayıcısını kaydetmek için az provider register komutunu çalıştırarak başlayın.

   az provider register -n Microsoft.ServiceLinker
   

   Tavsiye

   komutunu az provider show -n "Microsoft.ServiceLinker" --query registrationStateçalıştırarak kaynak sağlayıcısının zaten kaydedilip kaydedilmediğini de kontrol edebilirsiniz. Çıktı Registered ise Service Connector zaten kaydedilmiştir.

2. İsteğe bağlı olarak, Azure Spring Apps için desteklenen hedef hizmetlerin listesini almak için aşağıdaki komutu çalıştırın.

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

   Tavsiye

   az spring Komut sistem tarafından tanınmıyorsa komutunu çalıştırarak az extension add --name springgerekli uzantıyı yükleyip yüklemediğinize bakın.

Hizmet bağlantısı oluşturma

Azure Spring Apps ile Azure Blob Depolama arasında güvenli bir hizmet bağlantısı oluşturmak için Hizmet Bağlayıcısı'nı kullanın. Bu örnekte Blob Depolama'ya bağlanma gösterilmektedir, ancak desteklenen diğer Azure hizmetleri için de aynı işlemi kullanabilirsiniz.

1. Azure portalının üst kısmındaki Arama kaynakları, hizmetler ve belgeler (G +/) arama çubuğunu seçin, filtreye Azure Spring Apps yazın ve Azure Spring Apps'i seçin.

   

2. Hedef kaynağa bağlamak istediğiniz Azure Spring Apps örneğinin adını seçin.

3. Ayarlar'ın altında Uygulamalar'ı seçin ve listeden uygulamayı seçin.

   

4. Hizmet menüsünden Hizmet Bağlayıcısı'nı ve ardından Oluştur'u seçin.

5. Temel Bilgiler sekmesinde aşağıdaki ayarları seçin veya girin.

   Ayar	Örnek	Açıklama
   Hizmet türü	Key Vault	Uygulamanızı bağlayacağınız hizmet türü.
   Bağlantı adı	keyvault_17d38	Uygulamanızla hedef hizmetiniz arasındaki bağlantıyı tanımlayan bağlantı adı. Service Connector tarafından sağlanan bağlantı adını kullanın veya kendi bağlantı adınızı girin.
   Abonelik	my-subscription	Hedef hizmetinizi içeren abonelik (bağlanmak istediğiniz hizmet). Varsayılan değer, Azure Spring Apps'e dağıtılan uygulamayı içeren aboneliktir.
   Anahtar kasası	my-keyvault-name	Bağlanmak istediğiniz Key Vault hedefi. Farklı bir hizmet türü seçerseniz ilgili hedef hizmet örneğini seçin.
   İstemci türü	SpringBoot	Seçili hedef hizmetle çalışan uygulama yığını. SpringBoot ve Java'nın yanı sıra diğer yığınlar da desteklenir.

6. Kimlik doğrulama türünü seçmek için İleri: Kimlik doğrulaması'nı seçin. Key Vault'unuza bağlanmak için sistem tarafından atanan bir yönetilen kimlik kullanmanızı öneririz.

   

7. İleri: Ağ'ı seçerek ağ yapılandırmasını seçin ve Uygulamanızın Blob Depolama'ya erişebilmesi için hedef hizmete erişimi etkinleştirmek için güvenlik duvarı kurallarını yapılandır'ı seçin.

   

8. Sağlanan bilgileri gözden geçirmek için İleri: Gözden Geçir + Oluştur'u seçin. Hizmet Bağlayıcısı'nın bilgileri doğrulaması için birkaç saniye bekleyin ve hizmet bağlantısını oluşturmak için Oluştur'u seçin.

Yönetilen kimlik (önerilen)

az spring connection create Azure Spring Apps'e dağıtılan bir uygulamayı sistem tarafından atanan yönetilen kimlikle blob depolama kaynağına bağlamak için komutunu çalıştırın. Bu komutu iki farklı yolla çalıştırabilirsiniz:

• Yeni bağlantıyı adım adım oluşturun.

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

• Yeni bağlantıyı aynı anda oluşturun. Yer tutucuları kendi bilgilerinizle değiştirin: <source-subscription>, <source_resource_group>, <azure-spring-apps-resource>, <app>, <target-subscription>, <target_resource_group>, ve <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
  

Tavsiye

Blob Depolama hesabınız yoksa komutunu çalıştırarak az spring connection create storage-blob --new --system-identity bir hesap oluşturun ve yönetilen kimlik kullanarak Azure Spring Apps'te barındırılan uygulamanıza bağlayın.

Bağlantı dizesi

Uyarı

Microsoft, kullanılabilir en güvenli kimlik doğrulama akışını kullanmanızı önerir. Bu yordamda açıklanan kimlik doğrulama akışı, uygulamada çok yüksek düzeyde güven gerektirir ve diğer akışlarda mevcut olmayan riskleri taşır. Bu akışı yalnızca yönetilen kimlikler gibi diğer daha güvenli akışlar uygun olmadığında kullanmalısınız.

az spring connection create Azure Spring Apps'e dağıtılan bir uygulamayı bağlantı dizesiyle bir Blob Depolama kaynağına bağlamak için komutunu çalıştırın. Bu komutu iki farklı yolla çalıştırabilirsiniz:

• Yeni bağlantıyı adım adım oluşturun.

  az spring connection create storage-blob --secret
  

• Yeni bağlantıyı aynı anda oluşturun. Yer tutucuları kendi bilgilerinizle değiştirin: <source-subscription>, <source_resource_group>, <azure-spring-apps-resource>, <app>, <target-subscription>, <target_resource_group>, <account>, <secret-name> ve <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>
  

Tavsiye

Blob Depolama hesabınız yoksa komutunu çalıştırarak az spring connection create storage-blob --new --secret bir hesap oluşturun ve bir bağlantı dizesi kullanarak Azure Spring Apps'te barındırılan uygulamanıza bağlayın.

Hizmet bağlantılarını görüntüleme

Azure Spring Apps bağlantıları, Ayarlar > Hizmet Bağlayıcısı altında görüntülenir.

1. Listeyi genişletmek ve uygulamanızın gerektirdiği özelliklere erişmek için seçin > .

2. Bağlantı durumunuzu denetlemek için Doğrula'yı seçin ve bağlantı doğrulama ayrıntılarını gözden geçirmek için Daha fazla bilgi edinin'i seçin.

   

Komutunu çalıştırarak az spring connection list Azure Spring Apps'in sağlanan tüm bağlantılarını listeleyin.

Aşağıdaki komuttan , <azure-spring-apps-resource-group>ve <azure-spring-apps-resource-name> yer tutucularını <app-name>kendi bilgilerinizle değiştirin. Bağlantılarınız hakkında daha fazla bilgi görüntüleme seçeneğini de kaldırabilirsiniz --output table .

az spring connection list --resource-group <azure-spring-apps-resource-group> --service <azure-spring-resource-name> --app <app-name> --output table

Çıktı, bağlantılarınızın temin durumunu da gösterir.

İlgili içerik

Service Connector ve Azure Spring Apps hakkında daha fazla bilgi için aşağıdaki kılavuzlara bakın:

• Öğretici: Azure Spring Apps + MySQL
• Öğretici: Confluent Cloud üzerinde Azure Spring Apps + Apache Kafka