一、背景与目标

在云计算与微服务架构盛行的今天，容器化技术已成为开发者部署应用的首选方案。Docker作为容器技术的代表，通过镜像打包应用及其依赖，实现了环境一致性与快速部署。对于.Net6 API项目而言，利用Docker自动构建镜像并推送至镜像仓库，不仅能够提升部署效率，还能确保开发、测试与生产环境的一致性。本文将详细阐述如何实现这一流程，帮助开发者掌握自动化构建与推送的核心技能。

二、环境准备

1. 安装Docker

首先，需在开发或构建服务器上安装Docker。Docker支持多种操作系统，包括Windows、macOS与Linux。以Ubuntu为例，安装步骤如下：

# 更新软件包索引
sudo apt-get update
# 安装依赖
sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common
# 添加Docker官方GPG密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
# 添加Docker APT仓库
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
# 更新软件包索引并安装Docker
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io
# 验证安装
sudo docker run hello-world

2. 配置.Net6 SDK

确保开发或构建服务器上安装了.Net6 SDK，以便编译.Net6 API项目。可通过Microsoft官方文档获取安装指南。

3. 注册镜像仓库账号

选择一家镜像仓库服务提供商，如Docker Hub、阿里云容器镜像服务或私有仓库，并注册账号。本文以Docker Hub为例，注册后需在本地配置Docker以使用该仓库。

# 登录Docker Hub
docker login
# 输入用户名与密码

三、编写Dockerfile

Dockerfile是定义镜像构建步骤的文本文件。对于.Net6 API项目，一个基本的Dockerfile可能如下：

# 使用.Net6运行时作为基础镜像
FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
EXPOSE 80
# 使用.Net6 SDK构建应用
FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["MyApi.csproj", "."]
RUN dotnet restore "./MyApi.csproj"
COPY . .
RUN dotnet build "MyApi.csproj" -c Release -o /app/build
# 发布应用
FROM build AS publish
RUN dotnet publish "MyApi.csproj" -c Release -o /app/publish
# 最终镜像
FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "MyApi.dll"]

此Dockerfile分为四个阶段：基础镜像准备、应用构建、应用发布与最终镜像生成。通过多阶段构建，可以减小最终镜像的大小。

四、自动化构建与推送

1. 使用Docker CLI手动构建与推送

在项目根目录下执行以下命令，手动构建并推送镜像：

# 构建镜像
docker build -t myapi:latest .
# 标记镜像以推送至Docker Hub
docker tag myapi:latest username/myapi:latest
# 推送镜像
docker push username/myapi:latest

其中，username需替换为Docker Hub用户名。

2. 集成CI/CD工具实现自动化

为进一步简化流程，可将Docker构建与推送集成至CI/CD工具中，如GitHub Actions、GitLab CI或Jenkins。以GitHub Actions为例，创建一个.github/workflows/dotnet-docker.yml文件，内容如下：

name: .NET Core Docker Build & Push
on:
  push:
    branches: [ main ]
jobs:
  build-and-push:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v2
    - name: Setup .NET Core
      uses: actions/setup-dotnet@v1
      with:
        dotnet-version: '6.0.x'
    - name: Build Docker Image
      run: docker build -t myapi:latest .
    - name: Log in to Docker Hub
      uses: docker/login-action@v1
      with:
        username: ${{ secrets.DOCKER_HUB_USERNAME }}
        password: ${{ secrets.DOCKER_HUB_ACCESS_TOKEN }}
    - name: Tag and Push Docker Image
      run: |
        docker tag myapi:latest ${{ secrets.DOCKER_HUB_USERNAME }}/myapi:latest
        docker push ${{ secrets.DOCKER_HUB_USERNAME }}/myapi:latest

此工作流在代码推送至main分支时触发，自动完成.Net6项目的构建、Docker镜像的构建、标记与推送。需在GitHub仓库的设置中配置DOCKER_HUB_USERNAME与DOCKER_HUB_ACCESS_TOKEN秘密。

五、优化与最佳实践

1. 使用.dockerignore文件

在项目根目录下创建.dockerignore文件，排除不必要的文件，如本地开发环境配置、日志文件等，以减小构建上下文大小，加快构建速度。

bin/
obj/
.vscode/
.git/
*.log
*.tmp

2. 镜像版本管理

为镜像打上明确的版本标签，而非仅使用latest，以便于回滚与追踪。版本号可与Git提交哈希或项目版本号关联。

3. 安全扫描

在推送镜像前，使用Docker内置的docker scan命令或第三方工具（如Trivy）对镜像进行安全扫描，确保无已知漏洞。

docker scan myapi:latest

4. 私有仓库配置

对于企业级应用，考虑使用私有镜像仓库，如Harbor或Nexus，以增强安全性与可控性。配置私有仓库时，需在Docker的daemon.json中添加信任的CA证书与仓库地址。

六、总结

通过Docker自动构建镜像并推送至镜像仓库，可以显著提升.Net6 API项目的部署效率与环境一致性。本文详细介绍了从环境准备、Dockerfile编写、手动与自动化构建推送，到优化与最佳实践的全过程。开发者可根据实际需求，灵活调整与优化流程，以实现更高效、更安全的容器化部署。

从.Net6 API项目到Docker镜像仓库：自动化构建与推送全攻略