快速入门：将现有 Kubernetes 群集连接到 Azure Arc

• 具有活动订阅的Azure帐户。 创建试用版订阅。

• 基本了解 Kubernetes 核心概念。

• 身份（用户或服务主体），可用于登录到Azure CLI并将群集连接到Azure Arc。

• 最新版本的 Azure CLI。

• 通过运行以下命令安装最新版本的 connectedk8s Azure CLI 扩展：

  az extension add --name connectedk8s
  

• 正在运行的 Kubernetes 群集。 如果没有群集，可以使用以下选项之一创建群集：

  • Docker 中的 Kubernetes (KIND)

  • 使用 Docker for Linux、 Mac 或 Windows

  • 使用群集 API 的自托管 Kubernetes 群集

    注意

    群集至少需要有一个操作系统节点和体系结构类型 linux/amd64 和/或 linux/arm64。 有关 ARM64 方案的详细信息，请参阅群集要求。

• 在群集上部署 Arc 代理需要至少 850 MB 的可用空间，并且大约需要 7% 的单个 CPU 容量。

• 指向群集的 kubeconfig 文件和上下文。 有关详细信息，请参阅 配置对多个群集的访问权限。

• 具有活动订阅的Azure帐户。 创建试用版订阅。

• 基本了解 Kubernetes 核心概念。

• 身份（用户或服务主体），可用于将您的群集连接到 Azure Arc，并登录 Azure PowerShell。

• Azure PowerShell 6.6.0 或更高版本

• 通过运行以下命令安装 Az.ConnectedKubernetes Azure PowerShell 模块：

  Install-Module -Name Az.ConnectedKubernetes
  

• 正在运行的 Kubernetes 群集。 如果没有群集，可以使用以下选项之一创建群集：

  • Docker 中的 Kubernetes (KIND)

  • 使用 Docker for Linux、 Mac 或 Windows

  • 使用群集 API 的自托管 Kubernetes 群集

    注意

    群集至少需要有一个操作系统节点和体系结构类型 linux/amd64 和/或 linux/arm64。 有关 ARM64 方案的详细信息，请参阅群集要求。

• 在群集上部署 Arc 代理需要至少 850 MB 的可用空间，并且大约需要 7% 的单个 CPU 容量。

• 指向群集的 kubeconfig 文件和上下文。 有关详细信息，请参阅 配置对多个群集的访问权限。

1. 输入以下命令：

   az provider register --namespace Microsoft.Kubernetes
   az provider register --namespace Microsoft.KubernetesConfiguration
   az provider register --namespace Microsoft.ExtendedLocation
   

2. 监视注册过程。 注册最多可能需要 10 分钟。

   az provider show -n Microsoft.Kubernetes -o table
   az provider show -n Microsoft.KubernetesConfiguration -o table
   az provider show -n Microsoft.ExtendedLocation -o table
   

   注册完成后，RegistrationState 这些命名空间的状态会更改为 Registered。

1. 输入以下命令：

   Register-AzResourceProvider -ProviderNamespace Microsoft.Kubernetes
   Register-AzResourceProvider -ProviderNamespace Microsoft.KubernetesConfiguration
   Register-AzResourceProvider -ProviderNamespace Microsoft.ExtendedLocation
   

2. 监视注册过程。 注册最多可能需要 10 分钟。

   Get-AzResourceProvider -ProviderNamespace Microsoft.Kubernetes
   Get-AzResourceProvider -ProviderNamespace Microsoft.KubernetesConfiguration
   Get-AzResourceProvider -ProviderNamespace Microsoft.ExtendedLocation
   

   注册完成后，RegistrationState 这些命名空间的状态会更改为 Registered。

az group create --name AzureArcTest --location ChinaEast2 --output table

输出：

Location    Name
---------- ------------
chinaeast2      AzureArcTest

New-AzResourceGroup -Name AzureArcTest -Location ChinaEast2

输出：

ResourceGroupName : AzureArcTest
Location          : chinaeast2
ProvisioningState : Succeeded
Tags              :
ResourceId        : /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/AzureArcTest

az connectedk8s connect --name AzureArcTest1 --resource-group AzureArcTest

输出：

Helm release deployment succeeded

    {
      "aadProfile": {
        "clientAppId": "",
        "serverAppId": "",
        "tenantId": ""
      },
      "agentPublicKeyCertificate": "xxxxxxxxxxxxxxxxxxx",
      "agentVersion": null,
      "connectivityStatus": "Connecting",
      "distribution": "gke",
      "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/AzureArcTest/providers/Microsoft.Kubernetes/connectedClusters/AzureArcTest1",
      "identity": {
        "principalId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "tenantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "type": "SystemAssigned"
      },
      "infrastructure": "gcp",
      "kubernetesVersion": null,
      "lastConnectivityTime": null,
      "location": "chinaeast2",
      "managedIdentityCertificateExpirationTime": null,
      "name": "AzureArcTest1",
      "offering": null,
      "provisioningState": "Succeeded",
      "resourceGroup": "AzureArcTest",
      "tags": {},
      "totalCoreCount": null,
      "totalNodeCount": null,
      "type": "Microsoft.Kubernetes/connectedClusters"
    }

New-AzConnectedKubernetes -ClusterName AzureArcTest1 -ResourceGroupName AzureArcTest -Location chinaeast2

输出：

Location Name          Type
-------- ----          ----
chinaeast2   AzureArcTest1 microsoft.kubernetes/connectedclusters

1. 在部署计算机上，设置Azure CLI使用出站代理服务器所需的环境变量：

   export HTTP_PROXY=<proxy-server-ip-address>:<port>
   export HTTPS_PROXY=<proxy-server-ip-address>:<port>
   export NO_PROXY=<cluster-apiserver-ip-address>:<port>
   

2. 在 Kubernetes 群集上，运行指定了 --proxy-https 和 --proxy-http 参数的连接命令。 如果代理服务器同时设置了 HTTP 和 HTTPS，请确保对 HTTP 代理使用 --proxy-http，对 HTTPS 代理使用 --proxy-https。 如果代理服务器仅使用 HTTP，则可以将该值用于这两个参数。

   az connectedk8s connect --name <cluster-name> --resource-group <resource-group> --proxy-https https://<proxy-server-ip-address>:<port> --proxy-http http://<proxy-server-ip-address>:<port> --proxy-skip-range <excludedIP>,<excludedCIDR> --proxy-cert <path-to-cert-file>
   

   注意

   • 某些网络请求（例如涉及群集内服务到服务通信的网络请求）需要与通过代理服务器路由的流量分离，以便进行出站通信。 --proxy-skip-range使用参数以逗号分隔的方式指定 CIDR 范围和终结点，以便从代理到这些终结点的任何通信都不会通过出站代理进行。 至少将群集中的服务的 CIDR 范围指定为此参数的值。 例如，假设 kubectl get svc -A 返回一个服务列表，其中所有服务在 10.0.0.0/16 范围内都有 ClusterIP 值。 则要为 --proxy-skip-range 指定的值为 10.0.0.0/16,kubernetes.default.svc,.svc.cluster.local,.svc。
   • 大多数出站代理环境需要 --proxy-http， --proxy-https以及 --proxy-skip-range。 --proxy-cert 仅当需要将代理期望的受信任证书注入到代理 Pod 的受信任证书存储中时，才需要此参数。
   • 必须将出站代理配置为允许 Websocket 连接。

   对于出站代理服务器，如果仅提供受信任的证书，您只需运行命令az connectedk8s connect并指定--proxy-cert参数即可：

   az connectedk8s connect --name <cluster-name> --resource-group <resource-group> --proxy-cert <path-to-cert-file>
   

   如果有多个受信任的证书，请将证书链（叶证书、中间证书、根证书）合并为一个文件，并在参数 --proxy-cert 中传入。

   提示

   • --custom-ca-cert 是 --proxy-cert 的别名。 可互换使用任一参数。 如果在同一命令中传递这两个参数，则以最后传递的参数为准。

1. 在部署计算机上，设置Azure PowerShell使用出站代理服务器所需的环境变量：

   $Env:HTTP_PROXY = "<proxy-server-ip-address>:<port>"
   $Env:HTTPS_PROXY = "<proxy-server-ip-address>:<port>"
   $Env:NO_PROXY = "<cluster-apiserver-ip-address>:<port>"
   

2. 在 Kubernetes 群集上，使用指定的代理参数运行 connect 命令：

   New-AzConnectedKubernetes -ClusterName <cluster-name> -ResourceGroupName <resource-group> -Location chinaeast2 -Proxy 'https://<proxy-server-ip-address>:<port>'
   

Azure PowerShell目前不支持仅传入没有代理服务器终结点详细信息的代理证书。

az connectedk8s list --resource-group AzureArcTest --output table

输出：

Name           Location    ResourceGroup
------------- ----------  ---------------
AzureArcTest1  chinaeast2      AzureArcTest

Get-AzConnectedKubernetes -ResourceGroupName AzureArcTest

输出：

Location     Name          Type
--------     ----          ----
chinaeast2   AzureArcTest1 microsoft.kubernetes/connectedclusters

若要删除已启用Azure Arc的 Kubernetes 资源以及群集上运行的任何关联的配置资源和代理，请使用以下命令：

az connectedk8s delete --name AzureArcTest1 --resource-group AzureArcTest

如果删除过程失败，请使用以下命令强制删除。 添加 -y 以绕过确认提示：

az connectedk8s delete -n AzureArcTest1 -g AzureArcTest --force

如果由于以前创建的资源未完全删除而创建新群集部署时遇到问题，请使用此命令。

可以使用以下命令删除已启用Azure Arc的 Kubernetes 资源、任何关联的配置资源和群集上运行的任何代理：

Remove-AzConnectedKubernetes -ClusterName AzureArcTest1 -ResourceGroupName AzureArcTest