Compartilhar via

快速入门：从本地源代码生成并部署到Azure Container Apps

本文演示如何通过使用所选的编程语言，从本地源代码构建并部署微服务到 Azure 容器应用。 在本快速入门中，你将创建一个后端 Web API 服务，该服务返回音乐专辑的静态集合。

以下屏幕截图显示了部署的专辑 API 服务的输出。

专辑 API endpoint 响应的截图。

先决条件

若要完成此project，需要以下项：

要求 说明
Azure 帐户 如果没有，请创建一个试用版订阅。 需要 Contributor 或 Owner 权限才能继续 Azure 订阅。

有关详细信息，请参阅 使用 Azure 门户分配 Azure 角色。
Git 安装 Git。
Azure CLI 安装 Azure CLI。

设置

若要从 CLI 登录到Azure，请运行以下命令，并按照提示完成身份验证过程。

az cloud set -n AzureChinaCloud
az login
# az cloud set -n AzureCloud   //means return to Public Azure.

若要确保运行最新版本的 CLI，请运行升级命令：

az upgrade

接下来，安装或更新 CLI 的容器应用扩展：

az extension add --name containerapp --upgrade --allow-preview true

安装当前扩展后，请注册 Microsoft.App 和 Microsoft.OperationalInsights 命名空间：

az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights

创建环境变量

完成 CLI 安装后，接下来可以定义要在本文中使用的环境变量。

在 Bash shell 中定义以下变量：

export RESOURCE_GROUP="album-containerapps"
export LOCATION="canadacentral"
export ENVIRONMENT="env-album-containerapps"
export API_NAME="album-api"

获取示例代码

运行以下命令，以所选语言克隆示例应用程序，并切换到project源文件夹：

git clone https://github.com/azure-samples/containerapps-albumapi-csharp.git
cd containerapps-albumapi-csharp/src

生成并部署容器应用

首先，运行以下命令来创建资源组，该资源组将包含你在本快速入门中创建的资源。

az group create --name $RESOURCE_GROUP --location $LOCATION

使用 containerapp up 命令生成和部署第一个容器应用。 此命令：

  • 创建资源组。
  • 创建容器注册表资源。
  • 生成容器映像并将其推送到注册表。
  • 使用 Log Analytics 工作区创建容器应用环境。
  • 使用生成的容器映像创建和部署容器应用。

up 命令使用 project 文件夹中的 Dockerfile 生成容器映像。 Dockerfile 中的 EXPOSE 指令定义目标端口，即用于将入口流量发送到容器的端口。

在以下代码示例中，. （dot） 指示 containerapp up在包含 Dockerfile 的project的当前目录中运行。

az containerapp up \
  --name $API_NAME \
  --resource-group $RESOURCE_GROUP \
  --location $LOCATION \
  --environment $ENVIRONMENT \
  --source .

注意事项

如果命令返回错误消息“AADSTS50158：未满足外部安全质询”，请运行 az login --scope https://graph.microsoft.com//.default 以使用所需权限登录，然后再次运行该 az containerapp up 命令。

验证部署

在 az containerapp up 命令的输出中找到容器应用的 URL。 在浏览器中输入并打开URL。 将 /albums 添加到 URL 末尾，以查看来自 API 的响应。

专辑 API 端点响应的屏幕截图。

限制

上传源代码的最大大小为 200 MB。 如果上传太大，则返回错误 413。

清理资源

如果不打算继续学习 Deploy 前端 教程，可以使用以下命令删除在本快速入门中创建的Azure资源。

注意

以下命令删除指定的资源组及其包含的所有资源。 如果资源组包含本快速入门范围之外的资源，则它们也会被删除。

az group delete --name $RESOURCE_GROUP

提示

是否有任何疑问？ 请通过在 Azure Container Apps 存储库中创建议题，让我们在 GitHub 上知晓。

后续步骤

完成本快速入门后，可以继续至教程: Azure Container Apps 中的微服务之间的通信，了解如何部署调用 API 的前端应用程序。

教程：微服务之间的通信

  • Last updated on