macOS
Homebrew已验证 · 100%
brew install clusterctllocal Homebrew formula metadata
安装
其他安装命令
Linux
Nix已验证 · 92%
nix profile install nixpkgs#clusterctlnixpkgs package indexes · pkgs/by-name/cl/clusterctl/package.nix · 来源: api.github.com
openSUSE zypper已验证 · 92%
sudo zypper install clusterctlopenSUSE Tumbleweed package metadata · clusterctl · 来源: download.opensuse.org
Windows
Windows Package Manager已验证 · 92%
winget install --id Kubernetes.clusterctl -eWindows Package Manager source index · Kubernetes.clusterctl · 来源: cdn.winget.microsoft.com
概览
软件包摘要
Home for the Cluster Management API work, a subproject of sig-cluster-lifecycle
历史
项目历史与用法
clusterctl is the command-line tool for bootstrapping and managing Kubernetes Cluster API providers and management clusters.
项目历史
The Cluster API project was started by Kubernetes SIG Cluster Lifecycle to provide declarative APIs and tooling for provisioning, upgrading, and operating multiple Kubernetes clusters.
clusterctl became the user-facing CLI for that project. The official docs say it handles the lifecycle of a Cluster API management cluster, provides a simple day-1 experience, fetches provider component YAML, installs providers, and encodes best practices for provider management and upgrades.
采用历史
clusterctl adoption follows Cluster API adoption across infrastructure providers. The docs describe default provider repositories sponsored by SIG Cluster Lifecycle and a provider contract that lets infrastructure, bootstrap, and control-plane providers publish release assets for clusterctl.
The input package facts show distribution through Homebrew, Nix, winget, and zypper, which matches its role as a cross-platform Kubernetes operations CLI.
使用方式
Common commands include `clusterctl init` for management-cluster initialization, `clusterctl generate cluster` for workload-cluster templates, `clusterctl move` for moving Cluster API objects between management clusters, and `clusterctl upgrade plan/apply` for provider upgrades.
clusterctl uses `$XDG_CONFIG_HOME/cluster-api/clusterctl.yaml` for provider repository configuration, variable substitution values, image overrides, and options such as log level or version-check behavior.
为什么软件包爱好者会关心
clusterctl matters to package maintainers because it is the small local binary that wires a large Kubernetes provider ecosystem together: it discovers releases, fetches YAML assets, talks to GitHub or Go proxies, and applies provider contracts across platforms.
It is also a classic modern infrastructure CLI: a single executable distributed by OS package managers while its real work coordinates remote releases, Kubernetes manifests, and cluster lifecycle state.
时间线
- 2019: Cluster API GitHub releases include early v0.1.x and v0.3.x releases.
- 2021: Cluster API v1.0.0 was published.
- 2024: Cluster API v1.7 and v1.8 release candidates were published.
- 2026: The Cluster API book documents v1.13 and current clusterctl behavior.
Related projects
- Cluster API is the parent project for clusterctl.
- kubeadm is discussed in the official Cluster API introduction as prior SIG Cluster Lifecycle tooling that reduced Kubernetes bootstrap complexity.
- Cluster API providers such as Cluster API Provider AWS implement the provider contracts that clusterctl consumes.
来源
安全态势
风险级别：orange
infrastructure mutation or orchestration signal.
风险分类器
orange 风险 · 中 置信度 · infrastructure
原因
- infrastructure mutation or orchestration signal
信号
- text:cluster
安装行为
- formula 元数据中未记录 Homebrew post-install 钩子。
- Homebrew bottle 元数据适用于 6 个平台目标。
- 构建元数据列出 1 个构建依赖。
建议审查
在无人值守的代理使用前，请检查该工具是否读取明文凭据、写入远程状态、发布制品或调用插件。
local files
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
Config paths the tool may read or write during local use.
- Unix
$XDG_CONFIG_HOME/cluster-api/clusterctl.yaml
可执行文件
已安装的可执行文件
| 命令 | 类型 | 暴露范围 | 备注 |
|---|---|---|---|
clusterctl | cli | 全局可执行文件 |
新鲜度
版本和新鲜度
这些信号区分页生成时间、软件包管理器活动和上游发布比较。只有存在证据 URL 和可比较版本时，才会提示版本落后。
页面生成时间2026-07-25
管理器版本1.13.4
管理器更新时间2026-07-15
本地数据OK
上游当前
检测到的最新版本v1.13.4
https://github.com/kubernetes-sigs/cluster-api
- OK没有生成新鲜度警告。
安装元数据
软件包元数据
| 软件包键 | brew:clusterctl |
|---|---|
| 版本 | 1.13.4 |
| 软件包管理器 | Homebrew |
| 软件包管理器页面 | https://formulae.brew.sh/formula/clusterctl |
| 主页 | https://cluster-api.sigs.k8s.io |
| 仓库 | https://github.com/kubernetes-sigs/cluster-api |
| 上游文档 | https://cluster-api.sigs.k8s.io/clusterctl/configuration |
| 许可证 | Apache-2.0 |
| 源码归档 | https://github.com/kubernetes-sigs/cluster-api/archive/refs/tags/v1.13.4.tar.gz |
| 最后更新 | 2026-07-15T20:59:17Z |
| Pulse | updated |
| 构建依赖 | go |
| Bottle | 可用 (于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux) |
| Homebrew post-install | 未定义 |
| 服务 | 未声明 |
注册表事实
源数据库详情
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | clusterctl |
| Version Scheme | 0 |
| Revision | 0 |
| Head Version | HEAD |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
源数据库匹配
其他软件包管理器记录
匹配项来自外部软件包管理器索引，并与本地 Automic Vault 软件包链接分开显示。
Nix95%
clusterctl
nix profile install nixpkgs#clusterctl- normalized package name match
- 匹配方式：Clusterctl
zypper95%
clusterctl 1.13.1-1.1
CLI tool to handle the lifecycle of a Cluster API management cluster
https://github.com/kubernetes-sigs/cluster-api
sudo zypper install clusterctl- License: Apache-2.0
- Category: Unspecified
- Architecture: x86_64
- Source Package: clusterctl
- 1 依赖
- 1 提供
- normalized package name match
- 匹配方式：Clusterctl
zypper95%
clusterctl-bash-completion 1.13.1-1.1
Bash Completion for clusterctl
https://github.com/kubernetes-sigs/cluster-api
sudo zypper install clusterctl-bash-completion- License: Apache-2.0
- Category: System/Shells
- Architecture: noarch
- Source Package: clusterctl
- 2 依赖
- 1 提供
- normalized package name match
- 匹配方式：Clusterctl
zypper95%
clusterctl-fish-completion 1.13.1-1.1
Fish Completion for clusterctl
https://github.com/kubernetes-sigs/cluster-api
sudo zypper install clusterctl-fish-completion- License: Apache-2.0
- Category: System/Shells
- Architecture: noarch
- Source Package: clusterctl
- 1 依赖
- 1 提供
- normalized package name match
- 匹配方式：Clusterctl
zypper95%
clusterctl-zsh-completion 1.13.1-1.1
Zsh Completion for clusterctl
https://github.com/kubernetes-sigs/cluster-api
sudo zypper install clusterctl-zsh-completion- License: Apache-2.0
- Category: System/Shells
- Architecture: noarch
- Source Package: clusterctl
- 1 依赖
- 1 提供
- normalized package name match
- 匹配方式：Clusterctl
winget95%
Kubernetes.clusterctl
winget install --id Kubernetes.clusterctl -e- normalized package name match
- 匹配方式：Clusterctl
来源线索
由仓库数据生成
此页面由 av-web 从 scripts/generate-pkg-sqlite.py 生成的私有软件包 SQLite 工件提供。
Combined YAML source
View the package source record on GitHub.
使用的来源
- Geiger risk classifier
- Nucleus package database
- av.db category and tag curation
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- external package-manager database matches
- package relationship graph
- package version freshness
- package-page enrichment