Schnellstart: Integrieren in Azure Database for PostgreSQL und Azure Cache for Redis

Artikel
10/03/2024

Hinweis

Die Pläne Basic, Standard und Enterprise gelten ab Mitte März 2025 als veraltet und werden über einen Zeitraum von drei (3) Jahren eingestellt. Es wird empfohlen, auf Azure Container Apps umzustellen. Weitere Informationen finden Sie in der Ankündigung zur Einstellung von Azure Spring Apps.

Der Plan Standardverbrauch und dediziert gilt ab dem 30. September 2024 als veraltet und wird nach sechs Monaten vollständig eingestellt. Es wird empfohlen, auf Azure Container Apps umzustellen. Weitere Informationen finden Sie unter Migrieren des Plans „Standardverbrauch und dediziert“ von Azure Spring Apps zu Azure Container Apps.

Dieser Artikel gilt für:❌ Basic/Standard ✔️ Enterprise

In dieser Schnellstartanleitung wird gezeigt, wie Sie eine Azure Database for PostgreSQL und einen Azure Cache for Redis bereitstellen und vorbereiten, damit sie von Apps verwendet werden können, die im Enterprise-Plan von Azure Spring Apps ausgeführt werden.

In diesem Artikel werden diese Dienste zu Demonstrationszwecken verwendet. Sie können Ihre Anwendung mit einem beliebigen Unterstützungsdienst Ihrer Wahl verbinden, indem Sie Anweisungen wie die im Abschnitt Erstellen von Dienstconnectors weiter unten in diesem Artikel beschriebenen verwenden.

Voraussetzungen

Ein Azure-Konto mit einem aktiven Abonnement. Sie können kostenlos ein Konto erstellen.
Verstehen und Erfüllen des Abschnitts Anforderungen des Enterprise-Plans in Azure Marketplace.
Die Azure CLI Version 2.45.0 oder höher.
Git.
jq
Die Erweiterung des Azure Spring Apps Enterprise-Plans. Verwenden Sie den folgenden Befehl, um frühere Versionen zu entfernen und die neueste Erweiterung des Enterprise-Plans zu installieren. Wenn Sie zuvor die spring-cloud-Erweiterung installiert hatten, deinstallieren Sie diese Erweiterung, um Konfigurations- und Versionskonflikte zu vermeiden.
```
az extension add --upgrade --name spring
az extension remove --name spring-cloud
```
Führen Sie die unter Erstellen und Bereitstellen von Apps in Azure Spring Apps mithilfe des Enterprise-Plans beschriebenen Schritte aus.

Bereitstellen von Diensten

Zum Hinzufügen von Persistenz zur Anwendung erstellen Sie einen Azure Cache for Redis und einen flexiblen Azure Database for PostgreSQL-Server.

Azure-Befehlszeilenschnittstelle
ARM-Vorlage

In den folgenden Schritten wird beschrieben, wie Sie eine Azure Cache for Redis-Instanz und einen flexiblen Azure Database for PostgreSQL-Server mithilfe der Azure CLI bereitstellen.

Erstellen Sie Variablen zur Aufnahme der Ressourcennamen, indem Sie die folgenden Befehle verwenden. Ersetzen Sie die Platzhalter durch Ihre eigenen Werte.

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>

Verwenden Sie den folgenden Befehl, um eine Instanz von Azure Cache for Redis zu erstellen:

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

Hinweis

Die Erstellung des Redis Cache dauert ca. 20 Minuten.

Verwenden Sie den folgenden Befehl, um eine flexible Azure Database for PostgreSQL-Serverinstanz zu erstellen:

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

Verwenden Sie den folgenden Befehl, um Verbindungen von anderen Azure-Diensten mit dem neu erstellten flexiblen Server zuzulassen:

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

Verwenden Sie den folgenden Befehl, um die uuid-ossp-Erweiterung für den neu erstellten flexiblen Server zu aktivieren:

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

Verwenden Sie den folgenden Befehl, um eine Datenbank für die Bestelldienstanwendung (Order Service) zu erstellen:

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

Verwenden Sie den folgenden Befehl, um eine Datenbank für die Katalogdienstanwendung (Catalog Service) zu erstellen:

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

Erstellen von Dienstconnectors

Die folgenden Schritte zeigen, wie Sie Anwendungen, die im Enterprise-Plan von Azure Spring Apps ausgeführt werden, an andere Azure-Dienste binden, indem Sie dazu Dienstconnectors verwenden.

Verwenden Sie den folgenden Befehl, um einen Dienstconnector zu Azure Database for PostgreSQL für die Bestelldienstanwendung zu erstellen:

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

Verwenden Sie den folgenden Befehl, um einen Dienstconnector zu Azure Database for PostgreSQL für die Katalogdienstanwendung zu erstellen:

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

Verwenden Sie den folgenden Befehl, um einen Dienstconnector zu Azure Cache for Redis für die Warenkorbdienstanwendung (Cart Service) zu erstellen:

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

Verwenden Sie den folgenden Befehl, um die Katalogdienstanwendung neu zu laden, damit die neuen Verbindungseigenschaften geladen werden:

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

Verwenden Sie den folgenden Befehl, um die Datenbankverbindungsinformationen abzurufen:
```
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)
```
Hinweis

Wenn Sie eine SSL-Überprüfungs-Ausnahme mit „Nofsql 6.0“ erhalten, stellen Sie sicher, dass Sie den SSL-Modus von Require zu VerifyFulländern. Weitere Informationen finden Sie in den Versionshinweisen zu Npgsql 6.0.

Verwenden Sie den folgenden Befehl, um die Bestelldienstanwendung (Order Service) zu aktualisieren:

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

Verwenden Sie die folgenden Befehle, um die Redis-Verbindungsinformationen abzurufen und die Warenkorbdienstanwendung zu aktualisieren:

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

Zugreifen auf die Anwendung

Rufen Sie die URL für das Spring Cloud-Gateway ab, und erkunden Sie die aktualisierte Anwendung. Sie können die Ausgabe des folgenden Befehls verwenden, um die Anwendung zu erkunden:

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

Bereinigen von Ressourcen

Falls Sie mit weiteren Schnellstartanleitungen und Tutorials fortfahren möchten, sollten Sie die Ressourcen nicht bereinigen. Wenn Sie die Ressourcen nicht mehr benötigen, löschen Sie die Ressourcengruppe. Dadurch werden die Ressourcen in der Ressourcengruppe gelöscht. Wenn Sie die Ressourcengruppe mithilfe der Azure CLI löschen möchten, verwenden Sie die folgenden Befehle:

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

Nächste Schritte

Fahren Sie mit einer der folgenden optionalen Schnellstartanleitungen fort:

Freigeben über