你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

教程：使用服务连接器将应用程序部署到 Azure Spring Apps 并将其连接到 Azure Database for MySQL 灵活服务器

项目
10/17/2024

在本教程中，你将使用 Azure 门户或 Azure CLI 完成以下任务。以下过程介绍了这两种方法。

预配 Azure Spring Apps 的实例
生成应用并将其部署到 Azure Spring Apps
使用服务连接器将 Azure Spring Apps 与 Azure Database for MySQL 集成

警告

Microsoft 建议使用最安全的可用身份验证流。本过程中介绍的身份验证流程需要非常高的信任度，并携带其他流中不存在的风险。请仅在无法使用其他更安全的流（例如托管标识）时才使用此流。

先决条件

安装 JDK 8 或 JDK 11
注册 Azure 订阅
安装 Azure CLI 版本 2.0.67 或更高版本，并使用以下命令安装 Azure Spring Apps 扩展：az extension add --name spring

预配 Azure Spring Apps 的实例

以下过程使用 Azure CLI 扩展来预配 Azure Spring Apps 的实例。

使用 Azure Spring Apps 扩展更新 Azure CLI。
```
az extension update --name spring
```

登录到 Azure CLI 并选择你的有效订阅。

az login
az account list -o table
az account set --subscription <Name or ID of subscription, skip if you only have 1 subscription>

创建可包含应用和 Azure Spring Apps 服务实例的资源组。

az group create --name ServiceConnector-tutorial-mysqlf --location eastus

创建 Azure Spring Apps 的实例。其名称必须为 4 到 32 个字符，只能包含小写字母、数字及连字符。 Azure Spring Apps 实例名称的第一个字符必须是字母，最后一个字符必须是字母或数字。
```
az spring create -n my-azure-spring -g ServiceConnector-tutorial-mysqlf
```

创建 Azure Database for MySQL 灵活服务器

创建 MySQL 灵活服务器实例。在以下命令中，将 <admin-username> 和 <admin-password> 替换为所选凭据，以便为 MySQL 灵活服务器创建管理员用户。管理员用户名不能是 azure_superuser、azure_pg_admin、admin、administrator、root、guest 或 public 。不能以 pg_ 开头。密码必须包含以下字符类别中的三类（8 到 128 个字符）：英文大写字母、英文小写字母、数字及非字母数字字符（例如 !、# 和 %）。该密码不能包含 username。

az mysql flexible-server create \
    --resource-group ServiceConnector-tutorial-mysqlf \
    --name mysqlf-server \
    --database-name mysqlf-db \
    --admin-user <admin-username> \
    --admin-password <admin-password>

服务器是使用以下默认值创建的（除非手动替换这些默认值）：

设置	默认值	说明
server-name	系统生成的	用于标识 Azure Database for MySQL 服务器的唯一名称。
sku-name	GP_Gen5_2	SKU 的名称。请遵循简写约定 {pricing tier}_{compute generation}_{vCores}。默认为带 2 个 vCore 的常规用途 Gen5 服务器。有关定价的详细信息，请转到定价页。
backup-retention	7	备份保留时间。单位为天。
geo-redundant-backup	已禁用	是否应该为此服务启用异地冗余备份。
location	westus2	服务器的 Azure 位置。
ssl-enforcement	已启用	是否应该为此服务器启用 SSL。
storage-size	5120	服务器的存储容量（以 MB 为单位）。
版本	5.7	MySQL 主版本。

注意

默认情况下会使用 Standard_B1ms SKU。有关定价详细信息，请参阅 Azure Database for MySQL 定价。

注意

有关 az mysql flexible-server create 命令及其附加参数的详细信息，请参阅 Azure CLI 文档。

生成并部署应用

创建已分配公共终结点的应用。如果在生成 Azure Spring Apps 项目时选择了 Java 版本 11，请包含 --runtime-version=Java_11 开关。
```
az spring app create -n hellospring -s my-azure-spring -g ServiceConnector-tutorial-mysqlf --assign-endpoint true
```

运行 az spring connection create 命令，将部署到 Azure Spring Apps 的应用程序连接到 MySQL 灵活服务器数据库。将下面的占位符替换为你自己的信息。

az spring connection create mysql-flexible \
    --resource-group ServiceConnector-tutorial-mysqlf \
    --service my-azure-spring \
    --app hellospring \
    --target-resource-group ServiceConnector-tutorial-mysqlf \
    --server mysqlf-server \
    --database mysqlf-db \
    --secret name=<admin-username> secret=<admin-secret>

设置	说明
`--resource-group`	包含 Azure Spring Apps 托管的应用的资源组的名称。
`--service`	Azure Spring Apps 资源的名称。
`--app`	连接到目标服务的 Azure Spring Apps 托管的应用程序的名称。
`--target-resource-group`	包含存储帐户的资源组的名称。
`--server`	要连接到的 MySQL 灵活服务器
`--database`	之前创建的数据库的名称。
`--secret name`	MySQL 灵活服务器用户名。
`--secret`	MySQL 灵活服务器密码。

注意

如果看到错误消息“该订阅未注册为使用 ServiceLinker”，请运行 az provider register -n Microsoft.ServiceLinker 注册服务连接器资源提供程序，然后再次运行连接命令。

克隆示例代码

git clone https://github.com/Azure-Samples/serviceconnector-springcloud-mysql-springboot.git

使用 Maven 生成项目。

cd serviceconnector-springcloud-mysql-springboot
mvn clean package -DskipTests

为应用 target/demo-0.0.1-SNAPSHOT.jar 部署 JAR 文件。

az spring app deploy \
    --name hellospring \
    --service my-azure-spring \
    --resource-group ServiceConnector-tutorial-mysqlf \
    --artifact-path target/demo-0.0.1-SNAPSHOT.jar

在部署后通过以下命令查询应用状态。

az spring app list  --resource-group ServiceConnector-tutorial-mysqlf --service my-azure-spring --output table

应该会看到以下输出：

Name         Location    ResourceGroup                     Public Url                                                 Production Deployment    Provisioning State    CPU    Memory    Running Instance    Registered Instance    Persistent Storage    Bind Service Registry    Bind Application Configuration Service
-----------  ----------  --------------------------------  ---------------------------------------------------------  -----------------------  --------------------  -----  --------  ------------------  ---------------------  --------------------  -----------------------  ----------------------------------------
hellospring  eastus      ServiceConnector-tutorial-mysqlf  https://my-azure-spring-hellospring.azuremicroservices.io  default                  Succeeded             1      1Gi       1/1                 0/1                    -                     -

后续步骤

参考下面列出的教程来详细了解服务连接器。

了解服务连接器的概念

通过