.NET 语言特定指南

.NET Language-Specific Guide

本指南将教您如何使用 Docker 创建容器化的 .NET 应用程序。通过本指南，您将学习如何：

容器化并运行 .NET 应用程序
设置本地环境以使用容器开发 .NET 应用程序
使用容器运行 .NET 应用程序测试
使用 GitHub Actions 配置容器化 .NET 应用程序的 CI/CD 流水线
在本地将容器化应用程序部署到 Kubernetes 以测试和调试您的部署

完成 .NET 入门模块后，您应该能够根据本指南提供的示例和说明容器化您自己的 .NET 应用程序。

步骤指南

1. 准备 .NET 应用程序

确保您的 .NET 应用程序目录结构如下：

plaintext 复制代码

my-dotnet-app/
├── my-dotnet-app.csproj
├── Program.cs
└── Dockerfile

2. 创建 Dockerfile

在项目根目录下创建一个名为 Dockerfile 的文件，并添加以下内容：

dockerfile 复制代码

# 使用 SDK 镜像进行构建
FROM mcr.microsoft.com/dotnet/sdk:5.0 AS build
WORKDIR /app

# 复制项目文件并还原依赖项
COPY *.csproj ./
RUN dotnet restore

# 复制所有文件并构建应用程序
COPY . .
RUN dotnet publish -c Release -o out

# 使用运行时镜像
FROM mcr.microsoft.com/dotnet/aspnet:5.0
WORKDIR /app
COPY --from=build /app/out .

# 暴露端口并设置启动命令
EXPOSE 80
ENTRYPOINT ["dotnet", "my-dotnet-app.dll"]

3. 构建 Docker 镜像

在项目根目录下运行以下命令以构建 Docker 镜像：

sh 复制代码

docker build -t my-dotnet-app .

4. 运行容器

使用以下命令运行容器：

sh 复制代码

docker run -d -p 80:80 my-dotnet-app

现在，您可以通过浏览器访问 http://localhost 来查看您的应用程序。

5. 使用 Docker Compose

创建 docker-compose.yml 文件

在项目根目录下创建一个名为 docker-compose.yml 的文件，并添加以下内容：

yaml 复制代码

version: '3.8'
services:
  app:
    image: my-dotnet-app
    ports:
      - "80:80"
    volumes:
      - .:/app
    build:
      context: .
      dockerfile: Dockerfile

运行 Docker Compose

在项目根目录下运行以下命令启动开发环境：

sh 复制代码

docker-compose up

6. 配置 CI/CD 流水线

使用 GitHub Actions 配置 CI/CD 流水线以自动化测试和部署过程。

创建 GitHub Actions 工作流文件

在项目根目录下创建 .github/workflows/ci.yml 并添加以下内容：

yaml 复制代码

name: CI/CD Pipeline

on:
  push:
    branches:
      - main
  pull_request:
    branches:
      - main

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
    - name: Checkout code
      uses: actions/checkout@v2

    - name: Set up .NET
      uses: actions/setup-dotnet@v1
      with:
        dotnet-version: '5.0.x'

    - name: Build with .NET
      run: dotnet build

    - name: Build Docker image
      run: docker build -t my-dotnet-app .

    - name: Push Docker image
      env:
        DOCKER_USERNAME: ${{ secrets.DOCKER_USERNAME }}
        DOCKER_PASSWORD: ${{ secrets.DOCKER_PASSWORD }}
      run: |
        echo $DOCKER_PASSWORD | docker login -u $DOCKER_USERNAME --password-stdin
        docker tag my-dotnet-app $DOCKER_USERNAME/my-dotnet-app:latest
        docker push $DOCKER_USERNAME/my-dotnet-app:latest

确保在 GitHub 仓库中添加 Docker Hub 凭据作为秘密（secrets）。

7. 部署到 Kubernetes

使用 Kubernetes 部署和管理容器化的 .NET 应用程序。

创建 Kubernetes 部署文件

在项目根目录下创建 k8s/deployment.yml 并添加以下内容：

yaml 复制代码

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-dotnet-app
spec:
  replicas: 3
  selector:
    matchLabels:
      app: my-dotnet-app
  template:
    metadata:
      labels:
        app: my-dotnet-app
    spec:
      containers:
      - name: my-dotnet-app
        image: <DOCKER_USERNAME>/my-dotnet-app:latest
        ports:
        - containerPort: 80
---
apiVersion: v1
kind: Service
metadata:
  name: my-dotnet-app-service
spec:
  type: NodePort
  selector:
    app: my-dotnet-app
  ports:
    - port: 80
      targetPort: 80
      nodePort: 30008

部署到 Kubernetes

使用 kubectl 命令将应用程序部署到 Kubernetes 集群：

sh 复制代码

kubectl apply -f k8s/deployment.yml

您可以通过访问 http://<NODE_IP>:30008 查看应用程序。

通过上述步骤，您已经学会了如何容器化并运行一个 .NET 应用程序，设置本地开发环境，使用容器运行测试，配置 CI/CD 流水线，并将应用程序部署到 Kubernetes。