在当前云原生技术热点中，容器化与Kubernetes已成为后端开发的核心实践。本文聚焦于Dockerfile编写规范及Pod部署常见问题的排查方案，通过真实案例解析解决容器化应用在Kubernetes环境下的常见错误。
Dockerfile基础镜像选择与多阶段构建实践
选择合适的基础镜像直接影响应用性能与安全。根据CSDN技术社区2023年12月调研，使用alpine镜像可减少30%以上镜像体积，但需注意其依赖缺失问题。以下为多阶段构建示例：
FROM golang:1.17 as builder
WORKDIR /app
COPY go.mod ./
COPY go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o main .
FROM alpine:3.14
RUN apk add --no-cache ca-certificates
WORKDIR /root/
COPY --from=builder /app/main .
EXPOSE 8080
CMD ["./main"]关键点：通过–no-cache参数避免镜像内残留无用文件，COPY –from=builder确保仅传输编译后的可执行文件。
Kubernetes Pod部署失败状态码解析
Pod部署失败常见状态码及其解决方案如下表所示：
| 状态码 | 含义 | 排查步骤 |
|---|---|---|
| ImagePullBackOff | 镜像拉取失败 | 检查secret.yaml权限与镜像仓库认证 |
| CrashLoopBackOff | 容器连续崩溃 | 查看logs.k8s.io输出 |
| Pending | Pod调度阻塞 | 检查节点资源限制与污点标签 |
针对ImagePullBackOff问题，需确认：
apiVersion: v1
kind: Secret
metadata:
name: regcred
type: kubernetes.io/dockercfg
data:
.dockerconfigjson: eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...确保data字段为base64编码的Docker配置文件，且namespace与Pod一致。
容器健康检查配置示例
使用livenessProbe与readinessProbe区分应用启动与就绪状态：
spec:
containers:
- name: webapp
image: myapp:latest
ports:
- containerPort: 8080
livenessProbe:
httpGet:
path: /health/liveness
port: 8080
initialDelaySeconds: 30
periodSeconds: 10
readinessProbe:
httpGet:
path: /health/readiness
port: 8080
initialDelaySeconds: 5
periodSeconds: 5最佳实践：livenessProbe超时后Kubernetes会重启容器，而readinessProbe决定Pod是否计入服务可用数。
资源限制配置与节点亲和性解决实践
资源限制配置不当会导致Pod OOMKilled。以下为Pod资源限制配置示例：
resources:
requests:
memory: "256Mi"
cpu: "500m"
limits:
memory: "512Mi"
cpu: "1000m"节点亲和性配置可解决资源隔离问题。以下为避免大Pod抢占小节点的PodAntiAffinity配置：
spec:
affinity:
podAntiAffinity:
requiredDuringSchedulingIgnoredDuringExecution:
- labelSelector:
matchExpressions:
- key: app
operator: In
values:
- webapp
topologyKey: "kubernetes.io/hostname"根据Kubernetes官方文档，此配置确保同一应用Pod分散部署在不同物理机。
节点选择器实战案例
以下为选择特定zone的Pod配置：
spec:
affinity:
nodeSelector:
zone: zone-a
containers:
- name: db
image: postgres:latest
env:
- name: POSTGRES_DB
value: production注意：nodeSelector仅影响调度，不限制Pod迁移。若需强制绑定节点，需结合NodeAffinity使用。
日志收集与访问日志问题排查
容器日志收集需关注以下配置：
spec:
containers:
- name: app
image: myapp:latest
livenessProbe:
exec:
command:
- tail
- -n
- 100
- /app/logs/stdout.log
volumeMounts:
- name: logs
mountPath: /app/logs
volumes:
- name: logs
emptyDir: {}针对访问日志问题，需确认：
- 容器内日志文件路径是否正确
- livenessProbe命令是否有权限访问日志文件
- Pod日志卷挂载大小是否足够
根据Kubernetes社区最佳实践，建议使用sidecar模式部署日志收集代理，而非直接通过livenessProbe访问日志文件。
EFK日志收集架构配置
以下为Elasticsearch、Fluentd、Kibana日志收集架构的Kubernetes部署示例：
apiVersion: apps/v1
kind: Deployment
metadata:
name: fluentd
spec:
selector:
matchLabels:
app: fluentd
template:
metadata:
labels:
app: fluentd
spec:
containers:
- name: fluentd
image: fluent/fluentd:latest
volumeMounts:
- name: varlog
mountPath: /var/log
- name: kube-system
mountPath: /var/log/kube-system
- name: fluentd-log
mountPath: /fluentd/log
ports:
- containerPort: 24224
volumes:
- name: varlog
hostPath:
path: /var/log
- name: kube-system
hostPath:
path: /var/log/kube-system
- name: fluentd-log
persistentVolumeClaim:
claimName: fluentd-pvc注意：实际部署时需添加Elasticsearch服务与Kibana部署配置。
服务发现配置常见问题
服务发现配置不当会导致服务不可用。以下为常见问题及解决方案：
apiVersion: v1
kind: Service
metadata:
name: myservice
spec:
selector:
app: myapp
ports:
- protocol: TCP
port: 80
targetPort: 8080
type: ClusterIP关键点：selector标签必须与服务选择器匹配，targetPort需为容器内端口。
头信息传递配置
若需在服务间传递头信息，需配置：
spec:
selector:
app: myservice
ports:
- name: http
port: 80
targetPort: 8080
type: ClusterIP
metadata:
annotations:
service.beta.kubernetes.io/enable-hapee: "true"注意：需确保已安装Hapee Ingress Controller，此配置为Hapee 2.0+版本特性。
网络策略配置与端口暴露问题
网络策略配置不当会导致服务访问失败。以下为网络策略配置示例：
apiVersion: networking.k8s.io/v1
kind: NetworkPolicy
metadata:
name: app-network-policy
spec:
podSelector:
matchLabels:
app: myapp
policyTypes:
- Ingress
- Egress
ingress:
- from:
- podSelector:
matchLabels:
app: client
ports:
- protocol: TCP
port: 80针对端口暴露问题，需确认：
- 服务类型与端口配置是否正确
- 网络策略是否允许访问
- 防火墙规则是否允许流量
根据Kubernetes社区测试，80端口默认开放于所有节点，但需确认网络插件是否支持端口转发。
