3. 创建第一个 Operator 项目：项目初始化与结构解析

本章将带领你从零开始创建一个标准的 Operator 项目，深入理解 operator-sdk init 命令生成的项目骨架、核心目录结构以及构建配置文件（Makefile 与 Dockerfile）的作用。这是后续实现资源配额分配策略的基础工程环境。

3.1 使用 operator-sdk init 初始化项目

在开始之前，请确保已安装 operator-sdk CLI 工具（推荐 v1.30+）并配置好 Go 1.21+ 环境。执行以下命令创建项目：

# 创建项目目录并进入
mkdir quota-operator && cd quota-operator

# 初始化项目，使用 Go 语言，指定 API 组和版本
operator-sdk init \
  --domain=example.com \
  --repo=github.com/example/quota-operator \
  --language=go \
  --owner="Your Name" \
  --project-name=quota-operator

初始化成功后，终端会输出类似以下信息：

Writing kustomize manifests for you to edit...
Writing scaffold for you to edit...
Get controller runtime:
  go get sigs.k8s.io/controller-runtime@v0.17.0
Update dependencies:
  go mod tidy
Next: define a resource with:
  operator-sdk create api

3.2 项目结构深度解析

初始化完成后，项目根目录下会生成一套完整的脚手架文件。下表列出了核心目录和文件的作用：

下图展示了项目初始化后的核心文件依赖关系与数据流向：

3.3 Makefile 详解

生成的 Makefile 是 Operator 项目的自动化构建核心。它封装了以下关键操作：

• 构建（build）：编译 Go 二进制文件，输出到 bin/manager。
• 镜像构建与推送（docker-build / docker-push）：调用 Docker 构建镜像并推送到指定仓库。
• 部署（deploy）：使用 Kustomize 生成并应用 Kubernetes 资源清单。
• 测试（test）：运行单元测试和集成测试。
• 代码生成（generate）：触发 controller-gen 生成 CRD 清单和 RBAC 规则。

核心变量说明：

3.4 Dockerfile 详解

生成的 Dockerfile 采用多阶段构建策略，分为两个阶段：

1. 构建阶段（builder）：基于 golang:1.21 镜像，编译 Go 代码，生成静态链接的二进制文件。
2. 运行阶段：基于 gcr.io/distroless/static:nonroot 最小镜像，仅包含二进制文件和必要的 CA 证书，确保安全性和最小攻击面。

关键代码片段：

# 构建阶段
FROM golang:1.21 AS builder
WORKDIR /workspace
COPY go.mod go.mod
COPY go.sum go.sum
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -a -o manager main.go

# 运行阶段
FROM gcr.io/distroless/static:nonroot
WORKDIR /
COPY --from=builder /workspace/manager .
USER 65532:65532
ENTRYPOINT ["/manager"]

下图展示了 Dockerfile 的多阶段构建流程：

3.5 初始化后的下一步操作

项目初始化完成后，建议按以下顺序进行验证：

1. 检查依赖：运行 go mod tidy 确保所有依赖正确下载。
2. 编译测试：运行 make build 确认二进制文件生成成功。
3. 本地运行：使用 make install && make run 在本地启动 Operator（需连接 Kubernetes 集群）。
4. 查看生成清单：检查 config/crd 和 config/rbac 目录下的 YAML 文件是否完整。