.NET Language-Specific Guide

本指南將教您如何使用 Docker 創建容器化的 .NET 應用程序。通過本指南，您將學習如何：

• 容器化并運行 .NET 應用程序
• 設置本地環境以使用容器開發 .NET 應用程序
• 使用容器運行 .NET 應用程序測試
• 使用 GitHub Actions 配置容器化 .NET 應用程序的 CI/CD 流水線
• 在本地將容器化應用程序部署到 Kubernetes 以測試和調試您的部署

完成 .NET 入門模塊后，您應該能夠根據本指南提供的示例和說明容器化您自己的 .NET 應用程序。

步驟指南

1. 準備 .NET 應用程序

確保您的 .NET 應用程序目錄結構如下：

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

2. 創建 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 鏡像：

docker build -t my-dotnet-app .

4. 運行容器

使用以下命令運行容器：

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

現在，您可以通過瀏覽器訪問 http://localhost 來查看您的應用程序。

5. 使用 Docker Compose

創建 docker-compose.yml 文件

在項目根目錄下創建一個名為 docker-compose.yml 的文件，并添加以下內容：

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

運行 Docker Compose

在項目根目錄下運行以下命令啟動開發環境：

docker-compose up

6. 配置 CI/CD 流水線

使用 GitHub Actions 配置 CI/CD 流水線以自動化測試和部署過程。

創建 GitHub Actions 工作流文件

在項目根目錄下創建 .github/workflows/ci.yml 并添加以下內容：

name: CI/CD Pipelineon:push:branches:- mainpull_request:branches:- mainjobs:build:runs-on: ubuntu-lateststeps:- name: Checkout codeuses: actions/checkout@v2- name: Set up .NETuses: actions/setup-dotnet@v1with:dotnet-version: '5.0.x'- name: Build with .NETrun: dotnet build- name: Build Docker imagerun: docker build -t my-dotnet-app .- name: Push Docker imageenv:DOCKER_USERNAME: ${{ secrets.DOCKER_USERNAME }}DOCKER_PASSWORD: ${{ secrets.DOCKER_PASSWORD }}run: |echo $DOCKER_PASSWORD | docker login -u $DOCKER_USERNAME --password-stdindocker tag my-dotnet-app $DOCKER_USERNAME/my-dotnet-app:latestdocker push $DOCKER_USERNAME/my-dotnet-app:latest

確保在 GitHub 倉庫中添加 Docker Hub 憑據作為秘密（secrets）。

7. 部署到 Kubernetes

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

創建 Kubernetes 部署文件

在項目根目錄下創建 k8s/deployment.yml 并添加以下內容：

apiVersion: apps/v1
kind: Deployment
metadata:name: my-dotnet-app
spec:replicas: 3selector:matchLabels:app: my-dotnet-apptemplate:metadata:labels:app: my-dotnet-appspec:containers:- name: my-dotnet-appimage: <DOCKER_USERNAME>/my-dotnet-app:latestports:- containerPort: 80
---
apiVersion: v1
kind: Service
metadata:name: my-dotnet-app-service
spec:type: NodePortselector:app: my-dotnet-appports:- port: 80targetPort: 80nodePort: 30008

部署到 Kubernetes

使用 kubectl 命令將應用程序部署到 Kubernetes 集群：

kubectl apply -f k8s/deployment.yml

您可以通過訪問 http://<NODE_IP>:30008 查看應用程序。

通過上述步驟，您已經學會了如何容器化并運行一個 .NET 應用程序，設置本地開發環境，使用容器運行測試，配置 CI/CD 流水線，并將應用程序部署到 Kubernetes。