# 使用 Homebrew, Nix, zypper 安装 kubectl-rook-ceph

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

## 安装

```sh
sudo av install brew:kubectl-rook-ceph
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install kubectl-rook-ceph
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#kubectl-rook-ceph
```

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

- zypper (92%):

```sh
sudo zypper install kubectl-rook-ceph
```

  证据: openSUSE Tumbleweed package metadata: kubectl-rook-ceph from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

## 软件包事实

- **软件包键:** brew:kubectl-rook-ceph
- **软件包管理器:** Homebrew
- **版本:** 0.9.6
- **来源摘要:** Rook plugin for Ceph management
- **主页:** <https://rook.io/>
- **仓库:** <https://github.com/rook/kubectl-rook-ceph>
- **最后更新:** 2026-07-27T21:58:44+02:00
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- kubectl-rook_ceph (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

kubectl-rook-ceph is the Rook project's kubectl plugin for common Rook Ceph management and troubleshooting tasks. It exposes Ceph commands, health checks, operator actions, maintenance flows, and cleanup commands through `kubectl rook-ceph`.

### 项目历史

The standalone plugin repository was created on 2021-09-16 under the Rook organization. Its README describes it as a Krew plugin for the Rook Ceph storage provider, while the Rook documentation frames it as a troubleshooting tool for Rook clusters.

The plugin evolved as an operational shell around Rook Ceph: it can run Ceph, RADOS, RBD, and RGW admin commands, print monitor endpoints, restart the operator, purge OSDs, run maintenance flows, and help with disaster-recovery and cleanup cases.

### 采用历史

Adoption follows Rook Ceph operators rather than the broader Kubernetes user base. The plugin is distributed through Krew, Homebrew, Nix, and zypper, making it convenient for administrators who already manage clusters from a workstation.

The repository metadata observed on 2026-07-01 showed roughly 100 GitHub stars, but its practical significance is larger than that number suggests because it is tied to a CNCF storage project and documented from the official Rook troubleshooting pages.

### 使用方式

Users run commands as `kubectl rook-ceph <root-args> <command> <command-args>`, usually against a namespace that contains a Rook Ceph cluster. The official docs emphasize checking Rook pod health, checking Ceph health, creating debug pods, restarting the operator, purging OSDs, and running arbitrary Ceph commands.

Because the plugin operates through kubectl contexts and namespaces, its credentials story is inherited from Kubernetes kubeconfig rather than from a separate Ceph credential file.

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

kubectl-rook-ceph is a good example of a package that packages operational tribal knowledge. Instead of asking admins to remember pod exec incantations and Ceph toolbox workflows, it turns Rook-specific routines into a versioned kubectl plugin.

### 时间线

- 2021-09-16: GitHub repository created.
- 2024-09-17: Release v0.9.2 published.
- 2024-12-18: Release v0.9.3 published.
- 2025-05-06: Release v0.9.4 published.
- 2026-03-31: Release v0.9.6 published.

### Related projects

- Related projects include Rook, Ceph, kubectl, Krew, RADOS, RBD, and RGW. The plugin is specifically about Rook-managed Ceph clusters, not generic Kubernetes storage.

### 来源

- <https://api.github.com/repos/rook/kubectl-rook-ceph>
- <https://formulae.brew.sh/formula/kubectl-rook-ceph>
- <https://github.com/rook/kubectl-rook-ceph>
- <https://github.com/rook/kubectl-rook-ceph#readme>
- <https://krew.sigs.k8s.io/docs/user-guide/setup/install/>
- <https://rook.io/docs/rook/latest/Troubleshooting/kubectl-plugin>


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.kube/config
## 其他软件包管理器记录

- Nix - kubectl-rook-ceph: normalized package name match | nixpkgs package indexes: pkgs/by-name/ku/kubectl-rook-ceph/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- zypper - kubectl-rook-ceph - 0.9.6-1.5: normalized package name match | openSUSE Tumbleweed package metadata: kubectl-rook-ceph from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Management and troubleshooting tools for the Rook Ceph storage provider | https://github.com/rook/kubectl-rook-ceph


## Combined YAML source

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


## 来源

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