快速入门：创建 GitHub 工作流以发布应用

2025-10-14

在本快速入门中，你将了解如何创建 GitHub 工作流，以便从源代码发布 .NET 应用。自动将 .NET 应用从 GitHub 发布到目标称为持续部署（CD）。在本快速入门中，有许多可能的发布目的地，而您将发布到 Azure。

先决条件

一个 GitHub 帐户。
.NET 源代码存储库。
拥有有效订阅的 Azure 帐户。免费创建帐户。
ASP.NET Core Web 应用。
Azure 应用服务资源。

添加发布资料

若要将应用发布到 Azure，请打开应用程序的应用服务实例的 Azure 门户。在资源概述中，选择 获取发布配置文件，并将 .PublishSetting 文件保存到本地。

警告

发布配置文件包含敏感信息，例如访问 Azure 应用服务资源所需的凭据。此信息应始终受到非常仔细的处理。

在 GitHub 存储库中，导航到 “设置” 并从左侧导航菜单中选择“ 机密 ”。选择 “新建存储库机密”以添加新机密。

输入 AZURE_PUBLISH_PROFILE 为 “名称”，并将发布配置文件中的 XML 内容粘贴到 “值 ”文本区域中。选择“添加机密”。有关详细信息，请参阅加密机密。

创建工作流文件

在 GitHub 存储库中，将新的 YAML 文件添加到 .github/workflows 目录。选择一个有意义的文件名，以明确说明工作流的目的。有关详细信息，请参阅工作流文件。

重要

GitHub 要求将工作流组合文件放置在 .github/workflows 目录中。

工作流文件通常通过 jobs.<job_id>/steps[*] 定义一个或多个 GitHub Action 的组合。有关详细信息，请参阅 GitHub Actions 的工作流语法。

创建名为 publish-app.yml的新文件，将以下 YML 内容复制并粘贴到其中：

name: publish

on:
  push:
    branches: [ production ]

env:
  AZURE_WEBAPP_NAME: DotNetWeb
  AZURE_WEBAPP_PACKAGE_PATH: '.' # Set this to the path to your web app project, defaults to the repository root:
  DOTNET_VERSION: '6.0.401' # The .NET SDK version to use

jobs:
  publish:

    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v3
    - name: Setup .NET Core
      uses: actions/setup-dotnet@v3
      with:
        dotnet-version: ${{ env.DOTNET_VERSION }}

    - name: Install dependencies
      run: dotnet restore
      
    - name: Build
      run: |
        cd DotNet.WebApp
        dotnet build --configuration Release --no-restore
        dotnet publish -c Release -o ../dotnet-webapp -r linux-x64 --self-contained true /p:UseAppHost=true
    - name: Test
      run: |
        cd DotNet.WebApp.Tests
        dotnet test --no-restore --verbosity normal
      
    - uses: azure/webapps-deploy@v2
      name: Deploy
      with:
        app-name: ${{ env.AZURE_WEBAPP_NAME }}
        publish-profile: ${{ secrets.AZURE_PUBLISH_PROFILE }}
        package: '${{ env.AZURE_WEBAPP_PACKAGE_PATH }}/dotnet-webapp'

在前面的工作流组合中：

定义name: publish为名称，则“发布”将显示在工作流状态徽章中。
```
name: publish
```
节点 on 表示触发工作流的事件：
```
on:
  push:
    branches: [ production ]
```
- 在production分支上push发生时触发。
节点 env 定义命名环境变量（env var）。
```
env:
  AZURE_WEBAPP_NAME: DotNetWeb
  AZURE_WEBAPP_PACKAGE_PATH: '.' # Set this to the path to your web app project, defaults to the repository root:
  DOTNET_VERSION: '6.0.401' # The .NET SDK version to use
```
- 为环境变量 AZURE_WEBAPP_NAME 赋值 DotNetWeb。
- 为环境变量 AZURE_WEBAPP_PACKAGE_PATH 赋值 '.'。
- 为环境变量 DOTNET_VERSION 赋值 '6.0.401'。稍后将引用环境变量以指定 dotnet-versionactions/setup-dotnet@v3 GitHub Action。

节点 jobs 将生成工作流要执行的步骤。

jobs:
  publish:

    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v3
    - name: Setup .NET Core
      uses: actions/setup-dotnet@v3
      with:
        dotnet-version: ${{ env.DOTNET_VERSION }}

    - name: Install dependencies
      run: dotnet restore
      
    - name: Build
      run: |
        cd DotNet.WebApp
        dotnet build --configuration Release --no-restore
        dotnet publish -c Release -o ../dotnet-webapp -r linux-x64 --self-contained true /p:UseAppHost=true
    - name: Test
      run: |
        cd DotNet.WebApp.Tests
        dotnet test --no-restore --verbosity normal
      
    - uses: azure/webapps-deploy@v2
      name: Deploy
      with:
        app-name: ${{ env.AZURE_WEBAPP_NAME }}
        publish-profile: ${{ secrets.AZURE_PUBLISH_PROFILE }}
        package: '${{ env.AZURE_WEBAPP_PACKAGE_PATH }}/dotnet-webapp'

有一个名为 publish 的作业将在最新版本的 Ubuntu 上运行。
actions/setup-dotnet@v3 GitHub Action 用于根据环境变量中指定的版本来设置 .NET SDK。
调用 dotnet restore 命令。
调用 dotnet build 命令。
调用 dotnet publish 命令。
调用 dotnet test 命令。
azure/webapps-deploy@v2 GitHub Action 使用给定的publish-profile和package来部署该应用程序。
- publish-profile 是从AZURE_PUBLISH_PROFILE 仓库密钥中分配的。

创建工作流状态徽章

在 GitHub 存储库中，在存储库目录的根目录通常会有一个名为 README.md 的文件。同样，最好报告各种工作流的最新状态。所有工作流都可以生成状态徽章，该徽章在 README.md 文件中具有视觉吸引力。若要添加工作流状态徽章，请执行以下操作：

从 GitHub 存储库中选择操作导航选项。
所有存储库工作流都显示在左侧，选择所需的工作流和省略号（...）按钮。
- 省略号（...）按钮将展开所选工作流的菜单选项。
选择创建状态徽章菜单选项。
选择 “复制状态徽章 Markdown ”按钮。
将 Markdown 粘贴到 README.md 文件中，保存文件，提交并推送更改。

有关详细信息，请参阅添加工作流状态徽章。

发布工作流状态徽章示例

通过（如考试或测试成功通过）	失败	无状态