Démarrage rapide : Intégrer à Azure Database pour PostgreSQL et Azure Cache pour Redis

Article
10/04/2024

Remarque

Les plans Essentiel, Standard et Entreprise seront déconseillés à partir de la mi-mars 2025, avec une période de mise hors service de 3 ans. Nous vous recommandons de passer à Azure Container Apps. Pour plus d’informations, consultez l’annonce de la mise hors service d’Azure Spring Apps.

Le plan de consommation Standard et dédié sera déconseillé à partir du 30 septembre 2024, avec un arrêt complet au bout de six mois. Nous vous recommandons de passer à Azure Container Apps. Pour plus d’informations, consultez Migrer le plan de consommation Standard et dédié Azure Spring Apps vers Azure Container Apps.

Cet article s’applique à :❌ De base/Standard ✔️ Enterprise

Ce démarrage rapide montre comment approvisionner et préparer Azure Database pour PostgreSQL et Azure Cache pour Redis en vue d’une utilisation avec des applications s’exécutant dans le plan Enterprise d’Azure Spring Apps.

Cet article utilise ces services à des fins de démonstration. Vous pouvez connecter votre application à n’importe quel service de soutien de votre choix en suivant des instructions similaires à celles de la section Créer des connecteurs de service plus loin dans cet article.

Prérequis

Compte Azure avec un abonnement actif. Créez un compte gratuitement.
Comprendre la section Exigences du plan niveau Enterprise dans la place de marché Azure et y répondre.
Azure CLI version 2.45.0 ou ultérieure.
Git.
jq
L’extension de plan Enterprise d’Azure Spring Apps. Utilisez la commande suivante pour supprimer les versions précédentes et installer l’extension de plan Enterprise la plus récente. Si vous avez déjà installé l’extension spring-cloud, désinstallez-la pour éviter les incompatibilités de configuration et de version.
```
az extension add --upgrade --name spring
az extension remove --name spring-cloud
```
Effectuez les étapes indiquées dans Créer et déployer des applications sur Azure Spring Apps à l’aide du plan Enterprise.

Configurer des services

Pour ajouter la persistance à l’application, créez un Azure Cache pour Redis et un serveur flexible Azure Database pour PostgreSQL.

Azure CLI
Modèle ARM

Les étapes suivantes décrivent comment provisionner une instance d’Azure Cache pour Redis et un serveur flexible Azure Database pour PostgreSQL à l’aide d’Azure CLI.

Créez des variables destinées à contenir les noms de ressources à l’aide des commandes suivantes. Veillez à remplacer les espaces réservés par vos valeurs.

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>

Utilisez la commande suivante pour créer une instance d’Azure Cache pour Redis :

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

Notes

La création du Cache Redis prend environ 20 minutes.

Utilisez la commande suivante pour créer une instance de serveur flexible Azure Database pour PostgreSQL :

az postgres flexible-server create \
    --resource-group ${RESOURCE_GROUP} \
    --name ${POSTGRES_SERVER_NAME} \
    --location ${REGION} \
    --admin-user ${POSTGRES_USERNAME} \
    --admin-password ${POSTGRES_PASSWORD} \
    --yes

Utilisez la commande suivante pour autoriser les connexions d’autres services Azure au nouveau serveur flexible :

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

Utilisez la commande suivante pour activer l’extension uuid-ossp pour le nouveau serveur flexible :

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

Utilisez la commande suivante pour créer une base de données pour l’application Order Service :

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

Utilisez la commande suivante pour créer une base de données pour l’application Catalog Service :

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

Créer des connecteurs de service

Les étapes suivantes montrent comment lier des applications s’exécutant dans le plan Enterprise d’Azure Spring Apps à d’autres services Azure à l’aide de connecteurs de service.

Utilisez la commande suivante pour créer un connecteur de service pour Azure Database pour PostgreSQL pour l’application Order Service :

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

Utilisez la commande suivante pour créer un connecteur de service pour Azure Database pour PostgreSQL pour l’application Catalog Service :

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

Utilisez la commande suivante pour créer un connecteur de service pour Azure Cache pour Redis pour l’application Cart Service :

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

Utilisez la commande suivante pour recharger l’application Catalog Service afin de charger les nouvelles propriétés de connexion :

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

Utilisez la commande suivante pour récupérer les informations de connexion de base de données :
```
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)
```
Notes

Si vous obtenez une exception de vérification SSL avec Nofsql 6.0, assurez-vous de remplacer le mode SSL Require par VerifyFull. Pour plus d’informations, consultez les notes de publication sur Npgsql 6.0.

Utilisez la commande suivante pour mettre à jour l’application Order Service :

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}"

Utilisez les commandes suivantes pour récupérer les informations de connexion Redis et mettre à jour l’application Cart Service :

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}"

Accéder à l’application

Récupérez l’URL de Spring Cloud Gateway et explorez l’application mise à jour. Vous pouvez utiliser la sortie de la commande suivante pour explorer l’application :

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}"

Nettoyer les ressources

Si vous prévoyez d’utiliser d’autres guides de démarrage rapide et tutoriels, vous pouvez conserver ces ressources. Quand vous n’en avez plus besoin, supprimez le groupe de ressources, ce qui supprime également les ressources qu’il contient. Pour supprimer le groupe de ressources à l’aide d’Azure CLI, utilisez les commandes suivantes :

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

Étapes suivantes

Passez à l’un des guides de démarrage rapide facultatifs suivants :

Partager via