练习 - 设置 Azure 容器应用
在本单元中,你将创建一个 Azure 资源组,其中包含应用程序的资源。 然后使用 Azure CLI 设置 PostgreSQL 数据库。 最后,将 Quarkus 应用程序配置为访问远程 PostgreSQL 数据库。 在先决条件中配置的本地 Bash 环境中运行命令。 在 Windows 上,使用已配置的 WSL 2 发行版。
准备工作环境
返回到生成的 todo 项目目录中之前执行 Maven 命令时使用的 Bash shell。 如果 Quarkus 开发模式仍在运行,请在继续之前按 Ctrl+C 。 将此 shell 用于以下导出操作,并在应用程序启动、打包和部署过程中保持其处于打开状态。
使用 Azure CLI 2.87.0 或更高版本。 你需要相应的权限来创建资源组和资源并注册其资源提供程序,例如在订阅范围具有“参与者”或“所有者”权限。 订阅策略和配额可能会施加额外的限制。
使用交互式Azure CLI登录流登录到此本地 Bash 环境中的Azure,包括任何必需的多重身份验证。 将 <subscription-id> 替换为你预期的订阅 ID,然后选择并显示该订阅:
az login
az account set --subscription "<subscription-id>"
az account show --query "{name:name,id:id}" --output table
确认显示的订阅是在创建可付费资源之前要使用的订阅。 登录到 Cloud Shell 不会使您登录到单独的本地 CLI。 在继续操作之前,请成功完成每个Azure命令。
需要设置一些环境变量。 下面是有关要创建的变量的一些说明:
| 变量 | 说明 |
|---|---|
AZ_PROJECT |
具有唯一性后缀的短小写项目值。 保持变量名称不变;后缀属于其值。 |
AZ_RESOURCE_GROUP |
保存资源的资源组的名称。 |
AZ_LOCATION |
Azure 区域。 建议使用靠近你居住位置的区域。 若要查看可用区域的列表,请在命令提示符处输入 az account list-locations。 |
AZ_CONTAINERAPP |
保存容器的 Azure 容器应用实例的名称。 |
AZ_CONTAINERAPP_ENV |
Azure 容器应用环境的名称。 |
AZ_POSTGRES_SERVER_NAME |
PostgreSQL 灵活服务器的全局唯一名称。 使用由小写字母、数字和连字符组成的 3-63 个字符。 生成的 psql${AZ_PROJECT} 值遵循这些规则;如果该名称不可用,请选择其他后缀。 |
AZ_POSTGRES_DB_NAME |
应用程序数据库名称。 创建服务器后显式创建此数据库。 |
AZ_POSTGRES_USERNAME |
PostgreSQL 数据库服务器的管理员用户名。 |
AZ_POSTGRES_PASSWORD |
PostgreSQL 数据库服务器的管理员密码。 在静默提示符处输入一个安全密码。 |
注释
可以采用所需的任何方式命名 Azure 资源,但我们建议查看 azure 资源的 缩写示例。 本文提供了许多 Azure 资源的示例缩写(例如,资源组 rg,以及容器应用的 ca)。
运行以下块一次以设置变量。 选择适合订阅的区域,并输入满足 PostgreSQL 服务要求的密码。 密码提示不会显示键入的内容。
export AZ_PROJECT="quarkus-${RANDOM}${RANDOM}"
export AZ_RESOURCE_GROUP="rg${AZ_PROJECT}"
export AZ_LOCATION="eastus"
export AZ_CONTAINERAPP="ca${AZ_PROJECT}"
export AZ_CONTAINERAPP_ENV="cae${AZ_PROJECT}"
export AZ_POSTGRES_DB_NAME="postgres${AZ_PROJECT}"
export AZ_POSTGRES_SERVER_NAME="psql${AZ_PROJECT}"
export AZ_POSTGRES_USERNAME="pgadmin"
read -r -s -p "PostgreSQL administrator password: " AZ_POSTGRES_PASSWORD
printf '\n'
export AZ_POSTGRES_PASSWORD
随机后缀可减少资源名称冲突;它不能保证全局可用性。 如果 PostgreSQL 服务器名称不可用,请在创建服务器之前为 AZ_POSTGRES_SERVER_NAME 选择另一个后缀。 保持其他资源标识符不变。
本模块的其余部分都使用这些环境变量。 将它们保留在此 Bash shell 中,不要在各单元之间重新运行随机名称和密码块。 用于 HTTP 请求的独立终端不需要数据库密码。
接下来,创建一个资源组:
az group create \
--name "$AZ_RESOURCE_GROUP" \
--location "$AZ_LOCATION"
创建 Azure Database for PostgreSQL 的实例
现在,你将创建一个常规托管的 PostgreSQL 16 服务器,其中包含可突发 B1ms SKU 和 32 GiB 的高级 SSD 存储。 所选区域必须支持此版本和 SKU,并且具有可用的订阅容量。 先解决所有配额或策略错误,然后再继续。
注册 PostgreSQL 提供程序并等待注册完成:
az provider register --namespace Microsoft.DBforPostgreSQL --wait
Important
本练习暂时允许来自所有公共 IPv4 地址的数据库连接尝试。 仍需要身份验证。 使用专用于练习的新服务器和资源组,稍后完成防火墙限制设置,并在完成后删除练习资源。 此初始网络设置不建议用于生产环境。
创建 PostgreSQL 服务器:
az postgres flexible-server create \
--resource-group "$AZ_RESOURCE_GROUP" \
--location "$AZ_LOCATION" \
--name "$AZ_POSTGRES_SERVER_NAME" \
--admin-user "$AZ_POSTGRES_USERNAME" \
--admin-password="$AZ_POSTGRES_PASSWORD" \
--public-access All \
--tier Burstable \
--sku-name Standard_B1ms \
--storage-type Premium_LRS \
--storage-size 32 \
--version 16 \
--yes \
--output none
此选项 --public-access All 启用公共终结点,并创建本模块稍后使用的单个“所有地址”防火墙规则。 后续的 Azure 服务异常仍使用该公共终结点,并允许来自 Azure 资源(包括其他客户订阅)的连接尝试。 它不是私有访问,也不是仅限应用程序的访问。
服务器创建成功后,显式 创建应用程序数据库:
az postgres flexible-server db create \
--resource-group "$AZ_RESOURCE_GROUP" \
--server-name "$AZ_POSTGRES_SERVER_NAME" \
--name "$AZ_POSTGRES_DB_NAME" \
--output none
在启动应用程序之前,请验证数据库是否存在:
az postgres flexible-server db show \
--resource-group "$AZ_RESOURCE_GROUP" \
--server-name "$AZ_POSTGRES_SERVER_NAME" \
--name "$AZ_POSTGRES_DB_NAME" \
--query name \
--output tsv
返回的名称必须与值 AZ_POSTGRES_DB_NAME匹配 。 这些数据库命令使用 --server-name 表示服务器,使用 --name 表示数据库。
配置 Quarkus 以访问 PostgreSQL 数据库
获取服务器的完全限定域名(FQDN),并生成没有凭据的 JDBC URL:
export AZ_POSTGRES_HOST=$(
az postgres flexible-server show \
--resource-group "$AZ_RESOURCE_GROUP" \
--name "$AZ_POSTGRES_SERVER_NAME" \
--query fullyQualifiedDomainName \
--output tsv
)
export AZ_POSTGRES_JDBC_URL="jdbc:postgresql://${AZ_POSTGRES_HOST}:5432/${AZ_POSTGRES_DB_NAME}?sslmode=require"
此 URL 使用 sslmode=require 来强制加密传输。 用户名和密码通过数据源属性单独提供,因此不会将密码中的 & 字符分析为 URL 参数。 不要打印或跟踪凭据值。
加密不是证书身份验证。
sslmode=require 不验证服务器证书和主机名。 如果您需要该验证,请遵循 pgJDBC verify-full 指南 和 Azure 证书信任说明,包括受信任的根配置。 仅仅在不配置信任的情况下更改模式并不是完整的证书验证过程。
配置 Quarkus 应用程序以连接到 PostgreSQL 数据库
在 src/main/resources/application.properties 中,将现有的未配置数据源 URL 和架构生成条目替换为以下四行。 同时删除任何未配置数据源的用户名或密码条目。 将 ${...} 表达式文本保留在文件中;不要将它们替换为凭据值。 保持无关设置不变。
%dev,prod.quarkus.hibernate-orm.database.generation=update
%dev,prod.quarkus.datasource.jdbc.url=${AZ_POSTGRES_JDBC_URL}
%dev,prod.quarkus.datasource.username=${AZ_POSTGRES_USERNAME}
%dev,prod.quarkus.datasource.password=${AZ_POSTGRES_PASSWORD}
这些设置适用于 dev 和 prod 配置文件,不适用于自动测试。 开发模式使用此单元的Azure数据库,部署的应用程序在生产模式下使用它。 测试使用单独的 PostgreSQL 开发服务。 测试或打包应用程序时,使 Docker 保持运行。 Maven package 生命周期运行测试;它不得将测试记录添加到Azure数据库。
不要导出未配置的 QUARKUS_DATASOURCE_* 覆盖项。 如果以前在此 shell 中设置过任何这些项,请在测试或打包之前将这些项移除,因为它们会覆盖这种分离。
AZ_ 变量仅由按配置文件作用域限定的表达式解析。 有关详细信息,请参阅 Quarkus 3.18.4 配置参考。
在本地运行 Quarkus 应用程序以测试远程数据库连接
进程 在启动时继承环境变量。 在另一个终端中导出 AZ_POSTGRES_* 并不会更新已经运行的 Quarkus 进程,仅编辑 application.properties 也不足以实现此转换。
如果需要,请确保先前的开发进程已停止,方法是在其终端中按 Ctrl+C。
todo从 Bash shell 中包含导出的资源和数据库变量的目录中,启动应用程序:
./mvnw clean quarkus:dev
在 Quarkus 运行时,请在第二个本地 Bash 终端中使用以下 cURL 命令创建几个 to-dos。 使拥有该变量的 shell 继续运行 Quarkus:
curl --header "Content-Type: application/json" \
--request POST \
--data '{"description":"Take Quarkus MS Learn","details":"Take the MS Learn on deploying Quarkus to Azure Container Apps","done": "true"}' \
http://127.0.0.1:8080/api/todos
curl --header "Content-Type: application/json" \
--request POST \
--data '{"description":"Take Azure Container Apps MS Learn","details":"Take the ACA Learn module","done": "false"}' \
http://127.0.0.1:8080/api/todos
接下来,通过访问在 to-do 应用中定义的 GET 终结点,检查 to-dos 是否位于数据库中:
curl http://127.0.0.1:8080/api/todos
响应应包含提交的说明,类似于以下输出。 标识符、时间戳和顺序可能会有所不同,重复 POST 会创建另一个项目。
[
{
"id": 1,
"description": "Take Quarkus MS Learn",
"details": "Take the MS Learn on deploying Quarkus to Azure Container Apps",
"done": true,
"createdAt": "2025-02-26T08:03:28.390854Z"
},
{
"id": 2,
"description": "Take Azure Container Apps MS Learn",
"details": "Take the ACA Learn module",
"done": false,
"createdAt": "2025-02-26T08:03:34.142249Z"
}
]
如果响应包含创建的项,则已成功运行 Quarkus 应用程序并连接到远程 PostgreSQL 数据库。
在继续在下一个单元中打包之前,请返回到运行 Quarkus 的终端,然后按 Ctrl+C。 使 Bash shell 在 todo 目录中保持打开状态,所有导出的变量保持不变。 不要重新运行随机名称和密码块;使用相同的 shell 进行打包和部署。