使用 Microsoft Entra ID 将 Kubernetes 部署到 Azure Stack Hub

项目
10/31/2024

注意

仅使用 Kubernetes Azure Stack 市场项将部署群集作为概念证明。有关 Azure Stack 上支持的 Kubernetes 群集，请使用 AKS 引擎。

在单个协调操作中使用 Microsoft Entra ID 作为标识管理服务时，可以按照本文中的步骤部署和设置 Kubernetes 的资源。

先决条件

开始之前，请确保你有适当的权限且 Azure Stack Hub 已就绪。

验证你是否可以在 Microsoft Entra 租户中创建应用程序。需要这些权限才能进行 Kubernetes 部署。

有关如何检查权限的说明，请参阅检查 Microsoft Entra 权限。
生成一个 SSH 公钥和私钥对，用于登录到 Azure Stack Hub 上的 Linux VM。在创建群集时需要此公钥。

有关如何生成密钥的说明，请参阅 SSH 密钥生成。
检查你在 Azure Stack Hub 租户门户中是否有有效的订阅，以及是否有足够的公共 IP 地址来添加新的应用程序。

此群集不能部署到 Azure Stack Hub“管理员”订阅。必须使用用户订阅。
如果你的市场中没有 Kubernetes 群集，请联系 Azure Stack Hub 管理员。

创建服务主体

在 Azure 中设置服务主体。借助服务主体，应用程序可以访问 Azure Stack Hub 资源。

登录到全球 Azure 门户。
检查你是否已使用与 Azure Stack Hub 实例关联的 Microsoft Entra 租户登录。可以通过单击 Azure 工具栏上的筛选器图标切换你的登录。
创建 Microsoft Entra 应用程序。

a. 通过 Azure 门户登录到 Azure 帐户。
b. 选择“Microsoft Entra ID”>“应用注册”>“新建注册”。
c. 为应用提供名称和 URL。
d. 选择“支持的帐户类型”。
e. 为应用程序的 URI 添加 http://localhost。选择“Web”作为要创建的应用类型。设置这些值后，选择“注册”。
记下“应用程序 ID”。在创建群集时需要此 ID。此 ID 称为“服务主体客户端 ID”。
在服务主体的边栏选项卡中，选择“新客户端机密”。 “设置”>“密钥” 。需要为服务主体生成身份验证密钥。

a. 输入“说明”。

b. 对于“过期”这一项，请选择“永不过期”。

c. 选择“添加” 。记下密钥字符串。在创建群集时需要此密钥字符串。此密钥称为“服务主体客户端机密”。

为服务主体提供访问权限

为服务主体提供对订阅的访问权限，使该主体能够创建资源。

登录到 Azure Stack Hub 门户 https://portal.local.azurestack.external/。
选择“所有服务”>“订阅”。
选择你的操作员创建的用于使用 Kubernetes 群集的订阅。
选择“访问控制(IAM)”> 选择“添加”>“添加角色分配”。
选择“参与者”角色。
选择为服务主体创建的应用程序名称。可能需要在搜索框中键入名称。
单击“保存” 。

部署 Kubernetes

打开 Azure Stack Hub 门户 https://portal.local.azurestack.external。
选择“+ 创建资源”>“计算”>“Kubernetes 群集”。单击 “创建” 。

1.基础知识

在“创建 Kubernetes 群集”中选择“基本信息”。
选择订阅 ID。
输入新资源组的名称，或者选择现有资源组。资源名称必须为字母数字，且必须小写。
选择资源组的“位置”。这是为 Azure Stack Hub 安装选择的区域。

2.Kubernetes 群集设置

在“创建 Kubernetes 群集”中选择“Kubernetes 群集设置”。
输入 Linux VM 管理员用户名。构成 Kubernetes 群集和 DVM 的 Linux 虚拟机的用户名。
输入 SSH 公钥，用于向所有作为 Kubernetes 群集和 DVM 的一部分创建的 Linux 计算机授权。
输入特定于区域的主配置文件 DNS 前缀。这必须是特定于区域的名称，例如 k8s-12345。最佳做法是尝试选择与资源组名称相同的名称。

注意

为每个群集使用新且唯一的主配置文件 DNS 前缀。
选择“Kubernetes 主池配置文件计数”。此计数包含主池中的节点数。其范围为 1 到 7。此值应当为奇数。
选择“Kubernetes 主 VM 的 VMSize”。这指定 Kubernetes 主 VM 的 VM 大小。
选择“Kubernetes 节点池配置文件计数”。此计数包含群集中的代理数。
选择“Kubernetes 节点 VM 的 VMSize”。这指定 Kubernetes 节点 VM 的 VM 大小。
对于 Azure Stack Hub 安装，请为“Azure Stack Hub 标识系统”选择“Microsoft Entra ID”。
输入“服务主体 ClientId”，供 Kubernetes Azure 云提供程序使用。 Azure Stack Hub 管理员创建服务主体时标识为应用程序 ID 的客户端 ID。
输入“服务主体客户端机密”。这是在创建服务时设置的客户端机密。
输入“Kubernetes 版本”。这是 Kubernetes Azure 提供程序的版本。 Azure Stack Hub 为每个 Azure Stack Hub 版本发布一个自定义 Kubernetes 内部版本。