快速入門：與 適用於 PostgreSQL 的 Azure 資料庫 和 Azure Cache for Redis 整合

注意

Azure Spring Apps 是 Azure Spring Cloud 服務的新名稱。 雖然服務有新的名稱，但是您暫時還是會在某些位置看到舊的名稱。我們正在致力更新螢幕擷取畫面、影片和圖表等資產。

本文適用於：❌ 基本/標準✔️企業

本快速入門說明如何布建和準備 適用於 PostgreSQL 的 Azure 資料庫 和 Azure Cache for Redis，以搭配在 Azure Spring Apps Enterprise 方案中執行的應用程式使用。

本文會使用這些服務進行示範。 您可以使用本文稍後的建立服務 連線 ors 一節中的指示，將應用程式連線到您選擇的任何備份服務。

必要條件

• 具有有效訂用帳戶的 Azure 帳戶。 免費建立帳戶。
• 了解並滿足 Azure Marketplace 中企業方案的需求一節。
• Azure CLI 2.45.0 版或更高版本。
• Git。
• jq
• Azure Spring Apps 企業版方案延伸模組。 使用下列命令來移除舊版並安裝最新的 Enterprise 方案擴充功能。 如果您先前已安裝擴充 spring-cloud 功能，請將其卸載，以避免設定和版本不符。

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

• 使用企業方案，完成建置和部署應用程式至 Azure Spring Apps 中的步驟。

布建服務

若要將持續性新增至應用程式，請建立 Azure Cache for Redis 和 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器。

Azure CLI

下列步驟說明如何使用 Azure CLI 布建 Azure Cache for Redis 實例和 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器。

1. 使用下列命令建立變數來保存資源名稱。 請務必將佔位元取代為您自己的值。

   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. 使用下列命令建立 Azure Cache for Redis 的實例：

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

   注意

   Redis 快取建立大約需要 20 分鐘。

3. 使用下列命令來建立 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器實例：

   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. 使用下列命令允許從其他 Azure 服務連線到新建立的彈性伺服器：

   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. 使用下列命令為新建立的彈性伺服器開啟 uuid-ossp 擴充功能：

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

6. 使用下列命令建立 Order Service 應用程式的資料庫：

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

7. 使用下列指令建立目錄服務應用程式的資料庫：

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

ARM 範本

下列指示說明如何使用 Azure Resource Manager 範本（ARM 範本）布建 Azure Cache for Redis 和 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器。

Azure Resource Manager 範本是 JavaScript 物件表示法 （JSON） 檔案，可定義專案的基礎結構和組態。 範本使用宣告式語法。 您不需要撰寫程式設計命令順序來建立部署，即可描述預定的部署。

您可以在健身存放區範例 GitHub 存放庫中找到本快速入門中使用的範本。

若要部署此範本，請遵循下列步驟：

1. 選取以下影像來登入 Azure 並開啟範本。 此範本會建立 Azure Cache for Redis 和 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器。

   

2. 輸入下列欄位的值：

   • 資源群組：選取 [新建]，輸入資源群組的唯一名稱，然後選取 [確定]。
   • cacheName： 輸入 Azure Cache for Redis 伺服器的名稱。
   • dbServerName：輸入 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器的名稱。
   • administratorLogin：輸入 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器的系統管理員用戶名稱。
   • administratorLoginPassword：輸入 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器的系統管理員密碼。
   • 標籤： 輸入任何自訂標籤。

3. 選取 [檢閱 + 建立]，然後選取 [建立]。

建立服務 連線器

下列步驟示範如何使用 Service 連線 ors，將 Azure Spring Apps Enterprise 方案中執行的應用程式系結至其他 Azure 服務。

1. 使用下列命令建立服務連接器，以 適用於 PostgreSQL 的 Azure 資料庫 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
   

2. 使用下列命令建立服務連接器，以 適用於 PostgreSQL 的 Azure 資料庫 目錄服務應用程式：

   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. 使用下列命令，為購物車服務應用程式建立 Azure Cache for Redis 的服務連接器：

   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. 使用下列命令重載目錄服務應用程式以載入新的連線屬性：

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

5. 使用下列命令來擷取資料庫連接資訊：

   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)
   

   注意

   如果您收到 Nofsql 6.0 的 SSL 驗證例外狀況，請務必將 SSL 模式從 Require 變更為 VerifyFull。 如需詳細資訊，請參閱 Npgsql 6.0 版本資訊。

6. 使用下列命令來更新 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}"
   

7. 使用下列命令來擷取 Redis 連線資訊並更新 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}"
   

存取應用程式

擷取 Spring Cloud Gateway 的 URL，並探索更新的應用程式。 您可以使用下列命令的輸出來探索應用程式：

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

清除資源

如果您打算繼續進行後續的快速入門和教學課程，您可以讓這些資源留在原處。 如果不再需要，請刪除資源群組，這會刪除資源群組中的資源。 若要使用 Azure CLI 刪除資源群組，請使用下列命令：

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

下一步

繼續進行下列任一選擇性快速入門：

• 設定單一登入
• 使用 金鑰保存庫 載入應用程式秘密
• 監視應用程式端對端
• 設定要求速率限制
• 自動化部署
• 整合 Azure OpenAI