buffalo应用需手动编写k8s deployment yaml，关键点包括：监听0.0.0.0:3000、设置containerport、用根路径/作健康探针、指定env=production、按需配置资源限制；gpu仅在应用内调用cuda时才需声明。
Buffalo 框架本身不生成或管理 Kubernetes Deployment 文件——它是一个 Go 语言 Web 应用框架，和 K8s 部署编排无关。你真正需要的，是为 Buffalo 应用「手动编写」符合其运行特征的 Deployment YAML，而不是让 Buffalo “生成”它。
为什么 Buffalo 应用的 Deployment 要特别注意端口和探针
Buffalo 默认使用 buffalo dev 启动开发服务器（绑定 localhost:3000），但生产部署必须改用 buffalo build 输出二进制，并监听 0.0.0.0:3000（或自定义端口）。否则 Pod 启动后无法被 Service 访问。
常见错误现象：CrashLoopBackOff 或 Readiness probe failed，往往是因为：
- 容器启动后没监听
0.0.0.0，只监听127.0.0.1 -
livenessProbe或readinessProbe的path指向了未实现的健康接口（如/healthz），而 Buffalo 默认不提供该 endpoint - 没显式设置
containerPort，导致 Service 无法正确转发流量
如何写一个最小可用的 buffalo-app Deployment
假设你已构建好镜像 my-buffalo-app:latest，且应用在 :3000 监听 HTTP 请求，以下是可直接使用的部署片段（不含 Service/Ingress）：
评估 Kubernetes 集群安全态势，覆盖 RBAC、工作负载安全、网络策略、基础设施即代码（IaC）、运行时监控和密钥管理等 30 项控制项……
apiVersion: apps/v1
kind: Deployment
metadata:
name: buffalo-app
namespace: default
spec:
replicas: 2
selector:
matchLabels:
app: buffalo-app
template:
metadata:
labels:
app: buffalo-app
spec:
containers:
- name: app
image: my-buffalo-app:latest
ports:
- containerPort: 3000
protocol: TCP
env:
- name: ENV
value: "production"
livenessProbe:
httpGet:
path: / # Buffalo 默认根路径可响应 200，适合做存活检查
port: 3000
initialDelaySeconds: 15
periodSeconds: 20
readinessProbe:
httpGet:
path: /
port: 3000
initialDelaySeconds: 5
periodSeconds: 10
resources:
limits:
memory: "256Mi"
cpu: "500m"
关键点说明：
-
ports.containerPort必须与应用实际监听端口一致，且不能省略 - 探针
path: /是安全选择——只要你的 Buffalo 应用根路由返回 200 就能通过；不要盲目照搬其他框架的/healthz -
ENV=production是必须的，否则 Buffalo 可能启用开发模式（如自动重载、调试面板），这在容器中不可靠且有安全风险 - 如果应用依赖数据库或外部服务，记得通过
envFrom或secretRef注入凭证，而非硬编码
GPU 资源声明对 Buffalo 应用通常无效
如果你看到别人在 Buffalo 部署里加了 resources.limits.nvidia.com/gpu: 1，那基本是混淆了场景——Buffalo 是 Web 框架，不自带模型推理能力。只有当你的 Buffalo 应用内部调用了 ONNX Runtime、PyTorch 等 GPU 加速库时，才需要显式申请 GPU。
此时要注意：
- Kubernetes 集群必须已安装
NVIDIA GPU Operator，且kubectl get nodes -o wide显示nvidia.com/gpu容量 - Docker 镜像必须基于
nvidia/cuda基础镜像构建，普通golang:alpine镜像无法使用 GPU - Go 代码中若调用 CUDA 库（如通过 cgo），需确保构建环境和运行环境 CUDA 版本兼容
真正容易被忽略的是：Buffalo 应用的 static 文件（CSS/JS）默认由 Go HTTP 服务托管，但若你启用了 CDN 或反向代理（如 Nginx Ingress），要确认 static 路径是否被正确透传或缓存，否则页面可能样式错乱——这不是 Deployment 的问题，但常在上线后第一分钟暴露。
