Share feedback
Answers are generated based on the documentation.

为 .NET 应用程序配置 CI/CD

Table of contents

先决条件

完成本指南中从容器化 .NET 应用程序开始的所有先前部分。你必须拥有一个 GitHub 账户和一个已验证的 Docker 账户才能完成本部分。

概述

在本部分中，你将学习如何设置和使用 GitHub Actions 来构建和测试 Docker 镜像，并将其推送到 Docker Hub。你将完成以下步骤：

  1. 在 GitHub 上创建一个新仓库。
  2. 定义 GitHub Actions 工作流。
  3. 运行工作流。

第一步：创建仓库

创建 GitHub 仓库，配置 Docker Hub 凭据，并推送源代码。

  1. 在 GitHub 上创建一个新仓库。

  2. 打开仓库的 Settings，然后转到 Secrets and variables > Actions。

  3. 创建一个名为 DOCKER_USERNAME 的新 Repository variable，并将你的 Docker ID 作为其值。

  4. 为 Docker Hub 创建一个新 个人访问令牌 (PAT)。你可以将此令牌命名为 docker-tutorial。确保访问权限包括读取和写入权限。

  5. 将 PAT 作为 Repository secret 添加到你的 GitHub 仓库中，名称为 DOCKERHUB_TOKEN。

  6. 在本地机器上的本地仓库中，运行以下命令以将 origin 更改为你刚创建的仓库。确保将 your-username 更改为你的 GitHub 用户名，将 your-repository 更改为你创建的仓库名称。

    $ git remote set-url origin https://github.com/your-username/your-repository.git

  7. 在本地机器上的本地仓库中，运行以下命令以将分支重命名为 main。

    $ git branch -M main

  8. 运行以下命令以暂存、提交，然后将本地仓库推送到 GitHub。

    $ git add -A
$ git commit -m "my first commit"
$ git push -u origin main

第二步：设置工作流

设置 GitHub Actions 工作流以构建、测试并将镜像推送到 Docker Hub。

  1. 转到 GitHub 上的仓库，然后选择 Actions 选项卡。

  2. 选择 set up a workflow yourself。

    这会将你带到一个页面，用于在仓库中创建新的 GitHub Actions 工作流文件，默认位于 .github/workflows/main.yml。

  3. 在编辑器窗口中，复制并粘贴以下 YAML 配置。

    name: ci

on:
  push:
    branches:
      - main

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Login to Docker Hub
        uses: docker/login-action@v3
        with:
          username: ${{ vars.DOCKER_USERNAME }}
          password: ${{ secrets.DOCKERHUB_TOKEN }}

      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v3

      - name: Build and test
        uses: docker/build-push-action@v6
        with:
          target: build
          load: true

      - name: Build and push
        uses: docker/build-push-action@v6
        with:
          platforms: linux/amd64,linux/arm64
          push: true
          target: final
          tags: ${{ vars.DOCKER_USERNAME }}/${{ github.event.repository.name }}:latest

    有关 docker/build-push-action 的 YAML 语法的更多信息，请参阅 GitHub Action README。

第三步：运行工作流

保存工作流文件并运行作业。

  1. 选择 Commit changes... 并将更改推送到 main 分支。

    推送提交后，工作流会自动启动。

  2. 转到 Actions 选项卡。它会显示工作流。

    选择工作流会显示所有步骤的细分。

  3. 工作流完成后，转到 Docker Hub 上的仓库。

    如果你在该列表中看到新仓库，则表示 GitHub Actions 已成功将镜像推送到 Docker Hub。

总结

在本部分中，你学习了如何为应用程序设置 GitHub Actions 工作流。

相关信息：

后续步骤

接下来，了解如何在部署之前在 Kubernetes 上本地测试和调试工作负载。

测试 .NET 部署 »