bash

macOS

brew install skaffold

Linux / Windows 可参考官方文档，或下载二进制

进入一个包含 Dockerfile 和 Kubernetes 清单的示例项目，运行初始化命令：
```bash
skaffold init

Skaffold 会检测项目结构，并引导你生成 skaffold.yaml。通常自动生成的结果已经可以直接使用。

skaffold.yaml 配置解析

一个典型的开发配置如下：

apiVersion: skaffold/v4beta7
kind: Config
metadata:
  name: my-app
build:
  artifacts:
    - image: my-app
      docker:
        dockerfile: Dockerfile
deploy:
  kubectl:
    manifests:
      - k8s/*.yaml

• apiVersion / kind：声明 Skaffold 配置的版本和类型。
• build.artifacts：定义要构建的镜像，以及构建方式（此处为 Docker）。
• deploy：声明部署方式，这里使用 kubectl 直接应用 k8s/ 目录下的所有 YAML 文件。

常用模式：本地开发 vs 远程集群

本地模式通过配置 build.local.push: false（默认）即可实现，Skaffold 会将镜像直接加载到集群中，省略推送步骤，反馈极快。

Skaffold 开发循环实战

1. 启动持续开发模式

skaffold dev

此命令：

• 执行一次完整的构建-部署；
• 进入文件监听状态；
• 当源码变动时，自动重新构建并重新部署变更的部分；
• 通过端口转发将应用的端口暴露到本地；
• 聚合部署的应用日志。

输出示例：

Listing files to watch...
 - my-app
Generating tags...
 - my-app -> my-app:latest
Checking cache...
 - my-app: Not found. Building
Building [my-app]...
...
Deploying...
 - deployment.apps/my-app created
Waiting for deployments to stabilize...
 - deployment/my-app is ready.
[my-app] Hello Kubernetes!
Port forwarding service/my-app in namespace default, remote port 8080 -> http://localhost:8080

当修改代码并保存后，Skaffold 会立刻检测并重复构建与部署流程。

2. 一次性构建并部署（CI/CD 风格）

如果你只想执行一次完整的流水线并退出，使用：

skaffold run

这常用于预发布验证或编写脚本。

3. 仅构建镜像（不部署）

调试镜像构建时，可以单独运行：

skaffold build

构建的镜像可以推送到仓库（若配置了远程模式）。

4. 仅部署已有镜像

当你已提前构建好镜像（例如从 CI 产物），可使用：

skaffold deploy --images=my-app:1.0.0

Skaffold 会跳过构建阶段，直接使用指定的镜像标签进行部署。

5. 删除已部署资源

skaffold delete

清理所有由 Skaffold 部署的资源。

优化开发循环的技巧

使用同步（File Sync）代替重建

对于静态文件（如 HTML、配置）、解释型语言的源码，你无需重构建整个镜像。Skaffold 支持将文件直接同步到运行中的容器中：

build:
  artifacts:
    - image: my-app
      docker:
        dockerfile: Dockerfile
      sync:
        manual:
          - src: "src/**/*.html"
            dest: "/app"

这样修改 src/ 下的 HTML 文件时，Skaffold 只是将文件拷贝到容器内，而无需重构建镜像，反馈时间以毫秒计。

依赖缓存（Docker layer caching）

在 dev 模式下，Skaffold 会智能利用 Docker 层缓存，并有额外的文件监视器，避免不必要的完整重建。

多服务模块化

对于包含多个微服务的项目，Skaffold 可以定义多个 artifact：

build:
  artifacts:
    - image: service-a
      context: services/a
    - image: service-b
      context: services/b

Skaffold 会并行构建，并仅重新部署变更的服务，大幅提升多服务本地开发体验。

自定义部署策略

除了 kubectl，你还可以无缝集成 Helm 和 Kustomize：

deploy:
  helm:
    releases:
      - name: my-app
        chartPath: charts/my-app