Hızlı Başlangıç: PostgreSQL için Azure Veritabanı ve Redis için Azure Cache ile tümleştirme

Makale
12/04/2024

Not

Temel, Standart ve Kurumsal planları, 3 yıllık kullanımdan kaldırma süresiyle Mart 2025 ortasından itibaren kullanımdan kaldırılacaktır. Azure Container Apps'e geçiş yapmanızı öneririz. Daha fazla bilgi için bkz . Azure Spring Apps kullanımdan kaldırma duyurusu.

Standart tüketim ve ayrılmış plan, altı ay sonra tamamen kapatılarak 30 Eylül 2024'den itibaren kullanımdan kaldırılacaktır. Azure Container Apps'e geçiş yapmanızı öneririz. Daha fazla bilgi için bkz . Azure Spring Apps Standart tüketimini ve ayrılmış planı Azure Container Apps'e geçirme.

Bu makale şunlar için geçerlidir: ❎ Temel/Standart ✅ Kurumsal

Bu hızlı başlangıçta, Azure Spring Apps Kurumsal planında çalışan uygulamalarla kullanılacak bir PostgreSQL için Azure Veritabanı ve Redis için Azure Cache sağlama ve hazırlama adımları gösterilmektedir.

Bu makalede bu hizmetler tanıtım amacıyla kullanılır. Bu makalenin devamında yer alan Hizmet Bağlayıcıları Oluşturma bölümünde yer alan yönergelere benzer yönergeleri kullanarak uygulamanızı istediğiniz herhangi bir yedekleme hizmetine bağlayabilirsiniz.

Önkoşullar

Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
Azure Market'da Kurumsal planın Gereksinimler bölümünü anlayın ve yerine getirin.
Azure CLI sürüm 2.45.0 veya üzeri.
Git.
jq
Azure Spring Apps Kurumsal plan uzantısı. Önceki sürümleri kaldırmak ve en son Kurumsal plan uzantısını yüklemek için aşağıdaki komutu kullanın. Uzantıyı spring-cloud daha önce yüklediyseniz yapılandırma ve sürüm uyuşmazlıklarını önlemek için uzantıyı kaldırın.
```
az extension add --upgrade --name spring
az extension remove --name spring-cloud
```
Kurumsal planı kullanarak Uygulamaları derleme ve Azure Spring Apps'e dağıtma bölümünde yer alan adımları tamamlayın.

Hizmet sağlama

Uygulamaya kalıcılık eklemek için bir Redis için Azure Cache ve PostgreSQL için Azure Veritabanı Esnek Sunucu oluşturun.

Azure CLI
ARM şablonu

Aşağıdaki adımlarda, Azure CLI kullanarak bir Redis için Azure Cache örneğinin ve PostgreSQL için Azure Veritabanı Esnek Sunucunun nasıl sağlandığı açıklanmaktadır.

Not

Microsoft, kullanılabilir en güvenli kimlik doğrulama akışının kullanılmasını önerir. Veritabanları, önbellekler, mesajlaşma veya yapay zeka hizmetleri gibi bu yordamda açıklanan kimlik doğrulama akışı, uygulamaya çok yüksek düzeyde güven gerektirir ve diğer akışlarda mevcut olmayan riskler taşır. Bu akışı yalnızca parolasız veya anahtarsız bağlantılar için yönetilen kimlikler gibi daha güvenli seçenekler uygun olmadığında kullanın. Yerel makine işlemleri için parolasız veya anahtarsız bağlantılar için kullanıcı kimliklerini tercih edin.

Aşağıdaki komutları kullanarak kaynak adlarını tutmak için değişkenler oluşturun. Yer tutucuları kendi değerlerinizle değiştirmeyi unutmayın.

export REGION=<region>
export RESOURCE_GROUP=<resource-group-name>
export REDIS_CACHE_NAME=<redis-cache-name>
export POSTGRES_SERVER_NAME=<postgres-server-name>
export POSTGRES_USERNAME=<postgres-username>
export POSTGRES_PASSWORD=<postgres-password>
export AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME=<Azure-Spring-Apps-service-instance-name>

Redis için Azure Cache örneğini oluşturmak için aşağıdaki komutu kullanın:

az redis create \
    --resource-group ${RESOURCE_GROUP} \
    --name ${REDIS_CACHE_NAME} \
    --location ${REGION} \
    --sku Basic \
    --vm-size c0

Not

Redis Cache oluşturma işlemi yaklaşık 20 dakika sürer.

PostgreSQL için Azure Veritabanı Esnek Sunucu örneği oluşturmak için aşağıdaki komutu kullanın:

Not

Microsoft, kullanılabilir en güvenli kimlik doğrulama akışının kullanılmasını önerir. Veritabanları, önbellekler, mesajlaşma veya yapay zeka hizmetleri gibi bu yordamda açıklanan kimlik doğrulama akışı, uygulamaya çok yüksek düzeyde güven gerektirir ve diğer akışlarda mevcut olmayan riskler taşır. Bu akışı yalnızca parolasız veya anahtarsız bağlantılar için yönetilen kimlikler gibi daha güvenli seçenekler uygun olmadığında kullanın. Yerel makine işlemleri için parolasız veya anahtarsız bağlantılar için kullanıcı kimliklerini tercih edin.
```
az postgres flexible-server create \
    --resource-group ${RESOURCE_GROUP} \
    --name ${POSTGRES_SERVER_NAME} \
    --location ${REGION} \
    --admin-user ${POSTGRES_USERNAME} \
    --admin-password ${POSTGRES_PASSWORD} \
    --yes
```

Diğer Azure Hizmetleri'nden yeni oluşturulan Esnek Sunucuya bağlantılara izin vermek için aşağıdaki komutu kullanın:

az postgres flexible-server firewall-rule create \
    --rule-name allAzureIPs \
    --name ${POSTGRES_SERVER_NAME} \
    --resource-group ${RESOURCE_GROUP} \
    --start-ip-address 0.0.0.0 \
    --end-ip-address 0.0.0.0

Yeni oluşturulan Esnek Sunucu uzantısını uuid-ossp etkinleştirmek için aşağıdaki komutu kullanın:

az postgres flexible-server parameter set \
    --resource-group ${RESOURCE_GROUP} \
    --name azure.extensions \
    --value uuid-ossp \
    --server-name ${POSTGRES_SERVER_NAME}

Sipariş Hizmeti uygulaması için bir veritabanı oluşturmak için aşağıdaki komutu kullanın:

az postgres flexible-server db create \
    --resource-group ${RESOURCE_GROUP} \
    --server-name ${POSTGRES_SERVER_NAME} \
    --database-name acmefit_order

Katalog Hizmeti uygulaması için bir veritabanı oluşturmak için aşağıdaki komutu kullanın:

az postgres flexible-server db create \
    --resource-group ${RESOURCE_GROUP} \
    --server-name ${POSTGRES_SERVER_NAME} \
    --database-name acmefit_catalog

Hizmet Bağlayıcıları Oluşturma

Aşağıdaki adımlarda, Hizmet Bağlayıcıları'nı kullanarak Azure Spring Apps Kurumsal planında çalışan uygulamaların diğer Azure hizmetlerine nasıl bağlandığı gösterilmektedir.

Sipariş Hizmeti uygulaması için PostgreSQL için Azure Veritabanı bir hizmet bağlayıcısı oluşturmak için aşağıdaki komutu kullanın:

Not

Microsoft, kullanılabilir en güvenli kimlik doğrulama akışının kullanılmasını önerir. Veritabanları, önbellekler, mesajlaşma veya yapay zeka hizmetleri gibi bu yordamda açıklanan kimlik doğrulama akışı, uygulamaya çok yüksek düzeyde güven gerektirir ve diğer akışlarda mevcut olmayan riskler taşır. Bu akışı yalnızca parolasız veya anahtarsız bağlantılar için yönetilen kimlikler gibi daha güvenli seçenekler uygun olmadığında kullanın. Yerel makine işlemleri için parolasız veya anahtarsız bağlantılar için kullanıcı kimliklerini tercih edin.
```
az spring connection create postgres-flexible \
    --resource-group ${RESOURCE_GROUP} \
    --target-resource-group ${RESOURCE_GROUP} \
    --connection order_service_db \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --app order-service \
    --deployment default \
    --server ${POSTGRES_SERVER_NAME} \
    --database acmefit_order \
    --secret name=${POSTGRES_USERNAME} secret=${POSTGRES_PASSWORD} \
    --client-type dotnet
```
Katalog Hizmeti uygulaması için PostgreSQL için Azure Veritabanı bir hizmet bağlayıcısı oluşturmak için aşağıdaki komutu kullanın:

Not

Microsoft, kullanılabilir en güvenli kimlik doğrulama akışının kullanılmasını önerir. Veritabanları, önbellekler, mesajlaşma veya yapay zeka hizmetleri gibi bu yordamda açıklanan kimlik doğrulama akışı, uygulamaya çok yüksek düzeyde güven gerektirir ve diğer akışlarda mevcut olmayan riskler taşır. Bu akışı yalnızca parolasız veya anahtarsız bağlantılar için yönetilen kimlikler gibi daha güvenli seçenekler uygun olmadığında kullanın. Yerel makine işlemleri için parolasız veya anahtarsız bağlantılar için kullanıcı kimliklerini tercih edin.
```
az spring connection create postgres-flexible \
    --resource-group ${RESOURCE_GROUP} \
    --target-resource-group ${RESOURCE_GROUP} \
    --connection catalog_service_db \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --app catalog-service \
    --deployment default \
    --server ${POSTGRES_SERVER_NAME} \
    --database acmefit_catalog \
    --secret name=${POSTGRES_USERNAME} secret=${POSTGRES_PASSWORD} \
    --client-type springboot
```

Sepet Hizmeti uygulaması için Redis için Azure Cache bir hizmet bağlayıcısı oluşturmak için aşağıdaki komutu kullanın:

az spring connection create redis \
    --resource-group ${RESOURCE_GROUP} \
    --target-resource-group ${RESOURCE_GROUP} \
    --connection cart_service_cache \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --app cart-service \
    --deployment default \
    --server ${REDIS_CACHE_NAME} \
    --database 0 \
    --client-type java

Katalog Hizmeti uygulamasını yeni bağlantı özelliklerini yüklemek üzere yeniden yüklemek için aşağıdaki komutu kullanın:

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --name catalog-service \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME}

Veritabanı bağlantı bilgilerini almak için aşağıdaki komutu kullanın:

export POSTGRES_CONNECTION_STR=$(az spring connection show \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --deployment default \
    --connection order_service_db \
    --app order-service \
    | jq '.configurations[0].value' -r)

Not

Nofsql 6.0 ile ssl doğrulama özel durumu alırsanız SSL modunu Require VerifyFullolarak değiştirdiğinizden emin olun. Daha fazla bilgi için bkz . Npgsql 6.0 Sürüm Notları.

Sipariş Hizmeti uygulamasını güncelleştirmek için aşağıdaki komutu kullanın:

Not

Microsoft, kullanılabilir en güvenli kimlik doğrulama akışının kullanılmasını önerir. Veritabanları, önbellekler, mesajlaşma veya yapay zeka hizmetleri gibi bu yordamda açıklanan kimlik doğrulama akışı, uygulamaya çok yüksek düzeyde güven gerektirir ve diğer akışlarda mevcut olmayan riskler taşır. Bu akışı yalnızca parolasız veya anahtarsız bağlantılar için yönetilen kimlikler gibi daha güvenli seçenekler uygun olmadığında kullanın. Yerel makine işlemleri için parolasız veya anahtarsız bağlantılar için kullanıcı kimliklerini tercih edin.
```
az spring app update \
    --resource-group ${RESOURCE_GROUP} \
    --name order-service \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --env "DatabaseProvider=Postgres" "ConnectionStrings__OrderContext=${POSTGRES_CONNECTION_STR}"
```
Redis bağlantı bilgilerini almak ve Cart Service uygulamasını güncelleştirmek için aşağıdaki komutları kullanın:

Not

Microsoft, kullanılabilir en güvenli kimlik doğrulama akışının kullanılmasını önerir. Veritabanları, önbellekler, mesajlaşma veya yapay zeka hizmetleri gibi bu yordamda açıklanan kimlik doğrulama akışı, uygulamaya çok yüksek düzeyde güven gerektirir ve diğer akışlarda mevcut olmayan riskler taşır. Bu akışı yalnızca parolasız veya anahtarsız bağlantılar için yönetilen kimlikler gibi daha güvenli seçenekler uygun olmadığında kullanın. Yerel makine işlemleri için parolasız veya anahtarsız bağlantılar için kullanıcı kimliklerini tercih edin.
```
export REDIS_CONN_STR=$(az spring connection show \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --deployment default \
    --app cart-service \
    --connection cart_service_cache | jq -r '.configurations[0].value')

export GATEWAY_URL=$(az spring gateway show \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} | jq -r '.properties.url')

az spring app update \
    --resource-group ${RESOURCE_GROUP} \
    --name cart-service \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --env "CART_PORT=8080" "REDIS_CONNECTIONSTRING=${REDIS_CONN_STR}" "AUTH_URL=https://${GATEWAY_URL}"
```

Uygulamaya erişme

Spring Cloud Gateway URL'sini alın ve güncelleştirilmiş uygulamayı keşfedin. Uygulamayı keşfetmek için aşağıdaki komutun çıkışını kullanabilirsiniz:

export GATEWAY_URL=$(az spring gateway show \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} | jq -r '.properties.url')

echo "https://${GATEWAY_URL}"

Kaynakları temizleme

Sonraki hızlı başlangıçlar ve öğreticilerle çalışmaya devam etmek istiyorsanız, bu kaynakları yerinde bırakmak isteyebilirsiniz. Artık gerekli olmadığında kaynak grubunu silin; bu da kaynak grubundaki kaynakları siler. Azure CLI kullanarak kaynak grubunu silmek için aşağıdaki komutları kullanın:

echo "Enter the Resource Group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."

Sonraki adımlar

Aşağıdaki isteğe bağlı hızlı başlangıçlardan herhangi birine geçin:

Aracılığıyla paylaş