快速入门:使用 Azure Developer CLI 部署 Azure Kubernetes 服务 (AKS) 群集

Azure Kubernetes 服务 (AKS) 是可用于快速部署和管理群集的托管式 Kubernetes 服务。 在此快速入门中,你将了解:

  • 下载并安装 Azure Developer CLI (azd)。
  • 从 Azure Developer CLI 模板克隆应用程序(azd 模板)。
  • 使用 Azure Developer CLI (azd) 部署 AKS 群集。
  • 运行示例多容器应用程序,其中的一组微服务模拟零售应用。
  • 删除和清理azd模板中创建的容器。

注意

为了开始快速预配 AKS 群集,本文介绍了仅针对评估目的部署具有默认设置的群集的步骤。

开始之前

本快速入门假设读者基本了解 Kubernetes 的概念。 有关详细信息,请参阅 Azure Kubernetes 服务 (AKS) 的 Kubernetes 核心概念。

  • 如果没有 Azure 订阅,可在开始前创建一个试用帐户。
  • 如需在本地运行 CLI 参考命令,请安装 Azure CLI。 如果在 Windows 或 macOS 上运行,请考虑在 Docker 容器中运行 Azure CLI。 有关详细信息,请参阅如何在 Docker 容器中运行 Azure CLI。

    • 如果使用本地安装,请使用 az login 命令登录到Azure CLI。 若要完成身份验证过程,请遵循终端中显示的步骤。 有关其他登录选项,请参阅使用 Azure CLI 登录。

    • 出现提示时,请在首次使用时安装 Azure CLI 扩展。 有关扩展详细信息,请参阅使用 Azure CLI 的扩展。

    • 运行 az version 以查找安装的版本和依赖库。 若要升级到最新版本,请运行 az upgrade。

查看应用程序代码

可以在Azure-Samples/aks-store-demo GitHub 存储库中查看应用程序代码。

快速入门应用程序包括以下 Kubernetes 部署和服务:

显示 Azure 应用商店示例体系结构的图表。

  • 门店:Web 应用程序,供客户查看产品和下单。
  • 产品服务:显示产品信息。
  • 订单服务:用于下单。
  • Rabbit MQ:用于订单队列的消息队列。

注意

建议不要在没有持久性存储用于生产的情况下运行有状态容器(例如 Rabbit MQ)。 这里使用这些服务是为了简单起见,但我们建议改用托管服务,如 Azure Cosmos DB 或 Azure 服务总线。

克隆 Azure Developer CLI 模板

  1. 使用 azd init 命令并带上 --template 参数,从 Azure-Samples 仓库克隆 AKS Store 演示模板。

    azd init --template Azure-Samples/aks-store-demo
    
  2. 输入仅使用字母数字字符和连字符的项目的环境名称,例如aks-azdqs-1。

    Enter a new environment name: aks-azdqs-1
    

登录到 Azure 云帐户

azd模板包含创建服务所需的所有代码,但需要登录到 Azure 帐户才能在 AKS 上托管应用程序。

  1. 使用azd auth login命令登录到帐户。

    azd auth login
    
  2. 复制输出中显示的设备代码,然后按 Enter 登录。

    Start by copying the next code: XXXXXXXXX
    Then press enter and continue to log in from your browser...
    

    重要

    如果你使用的是网络外部的虚拟机或 GitHub Codespace,那么某些 Azure 安全策略在使用 azd auth login 登录时会发生冲突。 如果你在这里遇到问题,可以按照下面提供的 azd auth 变通方法进行操作,即向运行 [azd auth login][az-auth-login] 后重定向到的 localhost URL 发起一个 curl 请求。

  3. 在贵组织的登录页面上使用您的凭据进行身份验证。

  4. 确认是你在尝试从 Azure CLI 进行连接。

  5. 验证消息“设备代码身份验证已完成。 已登录到 Azure。”显示在原始终端中。

    Waiting for you to complete authentication in the browser...
    Device code authentication completed.
    Logged in to Azure.
    

azd 身份验证变通方法

此解决方法要求安装Azure CLI。

  1. 打开终端窗口,使用az login命令通过 Azure CLI 登录,--scope参数设置为https://microsoftgraph.chinacloudapi.cn/.default。

    az login --scope https://microsoftgraph.chinacloudapi.cn/.default
    

    应重定向到新选项卡中的身份验证页以创建浏览器访问令牌,如以下示例所示:

    https://login.partner.microsoftonline.cn/organizations/oauth2/v2.0/authorize?clientid=<your_client_id>.
    
  2. 复制尝试使用azd auth login登录后收到的网页的 localhost URL。

  3. 在新终端窗口中,使用以下curl请求登录。 请确保将<localhost>占位符替换为在上一步中复制的 localhost URL。

    curl <localhost>
    

    成功登录会输出 HTML 网页,如以下示例所示:

    <!DOCTYPE html>
    <html>
    <head>
        <meta charset="utf-8" />
        <meta http-equiv="refresh" content="60;url=https://learn.microsoft.com/cli/azure/">
        <title>Login successfully</title>
        <style>
            body {
                font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
            }
    
            code {
                font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace;
                display: inline-block;
                background-color: rgb(242, 242, 242);
                padding: 12px 16px;
                margin: 8px 0px;
            }
        </style>
    </head>
    <body>
        <h3>You have logged into Azure!</h3>
        <p>You can close this window, or we will redirect you to the <a href="https://learn.microsoft.com/cli/azure/">Azure CLI documentation</a> in 1 minute.</p>
        <h3>Announcements</h3>
        <p>[Windows only] Azure CLI is collecting feedback on using the <a href="https://learn.microsoft.com/windows/uwp/security/web-account-manager">Web Account Manager</a> (WAM) broker for the login experience.</p>
        <p>You may opt-in to use WAM by running the following commands:</p>
        <code>
            az config set core.allow_broker=true<br>
            az account clear<br>
            az login
        </code>
    </body>
    </html>
    
  4. 关闭当前终端并打开原始终端。 应看到订阅的 JSON 列表。

  5. 复制要使用的订阅的id字段。

  6. 使用 az account set 命令设置订阅。

    az account set --subscription <subscription_id>
    

为群集创建和部署资源

azd运行azd-hooks文件夹中的所有挂钩,以预注册、预配和部署应用程序服务。

此快速入门的 azd 模板会创建一个新资源组,其中包含 AKS 群集和 Azure 密钥保管库。 密钥保管库存储客户端机密,并在pets命名空间中运行服务

  1. 使用azd up命令创建所有应用程序资源。

    azd up
    
  2. 为计费使用情况选择 Azure 订阅。

    ? Select an Azure Subscription to use:  [Use arrows to move, type to filter]
    > 1. My Azure Subscription (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
    
  3. 选择要将应用程序部署到的区域。

    Select an Azure location to use:  [Use arrows to move, type to filter]
      1.  (Asia) China North 3
      2.  (Asia) China East 2
    

    azd 会自动运行预配前命令和预配后命令,为您的应用程序创建资源。 此过程可能需要几分钟才能完成。 完成后,应看到类似于以下示例的输出:

    SUCCESS: Your workflow to provision and deploy to Azure completed in 9 minutes 40 seconds.
    

测试应用程序

应用程序运行时,Kubernetes 服务将向 Internet 公开应用程序前端。 此过程可能需要几分钟才能完成。 若要管理 Kubernetes 群集,请使用 Kubernetes 命令行客户端 kubectl。 kubectl 已在 azd up 期间安装。

  1. 使用pets命令将命名空间设置为演示命名空间kubectl set-context。

    kubectl config set-context --current --namespace=pets
    
  2. 使用 kubectl get pods 命令查看已部署的 Pod 的状态。 请确保所有 Pod 均为 Running 状态后再继续操作。

    kubectl get pods
    
  3. 使用带有kubectl get service参数的--watch命令检查存储前端应用程序的公共 IP 地址,并监视进度。

    kubectl get service store-front --watch
    

    store-front 服务的 EXTERNAL-IP 输出结果最初显示为 pending:

    NAME          TYPE           CLUSTER-IP    EXTERNAL-IP   PORT(S)        AGE
    store-front   LoadBalancer   10.0.100.10   <pending>     80:30025/TCP   4h4m
    
  4. 在 EXTERNAL-IP 地址从 pending 更改为实际公共 IP 地址后,请使用 CTRL-C 来停止 kubectl 监视进程。

    以下示例输出显示向服务分配了有效的公共 IP 地址:

    NAME          TYPE           CLUSTER-IP    EXTERNAL-IP    PORT(S)        AGE
    store-front   LoadBalancer   10.0.100.10   20.62.159.19   80:30025/TCP   4h5m
    
  5. 打开 Web 浏览器并转到服务的外部 IP 地址,以查看 Azure 应用商店应用的实际效果。

    AKS 应用商店示例应用程序的屏幕截图。

删除群集

完成快速入门后,清理不必要的资源以避免 Azure 费用。

  1. 使用 azd down 命令删除在快速入门中创建的所有资源。

    azd down
    
  2. 键入y并按Enter,以确认决定从订阅中删除所有已用资源。

    ? Total resources to delete: 14, are you sure you want to continue? (y/N)
    
  3. 键入y并按Enter,以便在适用时允许清除操作复用快速入门变量。

    [Warning]: These resources have soft delete enabled allowing them to be recovered for a period or time after deletion. During this period, their names may not be reused. In the future, you can use the argument --purge to skip this confirmation.
    
    ? Would you like to permanently delete these resources instead, allowing their names to be reused? (y/N)
    

    删除资源后,应看到类似于以下示例的输出:

    SUCCESS: Your application was removed from Azure in 14 minutes 30 seconds.
    

注意

此示例应用程序用于演示目的,并不代表 Kubernetes 应用程序的所有最佳做法。

后续步骤

在本快速入门中,你部署了一个 Kubernetes 群集,然后在其中部署了示例多容器应用程序。 此示例应用程序仅用于演示目的,并未展示出 Kubernetes 应用程序的所有最佳做法。

若要详细了解 AKS 并演练完整的代码到部署示例,请继续阅读 Kubernetes 群集教程。