Snabbstart: Integrera med Azure Database for PostgreSQL och Azure Cache for Redis

Kommentar

Basic-, Standard- och Enterprise-planerna kommer att vara inaktuella från och med mitten av mars 2025, med en 3-årig pensionsperiod. Vi rekommenderar att du övergår till Azure Container Apps. Mer information finns i meddelandet om azure Spring Apps-pensionering.

Standardförbrukningen och den dedikerade planen kommer att vara inaktuell från och med den 30 september 2024, med en fullständig avstängning efter sex månader. Vi rekommenderar att du övergår till Azure Container Apps. Mer information finns i Migrera Azure Spring Apps Standard-förbrukning och dedikerad plan till Azure Container Apps.

Den här artikeln gäller för:❌ Basic/Standard ✔️ Enterprise

Den här snabbstarten visar hur du etablerar och förbereder en Azure Database for PostgreSQL och en Azure Cache for Redis som ska användas med appar som körs i Azure Spring Apps Enterprise-planen.

Den här artikeln använder dessa tjänster i demonstrationssyfte. Du kan ansluta ditt program till valfri säkerhetskopieringstjänst genom att använda instruktioner som liknar dem i avsnittet Skapa tjänstanslutningsprogram senare i den här artikeln.

Förutsättningar

• Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.
• Förstå och uppfylla avsnittet Krav i Enterprise-plan på Azure Marketplace.
• Azure CLI version 2.45.0 eller senare.
• Git.
• jq
• Azure Spring Apps Enterprise-plantillägget. Använd följande kommando för att ta bort tidigare versioner och installera det senaste Enterprise-plantillägget. Om du tidigare har installerat spring-cloud tillägget avinstallerar du det för att undvika konfigurations- och versionsmatchningar.

  az extension add --upgrade --name spring
  az extension remove --name spring-cloud
  

• Slutför stegen i Skapa och distribuera appar till Azure Spring Apps med hjälp av Enterprise-planen.

Etablera tjänster

Om du vill lägga till beständighet i programmet skapar du en Azure Cache for Redis och en flexibel Azure Database for PostgreSQL-server.

Azure CLI

Följande steg beskriver hur du etablerar en Azure Cache for Redis-instans och en flexibel Azure Database for PostgreSQL-server med hjälp av Azure CLI.

1. Skapa variabler för att lagra resursnamnen med hjälp av följande kommandon. Se till att ersätta platshållarna med dina egna värden.

   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. Använd följande kommando för att skapa en instans av Azure Cache for Redis:

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

   Kommentar

   Det tar cirka 20 minuter att skapa Redis Cache.

3. Använd följande kommando för att skapa en Azure Database for PostgreSQL – flexibel serverinstans:

   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. Använd följande kommando för att tillåta anslutningar från andra Azure-tjänster till den nyligen skapade flexibla servern:

   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. Använd följande kommando för att aktivera uuid-ossp tillägget för den nyligen skapade flexibla servern:

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

6. Använd följande kommando för att skapa en databas för ordertjänstprogrammet:

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

7. Använd följande kommando för att skapa en databas för katalogtjänstprogrammet:

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

ARM-mall

Följande instruktioner beskriver hur du etablerar en Azure Cache for Redis och en flexibel Azure Database for PostgreSQL-server med hjälp av en Azure Resource Manager-mall (ARM-mall).

En Azure Resource Manager-mall är en JSON-fil (JavaScript Object Notation) som definierar infrastrukturen och konfigurationen för projektet. Mallen använder deklarativ syntax. Du beskriver den avsedda distributionen utan att skriva sekvensen med programmeringskommandon för att skapa distributionen.

Du hittar mallen som används i den här snabbstarten i GitHub-exempellagringsplatsen för fitnessbutiken.

Följ dessa steg för att distribuera den här mallen:

1. Välj följande bild för att logga in på Azure och öppna en mall. Mallen skapar en Azure Cache for Redis och en flexibel Azure Database for PostgreSQL-server.

   

2. Ange värden för följande fält:

   • Resursgrupp: Välj Skapa ny, ange ett unikt namn för resursgruppen och välj sedan OK.
   • cacheName: Ange namnet på Azure Cache for Redis Server.
   • dbServerName: Ange namnet på Azure Database for PostgreSQL – flexibel server.
   • administratorLogin: Ange administratörsanvändarnamnet för Azure Database for PostgreSQL – flexibel server.
   • administratorLoginPassword: Ange administratörslösenordet för Azure Database for PostgreSQL – flexibel server.
   • taggar: Ange anpassade taggar.

3. Välj Granska och skapa och sedan Skapa.

Skapa tjänstanslutningsprogram

Följande steg visar hur du binder program som körs i Azure Spring Apps Enterprise-planen till andra Azure-tjänster med hjälp av Service Connectors.

1. Använd följande kommando för att skapa en tjänstanslutning till Azure Database for PostgreSQL för ordertjänstprogrammet:

   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. Använd följande kommando för att skapa en tjänstanslutning till Azure Database for PostgreSQL för katalogtjänstprogrammet:

   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. Använd följande kommando för att skapa en tjänstanslutning till Azure Cache for Redis för cart service-programmet:

   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. Använd följande kommando för att läsa in katalogtjänstprogrammet igen för att läsa in de nya anslutningsegenskaperna:

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

5. Använd följande kommando för att hämta information om databasanslutningen:

   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)
   

   Kommentar

   Om du får ett SSL-verifieringsfel med Nofsql 6.0 måste du ändra SSL-läget från Require till VerifyFull. Mer information finns i Viktig information om Npgsql 6.0.

6. Använd följande kommando för att uppdatera ordertjänstprogrammet:

   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. Använd följande kommandon för att hämta Redis-anslutningsinformation och uppdatera Cart Service-programmet:

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

Få åtkomst till programmet

Hämta URL:en för Spring Cloud Gateway och utforska det uppdaterade programmet. Du kan använda utdata från följande kommando för att utforska programmet:

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

Rensa resurser

Om du planerar att fortsätta arbeta med efterföljande snabbstarter och självstudier kanske du vill lämna dessa resurser på plats. Ta bort resursgruppen när den inte längre behövs, vilket tar bort resurserna i resursgruppen. Om du vill ta bort resursgruppen med hjälp av Azure CLI använder du följande kommandon:

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

Nästa steg

Fortsätt till någon av följande valfria snabbstarter:

• Konfigurera enkel inloggning
• Läsa in programhemligheter med Hjälp av Key Vault
• Övervaka program från slutpunkt till slutpunkt
• Ange hastighetsgränser för begäranden
• Automatisera distributioner
• Integrera Azure OpenAI