SuperAPI AI Directory

container-orchestration

General & other

View repository

Updated 10-16 09:30

About this skill

Container Orchestration and Deployment

Applicable Scenarios

  • Docker image build optimization
  • Docker Compose local orchestration
  • Kubernetes deployment configuration
  • Helm Chart authoring
  • Image registry management
  • Container security hardening

Division of Labor with Other Skills

Scenario What to Use
Container build / K8s deployment This skill
CI/CD pipeline ci-cd-pipeline/
Release strategy (canary/blue-green) release-strategy/
Monitoring and alerting sre-operations workflow
Container security scanning security-engineer workflow

Core Command Quick Reference

Docker

# 构建镜像
docker build -t myapp:v1.0 .
docker build -t myapp:v1.0 --target runner .  # 多阶段指定目标

# 运行
docker run -d -p 3000:3000 --name myapp myapp:v1.0
docker run --rm -it myapp:v1.0 sh  # 进入容器调试

# 日志
docker logs -f myapp
docker logs --tail 100 myapp

# 清理
docker system prune -af  # 清理所有未使用镜像/容器/网络
docker image prune -af   # 只清镜像

# 镜像体积分析
docker history myapp:v1.0
docker images --format "table {{.Repository}}\t{{.Tag}}\t{{.Size}}"

Docker Compose

# 启动
docker compose up -d
docker compose up -d --build  # 强制重建

# 查看状态
docker compose ps
docker compose logs -f app

# 停止
docker compose down
docker compose down -v  # 含数据卷(危险!)

# 单服务重建
docker compose up -d --build app

Kubernetes (kubectl)

# 部署
kubectl apply -f deployment.yaml
kubectl apply -f .  # 应用目录下所有 YAML

# 状态查看
kubectl get pods
kubectl get pods -w  # 实时监控
kubectl describe pod <pod-name>
kubectl logs -f <pod-name>
kubectl logs -f <pod-name> --previous  # 上次崩溃日志

# 扩缩容
kubectl scale deployment myapp --replicas=5

# 回滚
kubectl rollout undo deployment/myapp
kubectl rollout history deployment/myapp

# 进入容器调试
kubectl exec -it <pod-name> -- sh

# 端口转发(本地调试)
kubectl port-forward svc/myapp 3000:80

# 查看资源使用
kubectl top pods
kubectl top nodes

Dockerfile Best Practice Decisions

语言        │ 基础镜像          │ 预期大小    │ 注意事项
────────────┼───────────────────┼─────────────┼─────────────────
Node.js     │ node:20-alpine    │ 80~150MB    │ 多阶段, pnpm
Java        │ eclipse-temurin   │ 200~350MB   │ JRE only, -alpine
Python      │ python:3.12-slim  │ 100~200MB   │ 多阶段, pip install
Go          │ scratch/distroless│ 5~20MB      │ CGO=0 静态编译
Rust        │ scratch/distroless│ 5~15MB      │ 静态编译

Supporting Templates

  • templates/container-orchestration-template.md

Common Pitfalls

1. 用 latest 标签 → 不可复现
2. 不用多阶段构建 → 镜像 1GB+
3. root 运行 → 安全风险
4. 不设 HEALTHCHECK → K8s 不知状态
5. 不限制资源 → OOM Kill
6. 不用 .dockerignore → 构建上下文巨大
7. 数据卷不持久化 → 容器重启数据丢
8. 不设 restart policy → 崩溃后不自愈
9. compose 里用 host network → 端口冲突
10. 不分环境 → dev 镜像直接上生产

Collaboration with Other Skills

上游:backend-engineer / frontend-engineer → 构建产物
下游:ci-cd-pipeline → 流水线集成
      release-strategy → 发布策略
      sre-operations → 运行时监控