你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
快速入门：从本地源代码生成应用并部署到 Azure 容器应用
本文演示如何使用所选的编程语言从本地源代码生成一个微服务并将其部署到 Azure 容器应用。 在本快速入门中，创建一个返回音乐专辑静态集合的后端 Web API 服务。
注意
有两个版本中提供了此示例应用程序。 其中一个版本的源中包含 Dockerfile。 另一个版本没有 Dockerfile。 请选择最能反映源代码的版本。 如果不熟悉容器，请选择顶部“无 Dockerfile”选项。
以下屏幕截图显示你部署的专辑 API 的输出。
先决条件
若要完成此项目，需要满足以下条件：
| 要求 | 说明 |
|---|---|
| Azure 帐户 | 如果你没有帐户，请免费创建一个。 需要拥有 Azure 订阅的“参与者”或“所有者”权限才能继续操作。 有关详细信息，请参阅使用 Azure 门户分配 Azure 角色。 |
| Azure CLI | 安装 Azure CLI。 |
设置
若要从 CLI 登录到 Azure，请运行以下命令，然后按照提示完成身份验证过程。
az login
为了确保你运行的是最新版本的 CLI，请运行升级命令。
az upgrade
接下来，安装或更新适用于 CLI 的 Azure 容器应用扩展。
az extension add --name containerapp --upgrade
现在已安装当前扩展或模块，接下来请注册 Microsoft.App 和 Microsoft.OperationalInsights 命名空间。
注意
Azure 容器应用资源已从 Microsoft.Web 命名空间迁移到 Microsoft.App 命名空间。 有关详细信息，请参阅 2022 年 3 月从 Microsoft.Web 到 Microsoft.App 的命名空间迁移。
az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights
创建环境变量
完成 Azure CLI 安装后，接下来可以定义要在本文中使用的环境变量。
在 bash shell 中定义以下变量。
export RESOURCE_GROUP="album-containerapps"
export LOCATION="canadacentral"
export ENVIRONMENT="env-album-containerapps"
export API_NAME="album-api"
获取示例代码
下载并提取所选语言的 API 示例应用程序。
生成并部署容器应用
使用 containerapp up 命令生成和部署你的第一个容器应用。 此命令将会：
- 创建资源组
- 创建 Azure 容器注册表
- 生成容器映像并将其推送到注册表
- 创建具有 Log Analytics 工作区的容器应用环境
- 使用生成的容器映像创建和部署容器应用
- 创建资源组
- 创建默认注册表作为环境的一部分
- 检测应用程序的语言和运行时，并使用相应的 Buildpack 生成映像
- 将映像推送到 Azure 容器应用默认注册表
- 创建具有 Log Analytics 工作区的容器应用环境
- 使用生成的容器映像创建和部署容器应用
up 命令使用存储库根目录中的 Dockerfile 生成容器映像。 Dockerfile 中的 EXPOSE 指令定义了目标端口，即用于将入口流量发送到容器的端口。
如果 up 命令找不到 Dockerfile，它会自动使用 Buildpack 将应用程序源转换为可运行容器。 由于 Buildpack 尝试代表你运行生成，因此需要指示 up 命令将入口流量发送到哪个端口。
在以下代码示例中，.（点）指示在提取的示例 API 应用程序的 src 目录中运行 containerapp up。
az containerapp up \
--name $API_NAME \
--location $LOCATION \
--environment $ENVIRONMENT \
--source .
az containerapp up \
--name $API_NAME \
--location $LOCATION \
--environment $ENVIRONMENT \
--ingress external \
--target-port 8080 \
--source .
重要
若要将容器应用部署到现有资源组，请在 containerapp up 命令中包含 --resource-group yourResourceGroup。
验证部署
将 FQDN 复制到 Web 浏览器。 在 Web 浏览器中，转到 FQDN 的 /albums 终结点。
清理资源
如果不打算继续学习部署前端教程，可以使用以下命令移除在本快速入门中创建的 Azure 资源。
注意
以下命令删除指定的资源组及其包含的所有资源。 如果组包含超出本快速入门范围的资源，这些资源也将被删除。
az group delete --name $RESOURCE_GROUP
提示
遇到问题？ 在 Azure 容器应用存储库中提交问题，告知我们有关 GitHub 的信息。
后续步骤
完成本快速入门后，可以继续学习教程：Azure 容器应用中的微服务之间的通信，了解如何部署调用 API 的前端应用程序。