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

快速入门：部署已启用 Azure Arc 的数据服务 - 间接连接模式 - Azure CLI

项目
12/06/2023

在本快速入门中，将通过 Azure CLI 在间接连接模式下部署已启用 Azure Arc 的数据服务。

完成本文中的步骤后，你将获得：

Azure Kubernetes 服务 (AKS) 上的 Kubernetes 群集。
处于间接连接模式的数据控制器。
Azure Arc 启用的 SQL 托管实例。
使用 Azure Data Studio 与该实例建立的连接。

使用这些对象来体验已启用 Azure Arc 的数据服务。

Azure Arc 允许通过 Kubernetes 在本地、边缘和公有云中运行 Azure 数据服务。使用 Azure Arc 部署 SQL 托管实例和 PostgreSQL 服务器数据服务（预览版）。使用 Azure Arc 的好处包括保持最新的持续不断的服务补丁、弹性缩放、自助服务预配、统一管理和支持断开连接模式。

先决条件

如果还没有 Azure 订阅，可以在开始前创建一个免费帐户。

若要完成本文中的任务，请安装所需的客户端工具。具体而言，你将使用以下工具：

Azure Data Studio
Azure Data Studio 的 Azure Arc 扩展
Kubernetes CLI
Azure CLI
Azure CLI 的 arcdata 扩展

设置指标和日志服务凭据

已启用 Azure Arc 的数据服务提供：

日志服务和仪表板（通过 Kibana）
指标服务和仪表板（通过 Grafana）

这些服务需要每个服务的凭据。凭据是用户名和密码。对于此步骤，请使用每个凭据的值设置环境变量。

环境变量包括日志和指标服务的密码。密码长度必须至少为 8 个字符，且必须包含以下四种类别中三种类别的字符：拉丁大写字母、拉丁小写字母、数字和非字母数字字符。

运行以下命令设置凭据。

Linux
Windows / PowerShell

export AZDATA_LOGSUI_USERNAME=<username for logs>
export AZDATA_LOGSUI_PASSWORD=<password for logs>
export AZDATA_METRICSUI_USERNAME=<username for metrics>
export AZDATA_METRICSUI_PASSWORD=<password for metrics>

$ENV:AZDATA_LOGSUI_USERNAME="<username for logs>"
$ENV:AZDATA_LOGSUI_PASSWORD="<password for logs>"
$ENV:AZDATA_METRICSUI_USERNAME="<username for metrics>"
$ENV:AZDATA_METRICSUI_PASSWORD="<password for metrics>"

创建并连接到 Kubernetes 群集

安装客户端工具并配置环境变量后，需要访问 Kubernetes 群集。本部分中的步骤在 Azure Kubernetes 服务 (AKS) 上部署群集。

按照以下步骤从 Azure CLI 部署群集。

创建资源组

为群集创建资源组。对于位置，请指定支持的区域。对于已启用 Azure Arc 的数据服务，概述中已列出支持的区域。
```
az group create --name <resource_group_name> --location <location>
```
若要详细了解资源组，请参阅什么是 Azure 资源管理器。
创建 Kubernetes 群集

在前面创建的资源组中创建群集。

选择符合要求的节点大小。请参阅大小调整指南。

以下示例创建一个已启用监视的三节点群集，并生成公钥和私钥文件（如果缺少这些文件）。
```
az aks create --resource-group <resource_group_name> --name <cluster_name> --node-count 3 --enable-addons monitoring --generate-ssh-keys --node-vm-size <node size>
```
有关命令详细信息，请参阅 az aks create。

有关完整演示（包括单节点 Kubernetes 群集上的应用程序），请转到快速入门：使用 Azure CLI 部署 Azure Kubernetes 服务群集。
获取凭据

需要获取凭据以连接到群集。

运行以下命令以获取凭据：
```
az aks get-credentials --resource-group <resource_group_name> --name <cluster_name>
```

验证群集

若要确认群集是否正在运行并且你是否拥有当前连接上下文，请运行

kubectl get nodes

该命令返回节点列表。例如：

NAME                                STATUS   ROLES   AGE     VERSION
aks-nodepool1-34164736-vmss000000   Ready    agent   4h28m   v1.20.9
aks-nodepool1-34164736-vmss000001   Ready    agent   4h28m   v1.20.9
aks-nodepool1-34164736-vmss000002   Ready    agent   4h28m   v1.20.9

创建数据控制器

现在，我们的群集已启动并运行，接下来我们可以在间接连接模式下创建数据控制器。

用于创建数据控制器的 CLI 命令是：

az arcdata dc create --profile-name azure-arc-aks-premium-storage --k8s-namespace <namespace> --name <data controller name> --subscription <subscription id> --resource-group <resource group name> --location <location> --connectivity-mode indirect --use-k8s

监视部署

还可以使用以下命令监视数据控制器的创建：

kubectl get datacontroller --namespace <namespace>

该命令返回数据控制器的状态。例如，以下结果表示部署正在进行：

NAME          STATE
<namespace>   DeployingMonitoring

在数据控制器的状态变为“READY”后，此步骤即告完成。例如：

NAME          STATE
<namespace>   Ready

部署 Azure Arc 启用的 SQL 托管实例的一个实例

现在，我们可以使用以下命令创建间接连接模式的 Azure MI：

az sql mi-arc create -n <instanceName> --k8s-namespace <namespace> --use-k8s

若要知道该实例的创建时间，请运行：

kubectl get sqlmi -n <namespace>[

在托管实例命名空间的状态变为“READY”后，此步骤即告完成。例如：

NAME          STATE
<namespace>   Ready

在 Azure Data Studio 上连接到托管实例

若要使用 Azure Data Studio 进行连接，请参阅连接到 Azure Arc 启用的 SQL 托管实例。

将使用情况和指标上传到 Azure 门户

如果需要，可以将使用情况数据、指标和日志上传到 Azure。

清理资源

使用完本文中创建的资源后，

按照在间接连接模式下删除数据控制器中的步骤进行操作。

快速入门：部署已启用 Azure Arc 的数据服务 - 直接连接模式 - Azure 门户。