Öğretici: AKS uygulamasını Azure SQL Veritabanı'na bağlama

Bu öğreticide, Hizmet Bağlayıcısı'nı kullanarak AKS'ye dağıtılan bir uygulamayı Azure SQL Veritabanı'na bağlamayı öğreneceksiniz. Aşağıdaki görevleri tamamlarsınız:

• Azure SQL Veritabanı kaynağı oluşturma
• Hizmet Bağlayıcısı ile AKS kümesi ile veritabanı arasında bir bağlantı oluşturun.
• Kapsayıcınızı güncelleştirme
• Uygulama kodunuzu güncelleştirme
• Azure kaynaklarını temizleyin.

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
• AKS'ye dağıtılan bir uygulama.

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

    

  • CLI başvuru komutlarını yerel olarak çalıştırmayı tercih ediyorsanız Azure CLI'yı yükleyin . Windows veya macOS üzerinde çalışıyorsanız Azure CLI’yi bir Docker kapsayıcısında çalıştırmayı değerlendirin. Daha fazla bilgi için bkz . Docker kapsayıcısında Azure CLI'yi çalıştırma.

    • Yerel yükleme kullanıyorsanız az login komutunu kullanarak Azure CLI ile oturum açın. Kimlik doğrulama işlemini tamamlamak için terminalinizde görüntülenen adımları izleyin. 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ü sürümü ve bağımlı kitaplıkları 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 SQL Veritabanı oluşturma

1. komutunu kullanarak bu öğreticide oluşturduğunuz Azure kaynaklarını depolamak az group create için bir kaynak grubu oluşturun.

   az group create \
       --name $RESOURCE_GROUP \
       --location eastus
   

2. Önceki adımda oluşturduğunuz kaynak grubunda bir Azure SQL Veritabanı oluşturmak için yönergeleri izleyin. Bu öğretici boyunca kullanılacak sunucu adını, veritabanı adını ve veritabanı kimlik bilgilerini not edin.

Hizmet Bağlayıcısı ile AKS'de hizmet bağlantısı oluşturma

Hizmet Bağlayıcısı ve Kubernetes Yapılandırması kaynak sağlayıcılarını kaydetme

komutunu kullanarak az provider register Hizmet Bağlayıcısı ve Kubernetes Yapılandırması kaynak sağlayıcılarını kaydedin.

az provider register --namespace Microsoft.ServiceLinker

az provider register --namespace Microsoft.KubernetesConfiguration

İpucu

Bu kaynak sağlayıcılarının ve az provider show --namespace "Microsoft.ServiceLinker" --query registrationState komutlarını kullanarak az provider show --namespace "Microsoft.KubernetesConfiguration" --query registrationState zaten kayıtlı olup olmadığını de kontrol edebilirsiniz. Çıkış ise Registered, hizmet sağlayıcısı zaten kayıtlıdır.

Yeni bir bağlantı oluşturun

Microsoft Entra İş Yükü Kimliği kullanarak AKS kümeniz ile SQL veritabanınız arasında hizmet bağlantısı oluşturma

Azure portalı

1. Azure portalında AKS küme kaynağınıza gidin.

2. Ayarlar>Hizmet Bağlayıcısı Oluştur'u> seçin.

3. Temel Bilgiler sekmesinde aşağıdaki ayarları yapılandırın:

   • Kubernetes ad alanı: Varsayılanı seçin.
   • Hizmet türü: SQL Veritabanı seçin.
   • Bağlantı adı: Hizmet Bağlayıcısı tarafından sağlanan bağlantı adını kullanın veya kendi bağlantı adınızı girin.
   • Abonelik: Azure SQL Veritabanı hizmetini içeren aboneliği seçin.
   • SQL server: SQL sunucunuzu seçin.
   • SQL veritabanı: SQL veritabanınızı seçin.
   • İstemci türü: Python gibi hedef hizmete bağlanmak için kullandığınız kod dili veya çerçeve.

   

4. İleri: Kimlik Doğrulaması'ı seçin. Kimlik Doğrulaması sekmesinde İş Yükü Kimliği'ni seçin ve kullanıcı tarafından atanan yönetilen kimliklerden birini seçin.

5. İleri: AğSonraki: Cloud Shell'de>>seçin.

6. Cloud Shell başlatılır ve bağlantı oluşturmak için komutları yürütür. Komut işleme sırasında bazı yapılandırma değişikliklerini onaylamanız gerekebilir. Komut başarıyla çalıştırıldığında bağlantı bilgileri gösterilir ve en son sonucu göstermek için Hizmet Bağlayıcısı bölmesinde yenile düğmesine tıklayabilirsiniz.

Azure CLI

komutunu kullanarak az aks connection create sql SQL veritabanına bir hizmet bağlantısı oluşturun. Bu komutu iki farklı yolla çalıştırabilirsiniz:

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

  az aks connection create sql
  

• yeni bağlantıyı aynı anda oluşturun. Aşağıdaki yer tutucuları kendi bilgilerinizle değiştirdiğinizden emin olun: <source-subscription>, <source_resource_group>, <cluster>, <target-subscription>, <target_resource_group>, , <server><database>, ve <identity_name>.

  az aks connection create sql \
     --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.ContainerService/managedClusters/<cluster> \
     --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Sql/servers/<server>/databases/<database> \
     --workload-identity /subscriptions/<identity-subscription>/resourcegroups/<resource_group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identity_name>
  

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. İş Yükü Kimliği kimlik doğrulama yöntemini seçin (Önerilen).

bağlantı dizesi kullanarak AKS kümeniz ile SQL veritabanınız arasında hizmet bağlantısı oluşturma

Azure portalı

1. Azure portalında AKS küme kaynağınıza gidin.

2. Ayarlar>Hizmet Bağlayıcısı Oluştur'u> seçin.

3. Temel Bilgiler sekmesinde aşağıdaki ayarları yapılandırın:

   • Kubernetes ad alanı: Varsayılanı seçin.
   • Hizmet türü: SQL Veritabanı seçin.
   • Bağlantı adı: Hizmet Bağlayıcısı tarafından sağlanan bağlantı adını kullanın veya kendi bağlantı adınızı girin.
   • Abonelik: Azure SQL Veritabanı hizmetini içeren aboneliği seçin.
   • SQL server: SQL sunucunuzu seçin.
   • SQL veritabanı: SQL veritabanınızı seçin.
   • İstemci türü: Python gibi hedef hizmete bağlanmak için kullandığınız kod dili veya çerçeve.

   

4. İleri: Kimlik Doğrulaması'ı seçin. Kimlik Doğrulaması sekmesinde veritabanı kullanıcı adınızı ve parolanızı girin.

5. İleri: AğSonraki: Gözden Geçir ve Oluştur'u>> seçin.

6. Dağıtım başarılı olduktan sonra, yeni bağlantı hakkındaki bilgileri Hizmet Bağlayıcısı bölmesinde görüntüleyebilirsiniz.

Azure CLI

komutunu kullanarak az aks connection create sql SQL veritabanına bir hizmet bağlantısı oluşturun. Bu komutu iki farklı yolla çalıştırabilirsiniz:

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

  az aks connection create sql
  

• yeni bağlantıyı aynı anda oluşturun. Aşağıdaki yer tutucuları kendi bilgilerinizle değiştirdiğinizden emin olun: <source-subscription>, <source_resource_group>, <cluster>, <target-subscription>, <target_resource_group>, <server>, , <database><identity_name> ve <secret>.

  az aks connection create sql \
     --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.ContainerService/managedClusters/<cluster> \
     --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Sql/servers/<server>/databases/<database> \
     --secret name=<secret-name> secret=<secret>
  

Kapsayıcınızı güncelleştirme

AKS kümeniz ile veritabanı arasında bir bağlantı oluşturduğunuza göre, bağlantı gizli dizilerini alıp kapsayıcınıza dağıtmanız gerekir.

1. Azure portalında AKS küme kaynağınıza gidin. Ayarlar'ın altında Hizmet Bağlayıcısı'nı seçin.

2. Yeni oluşturulan bağlantıyı ve ardından YAML kod parçacığını seçin. Bu eylem, Hizmet Bağlayıcısı tarafından oluşturulan örnek bir YAML dosyasını görüntüleyen bir panel açar.

3. Bağlantı gizli dizilerini kapsayıcınızda ortam değişkenleri olarak ayarlamak için iki seçeneğiniz vardır:

   • Sağlanan YAML örnek kod parçacığını kullanarak doğrudan bir dağıtım oluşturun. Kod parçacığı, ortam değişkenleri olarak eklenecek gizli dizi nesnesini gösteren vurgulanmış bölümler içerir. Bu yöntemle devam etmek için Uygula'yı seçin.

     

   • Alternatif olarak, Kaynak Türü altında Kubernetes İş Yükü'nü ve ardından mevcut bir Kubernetes iş yükünü seçin. Bu eylem, yeni bağlantınızın gizli dizi nesnesini seçili iş yükünün ortam değişkenleri olarak ayarlar. İş yükünü seçtikten sonra Uygula'yı seçin.

     

Uygulama kodunuzu güncelleştirme

Son adım olarak, bu yönergeleri izleyerek uygulama kodunuzu ortam değişkenlerinizi kullanacak şekilde güncelleştirin.

Kaynakları temizleme

Bu öğreticiyi takip ederken oluşturduğunuz kaynaklara artık ihtiyacınız yoksa Azure kaynak grubunu silerek bunları kaldırabilirsiniz.

komutunu kullanarak az group delete kaynak grubunuzu silin.

az group delete --resource-group $RESOURCE_GROUP

İlgili içerik

Service Connector kavramları ve AKS'nin Azure hizmetlerine bağlanmasına nasıl yardımcı olduğu hakkında daha fazla bilgi edinmek için aşağıdaki makaleleri okuyun:

• AKS kümelerini diğer bulut hizmetlerine bağlamak için Hizmet Bağlayıcısı'nı kullanma
• Hizmet Bağlayıcısı kavramları hakkında bilgi edinin