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

Hinweis

Azure Spring Apps ist der neue Name für den Azure Spring Cloud-Dienst. Obwohl der Dienst umbenannt wurde, wird der alte Name noch an einigen Stellen verwendet, solange wir Ressourcen wie Screenshots, Videos und Diagramme aktualisieren.

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

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.

1. 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>
   

2. 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.

3. 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
   

4. 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
   

5. 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}
   

6. 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
   

7. 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
   

ARM-Vorlage

In den folgenden Anweisungen wird beschrieben, wie Sie einen Azure Cache for Redis und einen flexiblen Azure Database for PostgreSQL-Server mithilfe einer Azure Resource Manager-Vorlage (ARM-Vorlage) bereitstellen.

Eine Azure Resource Manager-Vorlage ist eine JSON (JavaScript Object Notation)-Datei, welche die Infrastruktur und die Konfiguration für Ihr Projekt definiert. Die Vorlage verwendet eine deklarative Syntax. Sie beschreiben Ihre geplante Bereitstellung, ohne die Abfolge der Programmierbefehle zum Erstellen der Bereitstellung zu schreiben.

Sie finden die in dieser Schnellstartanleitung verwendete Vorlage im GitHub-Repository „fitness store sample“ (Beispiel für den Fitness Store).

Führen Sie diese Schritte aus, um die Vorlage bereitzustellen:

1. Klicken Sie auf das folgende Bild, um sich bei Azure anzumelden und eine Vorlage zu öffnen. Die Vorlage erstellt einen Azure Cache for Redis und einen flexiblen Azure Database for PostgreSQL-Server.

   

2. Geben Sie Werte für die folgenden Felder ein:

   • Ressourcengruppe: Wählen Sie die Option Neu erstellen aus, geben Sie einen eindeutigen Namen für die Ressourcengruppe ein, und wählen Sie dann OK aus.
   • cacheName: Geben Sie den Namen für den Azure Cache for Redis-Server ein.
   • dbServerName: Geben Sie den Namen für den flexiblen Azure Database for PostgreSQL-Server ein.
   • administratorLogin: Geben Sie den Benutzernamen des Administrators für den flexiblen Azure Database for PostgreSQL-Server ein.
   • administratorLoginPassword: Geben Sie das Kennwort des Administrators für den flexiblen Azure Database for PostgreSQL-Server ein.
   • tags: Geben Sie benutzerdefinierte Tags ein.

3. Wählen Sie Überprüfen + erstellen und danach Erstellen aus.

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.

1. 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
   

2. 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
   

3. 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
   

4. 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}
   

5. 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.

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

7. 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:

• Konfigurieren von einmaligem Anmelden
• Laden von Anwendungsgeheimnissen mithilfe von Key Vault
• End-to-End-Überwachung von Anwendungen
• Festlegen von Grenzwerten für Anforderungsraten
• Automatisieren von Bereitstellungen
• Integrieren von Azure OpenAI