# 使用 Homebrew, Nix 安装 kubebuilder

查看 kubebuilder 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:kubebuilder
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install kubebuilder
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#kubebuilder
```

  证据: nixpkgs package indexes: pkgs/by-name/ku/kubebuilder/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## 软件包事实

- **软件包键:** brew:kubebuilder
- **软件包管理器:** Homebrew
- **版本:** 4.15.0
- **来源摘要:** SDK for building Kubernetes APIs using CRDs
- **主页:** <https://github.com/kubernetes-sigs/kubebuilder>
- **仓库:** <https://github.com/kubernetes-sigs/kubebuilder>
- **最后更新:** 2026-07-27T21:58:43+02:00
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- kubebuilder (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 4.15.0
## 项目历史与用法

Kubebuilder is the Kubernetes SIG API Machinery framework and CLI for building Kubernetes APIs and controllers with Custom Resource Definitions. It scaffolds Go projects, controllers, webhooks, manifests, tests, and deployment configuration around the controller-runtime and controller-tools libraries.

### 项目历史

The kubernetes-sigs/kubebuilder repository was created on 2018-03-14, and the first GitHub release listed by the releases API, v1.9-alpha.30, was published on 2018-03-15. From the start, Kubebuilder sat inside the Kubernetes SIGs ecosystem rather than as a third-party wrapper.

The Kubebuilder Book frames the project as a way to reduce the boilerplate involved in building Kubernetes APIs with CRDs. The README compares its role to application frameworks such as Ruby on Rails or Spring Boot: it encodes the canonical Kubernetes API-building approach into generators, libraries, plugins, and conventions.

Over time the project formalized plugin and project versioning. The documentation distinguishes Kubebuilder release versions, PROJECT file schema versions, and plugin versions, which reflects how a scaffolding tool has to evolve while preserving already-generated operator projects.

### 采用历史

Kubebuilder became a foundational tool in the Kubernetes operator ecosystem because it is developed with controller-runtime and controller-tools. The README explicitly names Operator SDK as an example of a project that uses Kubebuilder as a library and plugin system, which made Kubebuilder's conventions visible beyond users who install the kubebuilder binary directly.

The project is distributed through GitHub releases and Homebrew, but its larger adoption story is in generated code: many operator repositories carry Kubebuilder-style PROJECT files, Makefiles, RBAC manifests, controller tests, and controller-runtime patterns.

### 使用方式

Users typically run kubebuilder init to create a project and kubebuilder create api to add APIs and controllers. The generated project is then edited as normal Go code while Kubebuilder-owned markers and generators keep CRDs, RBAC, and webhook manifests synchronized.

Kubebuilder is not just a one-shot template generator. Its plugin versioning, migrations, and library hooks support long-lived projects that may need to adopt newer Kubernetes APIs or scaffolding layouts without abandoning existing code.

### 为什么软件包爱好者会关心

For package nerds, Kubebuilder is one of the important Kubernetes CLIs because installing a single binary gives access to a large, opinionated development workflow. It is the kind of tool where package version, generated layout version, and dependency versions all matter.

It also marks the point where Kubernetes extension development moved from hand-rolled controller boilerplate toward reproducible project scaffolding. That makes the package culturally important even when the final runtime artifact is a controller image rather than the kubebuilder binary itself.

### 时间线

- 2018-03-14: GitHub repository created under kubernetes-sigs.
- 2018-03-15: GitHub release v1.9-alpha.30 published.
- 2018-03-20: GitHub release v1alpha1.0 published for Kubernetes 1.9-era scaffolding.
- 2026-06-15: GitHub release v4.15.0 published.

### Related projects

- controller-runtime is the runtime library foundation for Kubebuilder-generated controllers.
- controller-tools supplies code and manifest generation pieces used in the Kubebuilder workflow.
- Operator SDK uses Kubebuilder as a library and extends the workflow for additional operator styles.
- Custom Resource Definitions are the Kubernetes API-extension mechanism Kubebuilder targets.

### 来源

- <https://api.github.com/repos/kubernetes-sigs/kubebuilder>
- <https://api.github.com/repos/kubernetes-sigs/kubebuilder/releases>
- <https://book.kubebuilder.io/>
- <https://formulae.brew.sh/formula/kubebuilder>
- <https://github.com/kubernetes-sigs/controller-runtime>
- <https://github.com/kubernetes-sigs/controller-tools>
- <https://github.com/kubernetes-sigs/kubebuilder>
- <https://github.com/kubernetes-sigs/kubebuilder/blob/master/docs/book/src/plugins/plugins-versioning.md>
- <https://github.com/operator-framework/operator-sdk>


## 安全说明

infrastructure mutation or orchestration signal.

- **Geiger 风险:** orange / 中
- infrastructure mutation or orchestration signal

## 其他软件包管理器记录

- Nix - kubebuilder: normalized package name match | nixpkgs package indexes: pkgs/by-name/ku/kubebuilder/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/kubebuilder.yml](https://github.com/mxcl/pkgdb/blob/main/combined/kubebuilder.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
