部署到 Azure

把你的 ASP.NET Core 程序部署到 Azure 只需要简单几步。你可以通过 Azure 的网上门户实施，也可以在 Azure CLI 命令行工具里实施。我会讲解后者。

准备材料

  • Git（使用 git --version 命令确认它已经安装了）
  • Azure CLI（按照 https://github.com/Azure/azure-cli 的指示进行安装）
  • 一个 Azure 订阅（免费的订阅就可以了）
  • 项目的根目录里要有一个部署配置文件

创建部署配置文件

因为你的目录结构里存在多个项目（Web项目和两个测试项目），Azure 并不知道该把哪个发布出去。为解决这个问题，在你的目录结构顶层创建一个名为 .deployment 的文件：

.deployment

  1. [config]
  2. project = AspNetCoreTodo/AspNetCoreTodo.csproj

确保你把这个文件保存为 .deployment，而不带有什么其它的零碎儿。（在 Windows 上，你可能需要把文件名用引号括起来，比如 ".deployment"，以此避免被添加一个 .txt 扩展名。）

如果你在顶层目录里执行 ls 或者 dir 命令，应该看到如下的内容：

  1. .deployment
  2. AspNetCoreTodo
  3. AspNetCoreTodo.IntegrationTests
  4. AspNetCoreTodo.UnitTests

设置 Azure 资源

如果你的 Azure CLI 才初次安装完成，运行：

  1. az login

并按照提示在你的电脑上登录，然后，为这个程序创建一个新的 资源组(Resource Group)：

  1. az group create -l westus -n AspNetCoreTodoGroup

这个命令在美国西部(West US)地区创建了一个资源组。如果你距离美国西部很远，请使用 az account list-locations 命令获取一个地点列表，并找出距离你比较近的一个。

接下来，在你刚刚创建的组里，创建一个 App Service 方案：

  1. az appservice plan create -g AspNetCoreTodoGroup -n AspNetCoreTodoPlan --sku F1

提示：F1 是免费的 app 方案。如果想在你的应用上使用自己指定的域名，请使用 D1($10/月)或更高级的方案。

现在，在这个 App Service 方案里创建一个 Web 应用：

  1. az webapp create -g AspNetCoreTodoGroup -p AspNetCoreTodoPlan -n MyTodoApp

这个应用的名称（上面的 MyTodoApp）在 Azure 上必须是全局唯一的。一旦这个应用创建好了，会具有一个以下格式的默认 URL：http://mytodoapp.azurewebsites.net

把项目文件部署到 Azure

你可以用 Git 把程序文件推送到 Azure 网络应用。如果你本地目录尚未作为一个 Git 仓库管理，执行下列命令进行设置：

  1. git init
  2. git add .
  3. git commit -m "First commit!"

接下来，为部署工作创建一个 Azure 用户名和密码，

  1. az webapp deployment user set --user-name nate

按提示创建密码。然后用 config-local-git 得到一个 Git URL：

  1. az webapp deployment source config-local-git -g AspNetCoreTodoGroup -n MyTodoApp --out tsv
  3. https://nate@mytodoapp.scm.azurewebsites.net/MyTodoApp.git

复制这个 URL 到剪切板，并把它在本地仓库里添加为一个 Git remote：

  1. git remote add azure <粘贴>

你只需要执行这些步骤一次。现在开始，任何时候，你需要推送程序文件到 Azure ，只需要在 Git 里提交它们，然后运行：

  1. git push azure master

程序部署到 Azure 的时候，你会看到一系列的日志信息。

输出结束之后，浏览 http://yourappname.azurewebsites.net 以检验结果。

Deploy to Azure

Deploying your ASP.NET Core application to Azure only takes a few steps. You can do it through the Azure web portal, or on the command line using the Azure CLI. I’ll cover the latter.

What you’ll need

  • Git (use git --version to make sure it’s installed)
  • The Azure CLI (follow the install instructions at https://github.com/Azure/azure-cli)
  • An Azure subscription (the free subscription is fine)
  • A deployment configuration file in your project root

Create a deployment configuration file

Since there are multiple projects in your directory structure (the web application, and two test projects), Azure won’t know which one to publish. To fix this, create a file called .deployment at the very top of your directory structure:

.deployment

  1. [config]
  2. project = AspNetCoreTodo/AspNetCoreTodo.csproj

Make sure you save the file as .deployment with no other parts to the name. (On Windows, you may need to put quotes around the filename, like ".deployment", to prevent a .txt extension from being added.)

If you ls or dir in your top-level directory, you should see these items:

  1. .deployment
  2. AspNetCoreTodo
  3. AspNetCoreTodo.IntegrationTests
  4. AspNetCoreTodo.UnitTests

Set up the Azure resources

If you just installed the Azure CLI for the first time, run

  1. az login

and follow the prompts to log in on your machine. Then, create a new Resource Group for this application:

  1. az group create -l westus -n AspNetCoreTodoGroup

This creates a Resource Group in the West US region. If you’re located far away from the western US, use az account list-locations to get a list of locations and find one closer to you.

Next, create an App Service plan in the group you just created:

  1. az appservice plan create -g AspNetCoreTodoGroup -n AspNetCoreTodoPlan --sku F1

F1 is the free app plan. If you want to use a custom domain name with your app, use the D1 ($10/month) plan or higher.

Now create a Web App in the App Service plan:

  1. az webapp create -g AspNetCoreTodoGroup -p AspNetCoreTodoPlan -n MyTodoApp

The name of the app (MyTodoApp above) must be globally unique in Azure. Once the app is created, it will have a default URL in the format: http://mytodoapp.azurewebsites.net

Deploy your project files to Azure

You can use Git to push your application files up to the Azure Web App. If your local directory isn’t already tracked as a Git repo, run these commands to set it up:

  1. git init
  2. git add .
  3. git commit -m "First commit!"

Next, create an Azure username and password for deployment:

  1. az webapp deployment user set --user-name nate

Follow the instructions to create a password. Then use config-local-git to spit out a Git URL:

  1. az webapp deployment source config-local-git -g AspNetCoreTodoGroup -n MyTodoApp --out tsv
  3. https://nate@mytodoapp.scm.azurewebsites.net/MyTodoApp.git

Copy the URL to the clipboard, and use it to add a Git remote to your local repository:

  1. git remote add azure <paste>

You only need to do these steps once. Now, whenever you want to push your application files to Azure, check them in with Git and run

  1. git push azure master

You’ll see a stream of log messages as the application is deployed to Azure.

When it’s complete, browse to http://yourappname.azurewebsites.net to check out the app!