简介
本文档详细记录了如何在Docker Desktop的单节点Kubernetes集群上部署一个简单的Nginx静态页面，并通过域名访问的完整实现过程。
环境准备
前提条件
- 已安装Docker Desktop
- 已在Docker Desktop中启用Kubernetes功能
- 已配置好kubectl命令行工具
环境检查
- 检查Docker状态
docker info- 检查Kubernetes集群状态
kubectl cluster-info实现步骤
步骤1：创建静态HTML页面
创建一个简单的静态HTML页面，作为Nginx的默认首页。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Welcome to Nginx on Kubernetes</title>
<style>
body {
font-family: Arial, sans-serif;
background-color: #f0f0f0;
margin: 0;
padding: 0;
display: flex;
justify-content: center;
align-items: center;
height: 100vh;
}
.container {
background-color: white;
padding: 40px;
border-radius: 8px;
box-shadow: 0 2px 10px rgba(0,0,0,0.1);
text-align: center;
}
h1 {
color: #333;
}
p {
color: #666;
}
.info {
margin-top: 20px;
padding: 10px;
background-color: #f9f9f9;
border-radius: 4px;
}
</style>
</head>
<body>
<div class="container">
<h1>Welcome to Nginx on Kubernetes!</h1>
<p>This is a simple static page served by Nginx running on a single-node Kubernetes cluster.</p>
<div class="info">
<p><strong>Environment:</strong> Docker Desktop Kubernetes</p>
<p><strong>Date:</strong> 2026-02-19</p>
</div>
</div>
</body>
</html>将上述内容保存为 index.html 文件。
步骤2：编写Dockerfile构建Nginx镜像
创建一个Dockerfile，使用官方Nginx镜像作为基础，并将我们的静态页面复制到Nginx的默认静态文件目录。
FROM nginx:alpine
COPY index.html /usr/share/nginx/html/
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]将上述内容保存为 Dockerfile 文件。
步骤3：构建Docker镜像
使用Docker命令构建包含静态页面的Nginx镜像。
docker build -t nginx-static .验证镜像是否构建成功：
docker images | grep nginx-static步骤4：创建Kubernetes部署配置
创建一个Kubernetes Deployment配置文件，定义如何部署我们的Nginx应用。
apiVersion: apps/v1
kind: Deployment
metadata:
name: nginx-static-deployment
labels:
app: nginx-static
spec:
replicas: 1
selector:
matchLabels:
app: nginx-static
template:
metadata:
labels:
app: nginx-static
spec:
containers:
- name: nginx-static
image: nginx-static:latest
ports:
- containerPort: 80
imagePullPolicy: Never # 使用本地构建的镜像，不尝试从远程拉取将上述内容保存为 nginx-deployment.yaml 文件。
步骤5：创建Kubernetes服务配置
创建一个Kubernetes Service配置文件，使用NodePort类型来暴露服务。
apiVersion: v1
kind: Service
metadata:
name: nginx-static-service
labels:
app: nginx-static
spec:
selector:
app: nginx-static
ports:
- port: 80
targetPort: 80
protocol: TCP
name: http
type: NodePort将上述内容保存为 nginx-service.yaml 文件。
步骤6：应用Kubernetes配置并验证
- 应用Deployment配置：
kubectl apply -f nginx-deployment.yaml- 应用Service配置：
kubectl apply -f nginx-service.yaml- 验证Deployment状态：
kubectl get deployments nginx-static-deployment- 验证Pod状态：
kubectl get pods -l app=nginx-static- 验证Service状态，获取NodePort端口：
kubectl get service nginx-static-service步骤7：配置域名访问
- 编辑本地hosts文件，添加域名映射：
sudo bash -c 'echo "127.0.0.1 nginx-static.local" >> /etc/hosts'- 验证服务是否可以通过IP和端口访问：
curl http://localhost:32513 # 注意：32513是示例端口，实际端口以kubectl get service命令的输出为准- 验证服务是否可以通过域名访问：
curl http://nginx-static.local:32513 # 注意：32513是示例端口，实际端口以kubectl get service命令的输出为准总结
通过以上步骤，我们成功实现了：
- 在Docker Desktop的单节点Kubernetes集群上部署了一个Nginx静态页面
- 通过NodePort类型的Service暴露了服务
- 配置了域名访问（通过修改hosts文件）
后续步骤
如果需要进一步优化，可以考虑：
- 使用Ingress控制器替代NodePort，实现更灵活的路由和域名管理
- 添加配置管理，实现静态页面内容的动态更新
- 配置资源限制和健康检查，提高应用的稳定性
- 实现CI/CD流程，自动化部署过程
故障排查
如果遇到问题，可以尝试以下方法：
- 检查Pod状态和日志：
kubectl describe pod <pod-name>
kubectl logs <pod-name>- 检查Service状态：
kubectl describe service nginx-static-service- 检查Docker镜像是否存在：
docker images | grep nginx-static- 验证本地hosts文件配置：
cat /etc/hosts | grep nginx-static